unique_sdk 0.9.41__tar.gz → 0.10.0__tar.gz

{unique_sdk-0.9.41 → unique_sdk-0.10.0}/CHANGELOG.md

@@ -5,6 +5,12 @@ 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.0] - 2025-08-04
+- Add MCP support
+
+## [0.9.42] - 2025-07-31
+- Fix wrong chat in space example.
+
 ## [0.9.41] - 2025-07-31
 - Fix double-slash error in open ai proxy script.
 

{unique_sdk-0.9.41 → unique_sdk-0.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_sdk
-Version: 0.9.41
+Version: 0.10.0
 Summary: 
 License: MIT
 Author: Martin Fadler
@@ -905,7 +905,7 @@ unique_sdk.Folder.add_access(
 
 #### `unique_sdk.Folder.remove_access`
 
-Allows you to delete access from a folder and apply to the subfolders or not: `
+Allows you to delete access from a folder and apply to the subfolders or not:
 
 - `scopeAccesses`
 - `applyToSubScopes`
@@ -1227,8 +1227,8 @@ The following script enables you to chat within a space using an assistant. You
 The script sends a prompt asynchronously and continuously polls for completion, which is determined when the `stoppedStreamingAt` field of the message becomes non-null.
 
 **Optional parameters:**
-- `tool_choices`: A list of tool names to be used for the message (e.g., `["WebSearch"]`). If not provided, no tools will be used.
-- `scope_rules`: A dictionary specifying scope rules for the message, allowing you to restrict the context or data sources available to the assistant.
+- `tool_choices`: A list of tool names to be used for the message (e.g., `["WebSearch"]`). If not provided, no tools will be used. The tools supported right now are `WebSearch` and `InternalSearch`.
+- `scope_rules`: A filter to specify the scope rules for the message, allowing you to restrict the context or data sources available to the assistant. The filter is written in UniqueQL language. Find out more about the language in the UniqueQL section.
 - `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).
@@ -1236,12 +1236,12 @@ The script sends a prompt asynchronously and continuously polls for completion,
 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 = unique_sdk.utils.send_message_and_wait_for_completion(
+latest_message = await unique_sdk.utils.chat_in_space.send_message_and_wait_for_completion(
         user_id=user_id,
         company_id=company_id,
         assistant_id=assistant_id,
         text="Tell me a short story.",
-        chat_id=chat_id, # Optional - if no chat id is specified, a new chat will be created
+        chat_id=chat_id,                # Optional - if no chat id is specified, a new chat will be created
         tool_choices=["WebSearch"],
         scope_rules={
             "or": [
@@ -1253,6 +1253,13 @@ latest_message = unique_sdk.utils.send_message_and_wait_for_completion(
                     "value": [
                         "cont_u888z7cazxxm4lugfdjq7pks"
                     ]
+                },
+                {
+                    "operator": "contains",
+                    "path": [
+                        "folderIdPath"
+                    ],
+                    "value": "uniquepathid://scope_btfo28b3eeelwh5obwgea71bl/scope_fn56ta67knd6w4medgq3028fx"
                 }
             ]
         },
@@ -1276,6 +1283,12 @@ 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.0] - 2025-08-04
+- Add MCP support
+
+## [0.9.42] - 2025-07-31
+- Fix wrong chat in space example.
+
 ## [0.9.41] - 2025-07-31
 - Fix double-slash error in open ai proxy script.
 

{unique_sdk-0.9.41 → unique_sdk-0.10.0}/README.md

@@ -889,7 +889,7 @@ unique_sdk.Folder.add_access(
 
 #### `unique_sdk.Folder.remove_access`
 
-Allows you to delete access from a folder and apply to the subfolders or not: `
+Allows you to delete access from a folder and apply to the subfolders or not:
 
 - `scopeAccesses`
 - `applyToSubScopes`
@@ -1211,8 +1211,8 @@ The following script enables you to chat within a space using an assistant. You
 The script sends a prompt asynchronously and continuously polls for completion, which is determined when the `stoppedStreamingAt` field of the message becomes non-null.
 
 **Optional parameters:**
-- `tool_choices`: A list of tool names to be used for the message (e.g., `["WebSearch"]`). If not provided, no tools will be used.
-- `scope_rules`: A dictionary specifying scope rules for the message, allowing you to restrict the context or data sources available to the assistant.
+- `tool_choices`: A list of tool names to be used for the message (e.g., `["WebSearch"]`). If not provided, no tools will be used. The tools supported right now are `WebSearch` and `InternalSearch`.
+- `scope_rules`: A filter to specify the scope rules for the message, allowing you to restrict the context or data sources available to the assistant. The filter is written in UniqueQL language. Find out more about the language in the UniqueQL section.
 - `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).
@@ -1220,12 +1220,12 @@ The script sends a prompt asynchronously and continuously polls for completion,
 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 = unique_sdk.utils.send_message_and_wait_for_completion(
+latest_message = await unique_sdk.utils.chat_in_space.send_message_and_wait_for_completion(
         user_id=user_id,
         company_id=company_id,
         assistant_id=assistant_id,
         text="Tell me a short story.",
-        chat_id=chat_id, # Optional - if no chat id is specified, a new chat will be created
+        chat_id=chat_id,                # Optional - if no chat id is specified, a new chat will be created
         tool_choices=["WebSearch"],
         scope_rules={
             "or": [
@@ -1237,6 +1237,13 @@ latest_message = unique_sdk.utils.send_message_and_wait_for_completion(
                     "value": [
                         "cont_u888z7cazxxm4lugfdjq7pks"
                     ]
+                },
+                {
+                    "operator": "contains",
+                    "path": [
+                        "folderIdPath"
+                    ],
+                    "value": "uniquepathid://scope_btfo28b3eeelwh5obwgea71bl/scope_fn56ta67knd6w4medgq3028fx"
                 }
             ]
         },

{unique_sdk-0.9.41 → unique_sdk-0.10.0}/pyproject.toml

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

{unique_sdk-0.9.41 → unique_sdk-0.10.0}/unique_sdk/__init__.py

@@ -87,6 +87,7 @@ from unique_sdk.api_resources._message_assessment import (
     MessageAssessment as MessageAssessment,
 )
 from unique_sdk.api_resources._space import Space as Space
+from unique_sdk.api_resources._mcp import MCP as MCP
 
 # Unique QL
 from unique_sdk._unique_ql import UQLOperator as UQLOperator

unique_sdk-0.10.0/unique_sdk/api_resources/_mcp.py

@@ -0,0 +1,118 @@
+from typing import (
+    Any,
+    ClassVar,
+    Dict,
+    List,
+    Literal,
+    Optional,
+    TypedDict,
+    Union,
+    Unpack,
+    cast,
+)
+
+from typing_extensions import NotRequired
+
+from unique_sdk._api_resource import APIResource
+from unique_sdk._request_options import RequestOptions
+
+
+class CallToolTextResourceDto(TypedDict):
+    """Text resource containing URI, optional MIME type, and text content."""
+    uri: str
+    mimeType: Optional[str]
+    text: str
+
+
+class CallToolBlobResourceDto(TypedDict):
+    """Blob resource containing URI, optional MIME type, and base64-encoded content."""
+    uri: str
+    mimeType: Optional[str]
+    blob: str
+
+
+class CallToolContentDto(TypedDict):
+    """Content returned by an MCP tool call."""
+    type: Literal["text", "image", "audio", "resource_link", "resource"]
+    
+    # Optional fields for different content types
+    text: NotRequired[Optional[str]]  # For type: "text"
+    data: NotRequired[Optional[str]]  # Base64 data for type: "image" or "audio"
+    mimeType: NotRequired[Optional[str]]  # For type: "image", "audio", or "resource_link"
+    uri: NotRequired[Optional[str]]  # For type: "resource_link"
+    name: NotRequired[Optional[str]]  # For type: "resource_link"
+    description: NotRequired[Optional[str]]  # For type: "resource_link"
+    resource: NotRequired[Optional[Union[CallToolTextResourceDto, CallToolBlobResourceDto]]]  # For type: "resource"
+
+
+class MCP(APIResource["MCP"]):
+    OBJECT_NAME: ClassVar[Literal["mcp.call_tool"]] = "mcp.call_tool"
+
+    class CallToolParams(RequestOptions):
+        """Parameters for calling an MCP tool."""
+        name: str
+        arguments: Dict[str, Any]
+
+    # Response fields
+    content: List[CallToolContentDto]
+    isError: bool
+    mcpServerId: str
+    name: str
+
+    @classmethod
+    def call_tool(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["MCP.CallToolParams"],
+    ) -> "MCP":
+        """
+        Call an MCP tool with the specified name and arguments.
+        
+        Args:
+            user_id: The ID of the user making the request
+            company_id: The ID of the company
+            **params: Tool parameters including name and arguments
+            
+        Returns:
+            MCP: The response from the MCP tool call
+        """
+        return cast(
+            "MCP",
+            cls._static_request(
+                "post",
+                "/mcp/call-tool",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def call_tool_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["MCP.CallToolParams"],
+    ) -> "MCP":
+        """
+        Asynchronously call an MCP tool with the specified name and arguments.
+        
+        Args:
+            user_id: The ID of the user making the request
+            company_id: The ID of the company
+            **params: Tool parameters including name and arguments
+            
+        Returns:
+            MCP: The response from the MCP tool call
+        """
+        return cast(
+            "MCP",
+            await cls._static_request_async(
+                "post",
+                "/mcp/call-tool",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )