unique_sdk 0.10.36__tar.gz → 0.10.47__tar.gz

{unique_sdk-0.10.36 → unique_sdk-0.10.47}/CHANGELOG.md

@@ -5,6 +5,39 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), 
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.10.47] - 2025-11-19
+- Add expired/s at fields on content search result.
+
+## [0.10.46] - 2025-11-18
+- chat_against_file function allows now a should_delete_chat flag.
+
+## [0.10.45] - 2025-11-18
+- Create group and manage users functions.
+
+## [0.10.44] - 2025-11-18
+- add function to get all messages in a chat.
+
+## [0.10.43] - 2025-11-14
+- Add get, delete and update groups functions.
+
+## [0.10.42] - 2025-11-14
+- Add get_users function.
+
+## [0.10.41] - 2025-11-13
+- Add create_message and get_latest_message.
+
+## [0.10.40] - 2025-11-10
+- Don't send description if not defined.
+
+## [0.10.39] - 2025-11-07
+- Add function to get llm models
+
+## [0.10.38] - 2025-11-06
+- Add description property to Reference and Content.
+
+## [0.10.37] - 2025-11-04
+- Introduce local integration tests for Content API Resource
+
 ## [0.10.36] - 2025-11-04
 - Introduce local integration tests for Folder API Resource
 

{unique_sdk-0.10.36 → unique_sdk-0.10.47}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_sdk
-Version: 0.10.36
+Version: 0.10.47
 Summary: 
 License: MIT
 Author: Martin Fadler
@@ -42,6 +42,9 @@ The Unique Python SDK provides access to the public API of Unique AI. It also en
    - [Message Assessment](#message-assessment)
    - [Folder](#folder)
    - [Space](#space)
+   - [LLM Models](#llm-models)
+   - [User](#user)
+   - [Group](#group)
    - [Agentic Table](#agentic-table)
 6. [UniqueQL](#uniqueql)
    - [Query Structure](#uniqueql-query-structure)
@@ -260,6 +263,9 @@ unique_sdk.Message.modify(
 - [Message Assessment](#message-assessment)
 - [Folder](#folder)
 - [Space](#space)
+- [LLM Models](#llm-models)
+- [User](#user)
+- [Group](#group)
 - [Agentic Table](#agentic-table)
 
 Most of the API services provide an asynchronous version of the method. The async methods are suffixed with `_async`.
@@ -477,6 +483,7 @@ def upload_file(
     path_to_file,
     displayed_filename,
     mimeType,
+    description=None,
     scope_or_unique_path,
     ingestion_config=None,
     metadata=None,
@@ -489,6 +496,7 @@ def upload_file(
             "key": displayed_filename,
             "title": displayed_filename,
             "mimeType": mimeType,
+            "description": description,
             "ingestionConfig": ingestionConfig,
             "metadata": metadata,
         },
@@ -515,6 +523,7 @@ def upload_file(
             "key": displayed_filename,
             "title": displayed_filename,
             "mimeType": mimeType,
+            "description": description,
             "byteSize": size,
             "ingestionConfig": ingestionConfig,
             "metadata": metadata,
@@ -1359,6 +1368,56 @@ unique_sdk.Folder.delete(
 
 ### Space
 
+#### `unique_sdk.Space.create_message`
+
+Send a message in a space. You can optionally provide a chat ID to continue an existing conversation, or omit it to start a new chat.
+
+```python
+message = unique_sdk.Space.create_message(
+    user_id=user_id,
+    company_id=company_id,
+    chatId="chat_dejfhe729br398",  # Optional - if not provided, a new chat will be created
+    assistantId="assistant_abc123",
+    text="Hello, how can you help me?",
+    toolChoices=["WebSearch"],  # Optional - list of tools to use
+    scopeRules={  # Optional - scope rules for filtering
+        "or": [
+            {
+                "operator": "contains",
+                "path": ["folderIdPath"],
+                "value": "uniquepathid://scope_123"
+            }
+        ]
+    },
+)
+```
+
+#### `unique_sdk.Space.get_chat_messages` (Compatible with release >.48)
+
+Get all messages in a space chat. Returns a list of paginated messages in the specified chat.
+
+```python
+messages = unique_sdk.Space.get_chat_messages(
+    user_id=user_id,
+    company_id=company_id,
+    chat_id="chat_dejfhe729br398",
+    skip=0,  # Optional (defaults to 0) - number of messages to skip for pagination
+    take=50,  # Optional (defaults to 10) - number of messages to return
+)
+```
+
+#### `unique_sdk.Space.get_latest_message`
+
+Get the latest message in a space chat.
+
+```python
+message = unique_sdk.Space.get_latest_message(
+    user_id=user_id,
+    company_id=company_id,
+    chat_id="chat_dejfhe729br398",
+)
+```
+
 #### `unique_sdk.Space.delete_chat`
 
 Delete a space chat by id. If the chat does not exist, the function will return an error.
@@ -1371,6 +1430,118 @@ unique_sdk.Space.delete_chat(
 )
 ```
 
+### LLM Models
+
+#### `unique_sdk.LLMModels.get` (Compatible with release >.46)
+
+Get available LLM models. You can optionally filter by module and skip cache to fetch fresh data.
+
+```python
+models = unique_sdk.LLMModels.get(
+    user_id=user_id,
+    company_id=company_id,
+    module="UNIQUE_AI",  # Optional - filter models by module, only UNIQUE_AI is supported right now
+)
+```
+
+### User
+
+#### `unique_sdk.User.get_users` (Compatible with release >.48)
+
+Get users in a company. You can filter by email, display name, and use pagination with skip and take parameters.
+
+```python
+users = unique_sdk.User.get_users(
+    user_id=user_id,
+    company_id=company_id,
+    skip=0,  # Optional - number of records to skip for pagination
+    take=50,  # Optional - number of records to return (max 1000)
+    email="user@example.com",  # Optional - filter by email
+    displayName="John",  # Optional - filter by display name
+)
+```
+
+### Group
+
+#### `unique_sdk.Group.create_group` (Compatible with release >.48)
+
+Create a new group in a company. You can specify the group name (required), external ID and parent group ID.
+
+```python
+group = unique_sdk.Group.create_group(
+    user_id=user_id,
+    company_id=company_id,
+    name="New Group",  # Required - the name of the group
+    externalId="ext_123",  # Optional - external ID for the group
+    parentId="group_a9cs7wr2z1bg2sxczvltgjch",  # Optional - parent group ID
+)
+```
+
+#### `unique_sdk.Group.get_groups` (Compatible with release >.48)
+
+Get groups in a company. You can filter by name and use pagination with skip and take parameters.
+
+```python
+groups = unique_sdk.Group.get_groups(
+    user_id=user_id,
+    company_id=company_id,
+    skip=0,  # Optional - number of records to skip for pagination
+    take=50,  # Optional - number of records to return (max 1000)
+    name="Admin",  # Optional - filter by group name
+)
+```
+
+#### `unique_sdk.Group.update_group` (Compatible with release >.48)
+
+Update a group in a company. You can update the group's name.
+
+```python
+updated_group = unique_sdk.Group.update_group(
+    user_id=user_id,
+    company_id=company_id,
+    group_id="group_a9cs7wr2z1bg2sxczvltgjch",
+    name="New Group Name",  # Optional - update the group name
+)
+```
+
+#### `unique_sdk.Group.add_users_to_group` (Compatible with release >.48)
+
+Add users to a group. Provide an array of user IDs to add as members to the specified group.
+
+```python
+result = unique_sdk.Group.add_users_to_group(
+    user_id=user_id,
+    company_id=company_id,
+    group_id="group_a9cs7wr2z1bg2sxczvltgjch",
+    userIds=["299420877169688584", "325402458132058201", "299426678160031752"],  # Required - array of user IDs to add
+)
+```
+
+#### `unique_sdk.Group.remove_users_from_group` (Compatible with release >.48)
+
+Remove users from a group. Provide an array of user IDs to remove from the specified group.
+
+```python
+result = unique_sdk.Group.remove_users_from_group(
+    user_id=user_id,
+    company_id=company_id,
+    group_id="group_a9cs7wr2z1bg2sxczvltgjch",
+    userIds=["299426678160031752", "299426678160031752"],  # Required - array of user IDs to remove
+)
+```
+
+#### `unique_sdk.Group.delete_group` (Compatible with release >.48)
+
+Delete a group in a company by its group ID.
+
+```python
+result = unique_sdk.Group.delete_group(
+    user_id=user_id,
+    company_id=company_id,
+    group_id="group_a9cs7wr2z1bg2sxczvltgjch",
+)
+```
+
 ### Agentic Table
 
 The Agentic Table (Magic Table) API provides functionality for managing interactive tables with AI-powered cells, activity tracking, and metadata management.
@@ -1915,11 +2086,12 @@ You must provide the following parameters:
 - `mime_type`: The mime type of the ifle to be uploaded.
 - `text`: The text to be sent to the chat for chatting against the file.
 
-The script creates a chat and uploads the file to it. It then keeps polling the `ingestionState` field of the message, waiting for it to reach `FINISHED`, signaling the upload is complete. Once the file uploads successfully, the script sends the text, continues polling for completion, and finally retrieves the response message.
+The script creates a chat and uploads the file to it. It then keeps polling the `ingestionState` field of the message, waiting for it to reach `FINISHED`, signaling the upload is complete. Once the file uploads successfully, the script sends the text, continues polling for completion, and finally retrieves the response message. The function deletes the chat at the end unless the `should_delete_chat` is set to false.
 
 **Optional parameters:**
 - `poll_interval`: The number of seconds to wait between polling attempts (default: `1` second).
 - `max_wait`: The maximum number of seconds to wait for the message to complete (default: `60` seconds).
+- `should_delete_chat`: Setting this flag determines whether the chat should be deleted at the end or not. Default is True.
 
 Example of chatting against a PDF. (The usage can be extended to any supported file type)
 
@@ -1929,8 +2101,8 @@ latest_message = await unique_sdk.utils.chat_in_space.chat_against_file(
     company_id=company_id,
     assistant_id="assistant_hjcdga64bkcjnhu4",
     path_to_file="/files/hello.pdf",
-    displayed_filename="hello.pdf"
-    mime_type="application/pdf"
+    displayed_filename="hello.pdf",
+    mime_type="application/pdf",
     text="Give me a bullet point summary of the file.",
 )
 ```
@@ -1976,6 +2148,39 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), 
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.10.47] - 2025-11-19
+- Add expired/s at fields on content search result.
+
+## [0.10.46] - 2025-11-18
+- chat_against_file function allows now a should_delete_chat flag.
+
+## [0.10.45] - 2025-11-18
+- Create group and manage users functions.
+
+## [0.10.44] - 2025-11-18
+- add function to get all messages in a chat.
+
+## [0.10.43] - 2025-11-14
+- Add get, delete and update groups functions.
+
+## [0.10.42] - 2025-11-14
+- Add get_users function.
+
+## [0.10.41] - 2025-11-13
+- Add create_message and get_latest_message.
+
+## [0.10.40] - 2025-11-10
+- Don't send description if not defined.
+
+## [0.10.39] - 2025-11-07
+- Add function to get llm models
+
+## [0.10.38] - 2025-11-06
+- Add description property to Reference and Content.
+
+## [0.10.37] - 2025-11-04
+- Introduce local integration tests for Content API Resource
+
 ## [0.10.36] - 2025-11-04
 - Introduce local integration tests for Folder API Resource
 

{unique_sdk-0.10.36 → unique_sdk-0.10.47}/README.md

@@ -24,6 +24,9 @@ The Unique Python SDK provides access to the public API of Unique AI. It also en
    - [Message Assessment](#message-assessment)
    - [Folder](#folder)
    - [Space](#space)
+   - [LLM Models](#llm-models)
+   - [User](#user)
+   - [Group](#group)
    - [Agentic Table](#agentic-table)
 6. [UniqueQL](#uniqueql)
    - [Query Structure](#uniqueql-query-structure)
@@ -242,6 +245,9 @@ unique_sdk.Message.modify(
 - [Message Assessment](#message-assessment)
 - [Folder](#folder)
 - [Space](#space)
+- [LLM Models](#llm-models)
+- [User](#user)
+- [Group](#group)
 - [Agentic Table](#agentic-table)
 
 Most of the API services provide an asynchronous version of the method. The async methods are suffixed with `_async`.
@@ -459,6 +465,7 @@ def upload_file(
     path_to_file,
     displayed_filename,
     mimeType,
+    description=None,
     scope_or_unique_path,
     ingestion_config=None,
     metadata=None,
@@ -471,6 +478,7 @@ def upload_file(
             "key": displayed_filename,
             "title": displayed_filename,
             "mimeType": mimeType,
+            "description": description,
             "ingestionConfig": ingestionConfig,
             "metadata": metadata,
         },
@@ -497,6 +505,7 @@ def upload_file(
             "key": displayed_filename,
             "title": displayed_filename,
             "mimeType": mimeType,
+            "description": description,
             "byteSize": size,
             "ingestionConfig": ingestionConfig,
             "metadata": metadata,
@@ -1341,6 +1350,56 @@ unique_sdk.Folder.delete(
 
 ### Space
 
+#### `unique_sdk.Space.create_message`
+
+Send a message in a space. You can optionally provide a chat ID to continue an existing conversation, or omit it to start a new chat.
+
+```python
+message = unique_sdk.Space.create_message(
+    user_id=user_id,
+    company_id=company_id,
+    chatId="chat_dejfhe729br398",  # Optional - if not provided, a new chat will be created
+    assistantId="assistant_abc123",
+    text="Hello, how can you help me?",
+    toolChoices=["WebSearch"],  # Optional - list of tools to use
+    scopeRules={  # Optional - scope rules for filtering
+        "or": [
+            {
+                "operator": "contains",
+                "path": ["folderIdPath"],
+                "value": "uniquepathid://scope_123"
+            }
+        ]
+    },
+)
+```
+
+#### `unique_sdk.Space.get_chat_messages` (Compatible with release >.48)
+
+Get all messages in a space chat. Returns a list of paginated messages in the specified chat.
+
+```python
+messages = unique_sdk.Space.get_chat_messages(
+    user_id=user_id,
+    company_id=company_id,
+    chat_id="chat_dejfhe729br398",
+    skip=0,  # Optional (defaults to 0) - number of messages to skip for pagination
+    take=50,  # Optional (defaults to 10) - number of messages to return
+)
+```
+
+#### `unique_sdk.Space.get_latest_message`
+
+Get the latest message in a space chat.
+
+```python
+message = unique_sdk.Space.get_latest_message(
+    user_id=user_id,
+    company_id=company_id,
+    chat_id="chat_dejfhe729br398",
+)
+```
+
 #### `unique_sdk.Space.delete_chat`
 
 Delete a space chat by id. If the chat does not exist, the function will return an error.
@@ -1353,6 +1412,118 @@ unique_sdk.Space.delete_chat(
 )
 ```
 
+### LLM Models
+
+#### `unique_sdk.LLMModels.get` (Compatible with release >.46)
+
+Get available LLM models. You can optionally filter by module and skip cache to fetch fresh data.
+
+```python
+models = unique_sdk.LLMModels.get(
+    user_id=user_id,
+    company_id=company_id,
+    module="UNIQUE_AI",  # Optional - filter models by module, only UNIQUE_AI is supported right now
+)
+```
+
+### User
+
+#### `unique_sdk.User.get_users` (Compatible with release >.48)
+
+Get users in a company. You can filter by email, display name, and use pagination with skip and take parameters.
+
+```python
+users = unique_sdk.User.get_users(
+    user_id=user_id,
+    company_id=company_id,
+    skip=0,  # Optional - number of records to skip for pagination
+    take=50,  # Optional - number of records to return (max 1000)
+    email="user@example.com",  # Optional - filter by email
+    displayName="John",  # Optional - filter by display name
+)
+```
+
+### Group
+
+#### `unique_sdk.Group.create_group` (Compatible with release >.48)
+
+Create a new group in a company. You can specify the group name (required), external ID and parent group ID.
+
+```python
+group = unique_sdk.Group.create_group(
+    user_id=user_id,
+    company_id=company_id,
+    name="New Group",  # Required - the name of the group
+    externalId="ext_123",  # Optional - external ID for the group
+    parentId="group_a9cs7wr2z1bg2sxczvltgjch",  # Optional - parent group ID
+)
+```
+
+#### `unique_sdk.Group.get_groups` (Compatible with release >.48)
+
+Get groups in a company. You can filter by name and use pagination with skip and take parameters.
+
+```python
+groups = unique_sdk.Group.get_groups(
+    user_id=user_id,
+    company_id=company_id,
+    skip=0,  # Optional - number of records to skip for pagination
+    take=50,  # Optional - number of records to return (max 1000)
+    name="Admin",  # Optional - filter by group name
+)
+```
+
+#### `unique_sdk.Group.update_group` (Compatible with release >.48)
+
+Update a group in a company. You can update the group's name.
+
+```python
+updated_group = unique_sdk.Group.update_group(
+    user_id=user_id,
+    company_id=company_id,
+    group_id="group_a9cs7wr2z1bg2sxczvltgjch",
+    name="New Group Name",  # Optional - update the group name
+)
+```
+
+#### `unique_sdk.Group.add_users_to_group` (Compatible with release >.48)
+
+Add users to a group. Provide an array of user IDs to add as members to the specified group.
+
+```python
+result = unique_sdk.Group.add_users_to_group(
+    user_id=user_id,
+    company_id=company_id,
+    group_id="group_a9cs7wr2z1bg2sxczvltgjch",
+    userIds=["299420877169688584", "325402458132058201", "299426678160031752"],  # Required - array of user IDs to add
+)
+```
+
+#### `unique_sdk.Group.remove_users_from_group` (Compatible with release >.48)
+
+Remove users from a group. Provide an array of user IDs to remove from the specified group.
+
+```python
+result = unique_sdk.Group.remove_users_from_group(
+    user_id=user_id,
+    company_id=company_id,
+    group_id="group_a9cs7wr2z1bg2sxczvltgjch",
+    userIds=["299426678160031752", "299426678160031752"],  # Required - array of user IDs to remove
+)
+```
+
+#### `unique_sdk.Group.delete_group` (Compatible with release >.48)
+
+Delete a group in a company by its group ID.
+
+```python
+result = unique_sdk.Group.delete_group(
+    user_id=user_id,
+    company_id=company_id,
+    group_id="group_a9cs7wr2z1bg2sxczvltgjch",
+)
+```
+
 ### Agentic Table
 
 The Agentic Table (Magic Table) API provides functionality for managing interactive tables with AI-powered cells, activity tracking, and metadata management.
@@ -1897,11 +2068,12 @@ You must provide the following parameters:
 - `mime_type`: The mime type of the ifle to be uploaded.
 - `text`: The text to be sent to the chat for chatting against the file.
 
-The script creates a chat and uploads the file to it. It then keeps polling the `ingestionState` field of the message, waiting for it to reach `FINISHED`, signaling the upload is complete. Once the file uploads successfully, the script sends the text, continues polling for completion, and finally retrieves the response message.
+The script creates a chat and uploads the file to it. It then keeps polling the `ingestionState` field of the message, waiting for it to reach `FINISHED`, signaling the upload is complete. Once the file uploads successfully, the script sends the text, continues polling for completion, and finally retrieves the response message. The function deletes the chat at the end unless the `should_delete_chat` is set to false.
 
 **Optional parameters:**
 - `poll_interval`: The number of seconds to wait between polling attempts (default: `1` second).
 - `max_wait`: The maximum number of seconds to wait for the message to complete (default: `60` seconds).
+- `should_delete_chat`: Setting this flag determines whether the chat should be deleted at the end or not. Default is True.
 
 Example of chatting against a PDF. (The usage can be extended to any supported file type)
 
@@ -1911,8 +2083,8 @@ latest_message = await unique_sdk.utils.chat_in_space.chat_against_file(
     company_id=company_id,
     assistant_id="assistant_hjcdga64bkcjnhu4",
     path_to_file="/files/hello.pdf",
-    displayed_filename="hello.pdf"
-    mime_type="application/pdf"
+    displayed_filename="hello.pdf",
+    mime_type="application/pdf",
     text="Give me a bullet point summary of the file.",
 )
 ```

{unique_sdk-0.10.36 → unique_sdk-0.10.47}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "unique_sdk"
-version = "0.10.36"
+version = "0.10.47"
 description = ""
 authors = [
     "Martin Fadler <martin.fadler@unique.ch>",
@@ -29,6 +29,7 @@ pytest-cov = "^4.1.0"
 pytest-asyncio = "^0.24.0"
 python-dotenv = "^1.1.0"
 httpx = "^0.28.1"
+ipykernel = "^7.1.0"
 
 [tool.poetry.extras]
 openai = ["openai"]

{unique_sdk-0.10.36 → unique_sdk-0.10.47}/unique_sdk/__init__.py

@@ -83,6 +83,9 @@ from unique_sdk.api_resources._short_term_memory import (
 from unique_sdk.api_resources._folder import Folder as Folder
 from unique_sdk.api_resources._embedding import Embeddings as Embeddings
 from unique_sdk.api_resources._acronyms import Acronyms as Acronyms
+from unique_sdk.api_resources._llm_models import LLMModels as LLMModels
+from unique_sdk.api_resources._user import User as User
+from unique_sdk.api_resources._group import Group as Group
 from unique_sdk.api_resources._message_assessment import (
     MessageAssessment as MessageAssessment,
 )

{unique_sdk-0.10.36 → unique_sdk-0.10.47}/unique_sdk/api_resources/_content.py

@@ -20,6 +20,17 @@ from unique_sdk._request_options import RequestOptions
 class Content(APIResource["Content"]):
     OBJECT_NAME: ClassVar[Literal["content.search"]] = "content.search"
 
+    id: str
+    key: str
+    url: Optional[str]
+    title: Optional[str]
+    updatedAt: str
+    chunks: Optional[List["Content.Chunk"]]
+    metadata: Optional[Dict[str, Any]]
+    writeUrl: Optional[str]
+    readUrl: Optional[str]
+    expiredAt: Optional[str]
+
     class QueryMode(Enum):
         Default = "default"
         Insensitive = "insensitive"
@@ -127,6 +138,7 @@ class Content(APIResource["Content"]):
         key: str
         title: Optional[str]
         mimeType: str
+        description: NotRequired[str | None]
         ownerType: NotRequired[str | None]
         ownerId: NotRequired[str | None]
         byteSize: NotRequired[int | None]
@@ -168,6 +180,7 @@ class Content(APIResource["Content"]):
         title: str | None
         metadata: Dict[str, Any] | None
         mimeType: str
+        description: str | None
         byteSize: int
         ownerId: str
         createdAt: str
@@ -192,16 +205,6 @@ class Content(APIResource["Content"]):
     class DeleteResponse(TypedDict):
         id: str
 
-    id: str
-    key: str
-    url: Optional[str]
-    title: Optional[str]
-    updatedAt: str
-    chunks: List[Chunk]
-    metadata: Optional[Dict[str, Any]]
-    writeUrl: str
-    readUrl: str
-
     class MagicTableSheetTableColumn(TypedDict):
         columnId: str
         columnName: str
@@ -349,6 +352,9 @@ class Content(APIResource["Content"]):
         """
         if "input" in params:
             params["input"]["metadata"] = params["input"].get("metadata") or {}
+            if "description" in params["input"] and not params["input"]["description"]:
+                params["input"].pop("description")
+
         return cast(
             "Content",
             cls._static_request(
@@ -372,6 +378,9 @@ class Content(APIResource["Content"]):
         """
         if "input" in params:
             params["input"]["metadata"] = params["input"].get("metadata") or {}
+            if "description" in params["input"] and not params["input"]["description"]:
+                params["input"].pop("description")
+
         return cast(
             "Content",
             await cls._static_request_async(