unique_sdk 0.10.47__py3-none-any.whl → 0.10.53__py3-none-any.whl

unique_sdk/api_resources/_agentic_table.py

@@ -19,8 +19,7 @@ class AgenticTableSheetState(StrEnum):
 
 
 class LogDetail(TypedDict, total=False):
-    text: str
-    messageId: str | None
+    llmRequest: list[dict] | None
 
 
 class LogEntry(TypedDict):

unique_sdk/api_resources/_folder.py

@@ -177,6 +177,53 @@ class Folder(APIResource["Folder"]):
         successFolders: List["Folder.DeleteFolderResponse"]
         failedFolders: List["Folder.DeleteFolderResponse"]
 
+    class FolderPathResponse(TypedDict):
+        """
+        Response for getting folder path.
+        """
+
+        folderPath: str
+
+    @classmethod
+    def get_folder_path(
+        cls,
+        user_id: str,
+        company_id: str,
+        scope_id: str,
+    ) -> "Folder.FolderPathResponse":
+        """
+        Get the complete folder path for a given folder ID.
+        """
+        return cast(
+            "Folder.FolderPathResponse",
+            cls._static_request(
+                "get",
+                f"/folder/{scope_id}/path",
+                user_id,
+                company_id,
+            ),
+        )
+
+    @classmethod
+    async def get_folder_path_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        scope_id: str,
+    ) -> "Folder.FolderPathResponse":
+        """
+        Async get the complete folder path for a given folder ID.
+        """
+        return cast(
+            "Folder.FolderPathResponse",
+            await cls._static_request_async(
+                "get",
+                f"/folder/{scope_id}/path",
+                user_id,
+                company_id,
+            ),
+        )
+
     @classmethod
     def get_info(
         cls, user_id: str, company_id: str, **params: Unpack["Folder.GetParams"]

unique_sdk/api_resources/_group.py

@@ -1,5 +1,7 @@
 from typing import (
+    Any,
     ClassVar,
+    Dict,
     List,
     Literal,
     NotRequired,
@@ -55,6 +57,13 @@ class Group(APIResource["Group"]):
 
         userIds: List[str]
 
+    class UpdateGroupConfigurationParams(RequestOptions):
+        """
+        Parameters for updating group configuration.
+        """
+
+        configuration: Dict[str, Any]
+
     class GroupMember(TypedDict):
         """
         Represents a member of a group.
@@ -84,6 +93,13 @@ class Group(APIResource["Group"]):
         createdAt: str
         updatedAt: str
 
+    class GroupWithConfiguration(Group):
+        """
+        Represents a group in the company with configuration.
+        """
+
+        configuration: Dict[str, Any]
+
     class Groups(TypedDict):
         """
         Response for getting groups.
@@ -367,3 +383,47 @@ class Group(APIResource["Group"]):
                 params=params,
             ),
         )
+
+    @classmethod
+    def update_group_configuration(
+        cls,
+        user_id: str,
+        company_id: str,
+        group_id: str,
+        **params: Unpack["Group.UpdateGroupConfigurationParams"],
+    ) -> "Group.GroupWithConfiguration":
+        """
+        Update group configuration for the specified group.
+        """
+        return cast(
+            "Group.GroupWithConfiguration",
+            cls._static_request(
+                "patch",
+                f"/groups/{group_id}/configuration",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def update_group_configuration_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        group_id: str,
+        **params: Unpack["Group.UpdateGroupConfigurationParams"],
+    ) -> "Group.GroupWithConfiguration":
+        """
+        Async update group configuration for the specified group.
+        """
+        return cast(
+            "Group.GroupWithConfiguration",
+            await cls._static_request_async(
+                "patch",
+                f"/groups/{group_id}/configuration",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )

unique_sdk/api_resources/_space.py

@@ -102,6 +102,86 @@ class Space(APIResource["Space"]):
         messages: List["Space.Message"]
         totalCount: int
 
+    class AssistantMcpServer(TypedDict):
+        """
+        Represents an MCP server associated with an assistant.
+        """
+
+        id: str
+        name: str
+        assistantId: str
+        mcpServerId: str
+        isEnabled: bool
+        createdAt: str
+        updatedAt: str
+
+    class Module(TypedDict):
+        """
+        Represents a module configured for a space.
+        """
+
+        id: str
+        name: str
+        description: Optional[str]
+        toolDefinition: Optional[Dict[str, Any]]
+        configuration: Dict[str, Any]
+        assistantId: str
+        weight: int
+        isExternal: bool
+        isCustomInstructionEnabled: bool
+        moduleTemplateId: Optional[str]
+        createdAt: str
+        updatedAt: str
+
+    class ScopeRule(TypedDict):
+        """
+        Represents a scope rule for a space.
+        """
+
+        id: str
+        assistantId: str
+        title: str
+        companyId: str
+        rule: Dict[str, Any]
+        isAdvanced: bool
+        createdAt: str
+        updatedAt: str
+
+    class AssistantAccess(TypedDict):
+        """
+        Represents access control for a space.
+        """
+
+        id: str
+        entityId: str
+        entityType: str
+        type: str
+
+    id: str
+    name: str
+    defaultForCompanyId: Optional[str]
+    title: Optional[str]
+    subtitle: Optional[str]
+    explanation: Optional[str]
+    alert: Optional[str]
+    inputLimit: Optional[int]
+    inputPlaceholder: Optional[str]
+    chatUpload: str
+    goals: List[str]
+    languageModel: Optional[str]
+    fallbackModule: str
+    access: List[str]
+    isExternal: bool
+    isPinned: bool
+    uiType: str
+    settings: Optional[Dict[str, Any]]
+    assistantMcpServers: List["Space.AssistantMcpServer"]
+    modules: List["Space.Module"]
+    scopeRules: List["Space.ScopeRule"]
+    assistantAccess: List["Space.AssistantAccess"]
+    createdAt: str
+    updatedAt: str
+
     @classmethod
     def create_message(
         cls,
@@ -263,3 +343,43 @@ class Space(APIResource["Space"]):
                 company_id,
             ),
         )
+
+    @classmethod
+    def get_space(
+        cls,
+        user_id: str,
+        company_id: str,
+        space_id: str,
+    ) -> "Space":
+        """
+        Get detailed information about a space (assistant).
+        """
+        return cast(
+            "Space",
+            cls._static_request(
+                "get",
+                f"/space/{space_id}",
+                user_id,
+                company_id,
+            ),
+        )
+
+    @classmethod
+    async def get_space_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        space_id: str,
+    ) -> "Space":
+        """
+        Async get detailed information about a space (assistant).
+        """
+        return cast(
+            "Space",
+            await cls._static_request_async(
+                "get",
+                f"/space/{space_id}",
+                user_id,
+                company_id,
+            ),
+        )

unique_sdk/api_resources/_user.py

@@ -1,5 +1,7 @@
 from typing import (
+    Any,
     ClassVar,
+    Dict,
     List,
     NotRequired,
     Optional,
@@ -25,6 +27,13 @@ class User(APIResource["User"]):
         email: NotRequired[Optional[str]]
         displayName: NotRequired[Optional[str]]
 
+    class UpdateUserConfigurationParams(RequestOptions):
+        """
+        Parameters for updating user configuration.
+        """
+
+        userConfiguration: Dict[str, Any]
+
     class User(TypedDict):
         """
         Represents a user in the company.
@@ -41,6 +50,13 @@ class User(APIResource["User"]):
         createdAt: str
         active: bool
 
+    class UserWithConfiguration(User):
+        """
+        Represents a user in the company with configuration.
+        """
+
+        userConfiguration: Dict[str, Any]
+
     class Users(TypedDict):
         """
         Response for getting users.
@@ -89,3 +105,45 @@ class User(APIResource["User"]):
                 params=params,
             ),
         )
+
+    @classmethod
+    def update_user_configuration(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["User.UpdateUserConfigurationParams"],
+    ) -> "User.UserWithConfiguration":
+        """
+        Update user configuration for the current user.
+        """
+        return cast(
+            "User.UserWithConfiguration",
+            cls._static_request(
+                "patch",
+                f"/users/{user_id}/configuration",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def update_user_configuration_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["User.UpdateUserConfigurationParams"],
+    ) -> "User.UserWithConfiguration":
+        """
+        Async update user configuration for the current user.
+        """
+        return cast(
+            "User.UserWithConfiguration",
+            await cls._static_request_async(
+                "patch",
+                f"/users/{user_id}/configuration",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )

unique_sdk-0.10.53.dist-info/METADATA

@@ -0,0 +1,329 @@
+Metadata-Version: 2.1
+Name: unique_sdk
+Version: 0.10.53
+Summary: 
+License: MIT
+Author: Martin Fadler
+Author-email: martin.fadler@unique.ch
+Requires-Python: >=3.11,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Provides-Extra: openai
+Requires-Dist: openai (>=1.105.0,<2.0.0) ; extra == "openai"
+Requires-Dist: requests (>=2.32.3,<3.0.0)
+Requires-Dist: typing-extensions (>=4.9.0,<5.0.0)
+Description-Content-Type: text/markdown
+
+# Unique Python SDK
+
+
+Visit: [https://unique-ag.github.io/](https://unique-ag.github.io/ai/unique-sdk/) for the documentation.
+
+# Changelog
+
+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.53] - 2025-12-01
+- Improve OpenAI Proxy docs https://unique-ag.github.io/ai/unique-sdk/
+
+## [0.10.52] - 2025-11-21
+- Centralized docs to https://unique-ag.github.io/ai/unique-sdk/
+
+## [0.10.51] - 2025-11-21
+- Add function to get a space.
+
+## [0.10.50] - 2025-11-21
+- Allow updating the configuration of a user and group.
+
+## [0.10.49] - 2025-11-21
+- Add get folder by scope id function
+
+## [0.10.48] - 2025-11-20
+- Update Agentic Table LogDetail and LogEntry types.
+
+## [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
+
+## [0.10.35] - 2025-11-04
+- Inmprove folder get infos types.
+
+## [0.10.34] - 2025-10-29
+- Add documentation for agentic table.
+
+## [0.10.33] - 2025-10-27
+- Improve messagelog and message execution types.
+
+## [0.10.32] - 2025-10-14
+- Add function to stream to chat frontend.
+
+## [0.10.31] - 2025-10-13
+- Add readme for message log and execution.
+
+## [0.10.30] - 2025-10-07
+- Improve types for content get infos.
+
+## [0.10.29] - 2025-10-06
+- Switch default model used from `GPT-3.5-turbo (0125)` to `GPT-4o (1120)`
+
+## [0.10.28] - 2025-10-03
+- Use non blocking versions of `Space.get_latest_message` and `Message.retrieve` in `send_message_and_wait_for_completion`.
+
+## [0.10.27] - 2025-09-24
+- Improve readme to use Unique AI.
+
+## [0.10.26] - 2025-09-22
+- Improve typing.
+
+## [0.10.25] - 2025-09-18
+- Add support for udpate and delete files by file or folder path.
+
+## [0.10.24] - 2025-09-17
+- Add function to update a folder.
+
+## [0.10.23] - 2025-09-12
+- Revert to using default reasoning effort.
+
+## [0.10.22] - 2025-09-12
+- Add support for metadata update of a file.
+
+## [0.10.21] - 2025-09-04
+- Update Chat Completions API types and add support for reasoning effort.
+
+## [0.10.20] - 2025-09-04
+- Update Responses API types
+
+## [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
+
+## [0.10.16] - 2025-08-31
+- Add function to delete a content.
+
+## [0.10.15] - 2025-08-28
+- Add default values for message log types
+
+## [0.10.14] - 2025-08-28
+- Add function to delete folders and files recursively
+
+## [0.10.13] - 2025-08-24
+- Add functions to create, get and update a message eecution and create and update a message log.
+
+## [0.10.12] - 2025-08-24
+- Switch to using Content get info deprecated endpoint to make sure we support older release versions.
+
+## [0.10.11] - 2025-08-24
+- Enforce usage of ruff using pipeline
+
+## [0.10.10] - 2025-08-18
+- Fix wrong name of references in `Space.Message`. 
+- Fix wrong name of assessment in `Space.Message`.
+- Remove default values for `text`, `originalText` and `debugInfo` in `Space.Message` as these don't have an effect.
+
+## [0.10.9] - 2025-08-15
+- Add script to wait for content ingestion finished.
+
+## [0.10.8] - 2025-08-13
+- Add support for Agentic Table.
+
+## [0.10.7] - 2025-08-13
+- Make metadata optional when uploading a file.
+
+## [0.10.6] - 2025-08-06
+- Make tools optional for running an agent.
+
+## [0.10.5] - 2025-08-06
+- Get paginated files and folders info.
+
+## [0.10.4] - 2025-08-05
+- Add support for reasoning API with streaming within a chat.
+
+## [0.10.3] - 2025-08-05
+- Expose scoreThreshold param for search.
+
+## [0.10.2] - 2025-08-05
+- Add script to chat against file.
+
+## [0.10.1] - 2025-08-05
+- Allow deletion of a space chat.
+
+## [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.
+
+## [0.9.40] - 2025-07-22
+- Fixed bug where get requests send body with the request. This is not allowed by WAF policies.
+
+## [0.9.39] - 2025-07-18
+- Add script to chat in a space.
+
+## [0.9.38] - 2025-07-18
+- [Experimental] Add support for Unique OpenAI proxy. You can now use the OpenAI SDK directly through Unique. Checkout how to do this and a few examples here: `tutorials/unique_basics/sdk_examples/openai_scripts.py`.
+
+## [0.9.37] - 2025-07-10
+- Add `sheetName` property to the `MagicTableSheetIngestParams` object used by function that ingests magic table sheets.
+
+## [0.9.36] - 2025-06-23
+- Allow passing a user id when creating chat completions. This is optional and it does not impact the current behaviour.
+
+## [0.9.35] - 2025-06-18
+- Allow scope access updates (add/remove) on folder based on scope id or path.
+
+## [0.9.34] - 2025-06-17
+- Allow ingestion config updates on folder based on scope id or path.
+
+## [0.9.33] - 2025-06-11
+- Add function to get a folder by id or by path.
+
+## [0.9.32] - 2025-06-11
+- Add function to ingest magic table sheets.
+
+## [0.9.31] - 2025-05-21
+- Add function to update folder access (add or remove).
+
+## [0.9.30] - 2025-05-21
+- Add function to update folder ingestion config.
+
+## [0.9.29] - 2025-05-20
+- Add function to create folder paths if they do not exist.
+
+## [0.9.28] - 2025-05-20
+- Add function to search content info. This also allows filtering content info by metadata info.
+
+## [0.9.27] - 2025-05-14
+- Add the possibility to specify metadata when creating or updating a Content.
+
+## [0.9.26] - 2025-05-13
+- Add the possibility to specify ingestionConfig when creating or updating a Content.
+
+## [0.9.25] - 2025-05-02
+- Fixed typos in `README.md`, including incorrect `sdk.utils` imports and code example errors.
+
+## [0.9.24] - 2025-04-23
+- Make `chatId` property in `Search.CreateParams` optional
+
+## [0.9.23] - 2025-03-25
+- Define programming language classifier explicitly for python 3.11
+
+## [0.9.22] - 2025-02-25
+- update the retry_on_error to only `APIError` and `APIConnectionError` update the `resp["error"]` to be `resp.get("error")` to avoid key error
+
+## [0.9.21] - 2025-02-21
+- Add title parameter and change labels in `MessageAssessment`
+
+## [0.9.20] - 2025-02-01
+- Add url parameter to `MessageAssessment.create_async` and `MessageAssessment.modify_async`
+
+## [0.9.19] - 2025-01-31
+- Add `MessageAssessment` resource
+
+## [0.9.18] - 2025-01-22
+- Removed `Invalid response body from API` from `retry_dict` as it's our own artificail error.
+
+## [0.9.17] - 2025-01-03
+- BREAKING CHANGE!! Removed unused `id` from `ShortTermMemory` create and find methods.
+
+## [0.9.16] - 2024-12-19
+- Corrected return type of `Search.create` and `Search.create_async` to `List[Search]`
+- Retry on `Connection aborted` error
+
+## [0.9.15] - 2024-12-06
+- Add `Internal server error` and `You can retry your request` to the retry logic
+
+## [0.9.14] - 2024-12-06
+- Add `contentIds` to `Search.create` and `Search.create_async`
+
+## [0.9.13] - 2024-10-23
+- Add retry for `5xx` errors, add additional error message.
+
+## [0.9.12] - 2024-11-21
+- Include original error message in returned exceptions
+
+## [0.9.11] - 2024-11-18
+- Add  `ingestionConfig` to `UpsertParams.Input` parameters 
+
+## [0.9.10] - 2024-10-23
+- Remove `temperature` parameter from `Integrated.chat_stream_completion`, `Integrated.chat_stream_completion_async`, `ChatCompletion.create` and `ChatCompletion.create_async` methods. To use `temperature` parameter, set the attribute in `options` parameter instead.
+
+## [0.9.9] - 2024-10-23
+- Revert deletion of `Message.retrieve` method
+
+## [0.9.8] - 2024-10-16
+- Add `retries` for `_static_request` and `_static_request_async` in `APIResource` - When the error messages contains either  `"problem proxying the request"`,
+        or `"Upstream service reached a hard timeout"`,
+## [0.9.7] - 2024-09-23
+- Add `completedAt` to `CreateParams` of `Message`
+
+## [0.9.6] - 2024-09-03
+- Added `metaDataFilter` to `Search` parameters.
+
+## [0.9.5] - 2024-08-07
+- Add `completedAt` to `ModifyParams`
+
+## [0.9.4] - 2024-07-31
+- Add `close` and `close_async` to `http_client`
+- Make `httpx` the default client for async requests
+
+## [0.9.3] - 2024-07-31
+- `Search.create`, `Message`, `ChatCompletion` parameters that were marked `NotRequired` are now also `Optional`
+
+## [0.9.2] - 2024-07-30
+- Bug fix in `Search.create`: langugage -> language 
+
+## [0.9.1] - 2024-07-30
+- Added parameters to `Search.create` and `Search.create_async`
+    - `language` for full text search
+    - `reranker` to reranker search results
+
+## [0.9.0] - 2024-07-29
+- Added the possibility to make async requests to the unique APIs using either aiohttp or httpx as client
+