unique_sdk 0.10.17__tar.gz → 0.10.19__tar.gz

{unique_sdk-0.10.17 → unique_sdk-0.10.19}/CHANGELOG.md

@@ -5,6 +5,14 @@ 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.19] - 2025-09-02
+- Improve `send_message_and_wait_for_completion`:
+    - Add option to select stop_condition `["stoppedStreamingAt", "completedAt"]`. 
+    - Load `debugInfo` from `last_user_message` for better developer experience.
+
+## [0.10.18] - 2025-09-02
+- Temporarily remove support for update and delete files by filePath.
+
 ## [0.10.17] - 2025-09-01
 - Add function to update a file
 

{unique_sdk-0.10.17 → unique_sdk-0.10.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_sdk
-Version: 0.10.17
+Version: 0.10.19
 Summary: 
 License: MIT
 Author: Martin Fadler
@@ -556,32 +556,19 @@ Allows you to ingest a magic table sheet, each row is processed and converted in
 
 #### `unique_sdk.Content.update` (Compatible with release >.36)
 
-Allows you to update a file specified by its `contentId` or by its `filePath`.
+Allows you to update a file specified by its `contentId`.
 
-- `contentId` optional if `filePath` is provided, the id of the file to be updated
-- `filePath` optional if `contentId` is provided, the absolute path of the file to be updated
+- `contentId` the id of the file to be updated
 
 Currently, the following updates are supported:
 
 Title update:
 - `title` optional, allows updating the title of the folder
 
-Move the file to a different folder. this can be done by specifying either the `ownerId` or the `parentFolderPath`.
+Move the file to a different folder. this can be done by specifying either the `ownerId`.
 - `ownerId` optional, allows moving the file to a different folder. Represents the new folder for the file and it should be the id of a folder e.g.: `scope_dhjfieurfloakmdle`. 
-- `parentFolderPath` optional, allows moving the file to a different folder. Represents the path new folder for the file. 
 
 
-Example of updating the title of a file specified by its path.
-
-```python
-unique_sdk.Content.update(
-    user_id=user_id,
-    company_id=company_id,
-    filePath="/Company/finance/january.xls",
-    title="Revision Deck"
-)
-```
-
 Example of moving a file specified by its content id.
 
 ```python
@@ -605,25 +592,12 @@ unique_sdk.Content.update(
 )
 ```
 
-Example of moving a file to a folder specified by its path.
-
-```python
-unique_sdk.Content.update(
-    user_id=user_id,
-    company_id=company_id,
-    contentId="cont_ok2343q5owbce80w78hudawu5",
-    ownerId="scope_e68yz5asho7glfh7c7d041el",
-    parentFolderPath="/Company/Revisions"
-)
-```
-
 #### `unique_sdk.Content.delete` (Compatible with release >.36)
 
-Allows you to delete a file by its `contentId` or by its `filePath`. When deleting by `id`, if the file is part of a chat, the `chatId` also needs do be set. If both `contentId` and `filePath` are provided, `filePath` is ignored.
+Allows you to delete a file by its `contentId`. If the file is part of a chat, the `chatId` also needs do be set.
 
-- `contentId` optional if `filePath` is provided, the id of the file to be deleted
+- `contentId` the id of the file to be deleted
 - `chatId` optional, the id of the chat where the file is. Only needed if the file is part of a chat
-- `filePath` optional if `contentId` is provided, the absolute path of the file to be deleted
 
 Example of deleting a file from a chat.
 
@@ -636,16 +610,6 @@ unique_sdk.Content.delete(
 )
 ```
 
-Example of deleting a file by its path.
-
-```python
-unique_sdk.Content.delete(
-    user_id=user_id,
-    company_id=company_id,
-    filePath="/Company/finance/january.xls",
-)
-```
-
 ### Message
 
 #### `unique_sdk.Message.list`
@@ -1502,11 +1466,13 @@ The script sends a prompt asynchronously and continuously polls for completion,
 - `chat_id`: The ID of the chat where the message should be sent. If omitted, a new chat will be created.
 - `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).
+- `stop_condition`: Defines when to expect a response back, when the assistant stop streaming or when it completes the message. (default: "stoppedStreamingAt")
 
 The script ensures you can flexibly interact with spaces in new or ongoing chats, with fine-grained control over tools, context, and polling behavior.
 
 ```python
-latest_message = await unique_sdk.utils.chat_in_space.send_message_and_wait_for_completion(
+from unique_sdk.utils.chat_in_space import send_message_and_wait_for_completion
+latest_message = await send_message_and_wait_for_completion(
     user_id=user_id,
     company_id=company_id,
     assistant_id=assistant_id,
@@ -1533,6 +1499,7 @@ latest_message = await unique_sdk.utils.chat_in_space.send_message_and_wait_for_
             }
         ]
     },
+    stop_condition = "completedAt" # If not specified, stoppedStreamingAt will be set by default
 )
 ```
 
@@ -1608,6 +1575,14 @@ 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.19] - 2025-09-02
+- Improve `send_message_and_wait_for_completion`:
+    - Add option to select stop_condition `["stoppedStreamingAt", "completedAt"]`. 
+    - Load `debugInfo` from `last_user_message` for better developer experience.
+
+## [0.10.18] - 2025-09-02
+- Temporarily remove support for update and delete files by filePath.
+
 ## [0.10.17] - 2025-09-01
 - Add function to update a file
 

{unique_sdk-0.10.17 → unique_sdk-0.10.19}/README.md

@@ -540,32 +540,19 @@ Allows you to ingest a magic table sheet, each row is processed and converted in
 
 #### `unique_sdk.Content.update` (Compatible with release >.36)
 
-Allows you to update a file specified by its `contentId` or by its `filePath`.
+Allows you to update a file specified by its `contentId`.
 
-- `contentId` optional if `filePath` is provided, the id of the file to be updated
-- `filePath` optional if `contentId` is provided, the absolute path of the file to be updated
+- `contentId` the id of the file to be updated
 
 Currently, the following updates are supported:
 
 Title update:
 - `title` optional, allows updating the title of the folder
 
-Move the file to a different folder. this can be done by specifying either the `ownerId` or the `parentFolderPath`.
+Move the file to a different folder. this can be done by specifying either the `ownerId`.
 - `ownerId` optional, allows moving the file to a different folder. Represents the new folder for the file and it should be the id of a folder e.g.: `scope_dhjfieurfloakmdle`. 
-- `parentFolderPath` optional, allows moving the file to a different folder. Represents the path new folder for the file. 
 
 
-Example of updating the title of a file specified by its path.
-
-```python
-unique_sdk.Content.update(
-    user_id=user_id,
-    company_id=company_id,
-    filePath="/Company/finance/january.xls",
-    title="Revision Deck"
-)
-```
-
 Example of moving a file specified by its content id.
 
 ```python
@@ -589,25 +576,12 @@ unique_sdk.Content.update(
 )
 ```
 
-Example of moving a file to a folder specified by its path.
-
-```python
-unique_sdk.Content.update(
-    user_id=user_id,
-    company_id=company_id,
-    contentId="cont_ok2343q5owbce80w78hudawu5",
-    ownerId="scope_e68yz5asho7glfh7c7d041el",
-    parentFolderPath="/Company/Revisions"
-)
-```
-
 #### `unique_sdk.Content.delete` (Compatible with release >.36)
 
-Allows you to delete a file by its `contentId` or by its `filePath`. When deleting by `id`, if the file is part of a chat, the `chatId` also needs do be set. If both `contentId` and `filePath` are provided, `filePath` is ignored.
+Allows you to delete a file by its `contentId`. If the file is part of a chat, the `chatId` also needs do be set.
 
-- `contentId` optional if `filePath` is provided, the id of the file to be deleted
+- `contentId` the id of the file to be deleted
 - `chatId` optional, the id of the chat where the file is. Only needed if the file is part of a chat
-- `filePath` optional if `contentId` is provided, the absolute path of the file to be deleted
 
 Example of deleting a file from a chat.
 
@@ -620,16 +594,6 @@ unique_sdk.Content.delete(
 )
 ```
 
-Example of deleting a file by its path.
-
-```python
-unique_sdk.Content.delete(
-    user_id=user_id,
-    company_id=company_id,
-    filePath="/Company/finance/january.xls",
-)
-```
-
 ### Message
 
 #### `unique_sdk.Message.list`
@@ -1486,11 +1450,13 @@ The script sends a prompt asynchronously and continuously polls for completion,
 - `chat_id`: The ID of the chat where the message should be sent. If omitted, a new chat will be created.
 - `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).
+- `stop_condition`: Defines when to expect a response back, when the assistant stop streaming or when it completes the message. (default: "stoppedStreamingAt")
 
 The script ensures you can flexibly interact with spaces in new or ongoing chats, with fine-grained control over tools, context, and polling behavior.
 
 ```python
-latest_message = await unique_sdk.utils.chat_in_space.send_message_and_wait_for_completion(
+from unique_sdk.utils.chat_in_space import send_message_and_wait_for_completion
+latest_message = await send_message_and_wait_for_completion(
     user_id=user_id,
     company_id=company_id,
     assistant_id=assistant_id,
@@ -1517,6 +1483,7 @@ latest_message = await unique_sdk.utils.chat_in_space.send_message_and_wait_for_
             }
         ]
     },
+    stop_condition = "completedAt" # If not specified, stoppedStreamingAt will be set by default
 )
 ```
 

{unique_sdk-0.10.17 → unique_sdk-0.10.19}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "unique_sdk"
-version = "0.10.17"
+version = "0.10.19"
 description = ""
 authors = [
     "Martin Fadler <martin.fadler@unique.ch>",

{unique_sdk-0.10.17 → unique_sdk-0.10.19}/unique_sdk/api_resources/_content.py

@@ -12,7 +12,6 @@ from typing import (
 
 from typing_extensions import NotRequired, Unpack
 
-import unique_sdk
 from unique_sdk._api_resource import APIResource
 from unique_sdk._request_options import RequestOptions
 
@@ -130,9 +129,7 @@ class Content(APIResource["Content"]):
 
     class UpdateParams(RequestOptions):
         contentId: str | None = None
-        filePath: str | None = None
         ownerId: str | None = None
-        parentFolderPath: str | None = None
         title: str | None = None
 
     class Chunk(TypedDict):
@@ -168,7 +165,6 @@ class Content(APIResource["Content"]):
 
     class DeleteParams(RequestOptions):
         contentId: NotRequired[str]
-        filePath: NotRequired[str]
         chatId: NotRequired[str]
 
     class DeleteResponse(TypedDict):
@@ -406,28 +402,11 @@ class Content(APIResource["Content"]):
         company_id: str,
         **params: Unpack["Content.UpdateParams"],
     ) -> "Content.ContentInfo":
-        content_id = cls.resolve_content_id_from_file_path(
-            user_id,
-            company_id,
-            params.get("contentId"),
-            params.get("filePath"),
-        )
-        owner_id = unique_sdk.Folder.resolve_scope_id_from_folder_path(
-            user_id,
-            company_id,
-            params.get("ownerId"),
-            params.get("parentFolderPath"),
-        )
-        params.pop("contentId", None)
-        params.pop("filePath", None)
-        params.pop("parentFolderPath", None)
-        params["ownerId"] = owner_id
-
         return cast(
             "Content.ContentInfo",
             cls._static_request(
                 "patch",
-                f"/content/{content_id}",
+                f"/content/{params.get('contentId')}",
                 user_id,
                 company_id,
                 params=params,
@@ -441,28 +420,11 @@ class Content(APIResource["Content"]):
         company_id: str,
         **params: Unpack["Content.UpdateParams"],
     ) -> "Content.ContentInfo":
-        content_id = cls.resolve_content_id_from_file_path(
-            user_id,
-            company_id,
-            params.get("contentId"),
-            params.get("filePath"),
-        )
-        owner_id = unique_sdk.Folder.resolve_scope_id_from_folder_path(
-            user_id,
-            company_id,
-            params.get("ownerId"),
-            params.get("parentFolderPath"),
-        )
-        params.pop("contentId", None)
-        params.pop("filePath", None)
-        params.pop("parentFolderPath", None)
-        params["ownerId"] = owner_id
-
         return cast(
             "Content.ContentInfo",
             await cls._static_request_async(
                 "patch",
-                f"/content/{content_id}",
+                f"/content/{params.get('contentId')}",
                 user_id,
                 company_id,
                 params=params,
@@ -479,20 +441,12 @@ class Content(APIResource["Content"]):
         """
         Deletes a content by its id or file path.
         """
-        content_id = cls.resolve_content_id_from_file_path(
-            user_id,
-            company_id,
-            params.get("contentId"),
-            params.get("filePath"),
-        )
-        params.pop("contentId", None)
-        params.pop("filePath", None)
 
         return cast(
             "Content.DeleteResponse",
             cls._static_request(
                 "delete",
-                f"/content/{content_id}",
+                f"/content/{params.get('contentId')}",
                 user_id,
                 company_id,
                 params=params,
@@ -509,20 +463,12 @@ class Content(APIResource["Content"]):
         """
         Async deletes a content by its id or file path.
         """
-        content_id = cls.resolve_content_id_from_file_path(
-            user_id,
-            company_id,
-            params.get("contentId"),
-            params.get("filePath"),
-        )
-        params.pop("contentId", None)
-        params.pop("filePath", None)
 
         return cast(
             "Content.DeleteResponse",
             await cls._static_request_async(
                 "delete",
-                f"/content/{content_id}",
+                f"/content/{params.get('contentId')}",
                 user_id,
                 company_id,
                 params=params,

{unique_sdk-0.10.17 → unique_sdk-0.10.19}/unique_sdk/utils/chat_in_space.py

@@ -1,7 +1,8 @@
 import asyncio
-from typing import List
+from typing import List, Literal
 
 from unique_sdk.api_resources._content import Content
+from unique_sdk.api_resources._message import Message
 from unique_sdk.api_resources._space import Space
 from unique_sdk.utils.file_io import upload_file
 
@@ -16,6 +17,7 @@ async def send_message_and_wait_for_completion(
     chat_id: str = None,
     poll_interval: float = 1.0,
     max_wait: float = 60.0,
+    stop_condition: Literal["stoppedStreamingAt", "completedAt"] = "stoppedStreamingAt",
 ) -> "Space.Message":
     """
     Sends a prompt asynchronously and polls for completion. (until stoppedStreamingAt is not None)
@@ -27,6 +29,7 @@ async def send_message_and_wait_for_completion(
         text: The prompt text.
         poll_interval: Seconds between polls.
         max_wait: Maximum seconds to wait for completion.
+        stop_condition: Defines when to expect a response back, when the assistant stop streaming or when it completes the message. (default: "stoppedStreamingAt")
         **kwargs: Additional parameters for the prompt.
 
     Returns:
@@ -42,11 +45,21 @@ async def send_message_and_wait_for_completion(
         scopeRules=scope_rules,
     )
     chat_id = response.get("chatId")
+    message_id = response.get("id")
 
     max_attempts = int(max_wait // poll_interval)
     for _ in range(max_attempts):
         answer = Space.get_latest_message(user_id, company_id, chat_id)
-        if answer.get("stoppedStreamingAt") is not None:
+        if answer.get(stop_condition) is not None:
+            try:
+                user_message = Message.retrieve(
+                    user_id, company_id, message_id, chatId=chat_id
+                )
+                debug_info = user_message.get("debugInfo")
+                answer["debugInfo"] = debug_info
+            except Exception as e:
+                print(f"Failed to load debug info from user message: {e}")
+
             return answer
         await asyncio.sleep(poll_interval)