unique_sdk 0.10.49__tar.gz → 0.10.60__tar.gz

{unique_sdk-0.10.49 → unique_sdk-0.10.60}/CHANGELOG.md

@@ -5,6 +5,40 @@ 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.60] - 2025-12-19
+- Expose startedStreamingAt and gptRequest fields
+
+## [0.10.59] - 2025-12-19
+- Add context field to MagicTableSheetIngestParams.
+- Add rowMetadata and context fields to MagicTableRow.
+
+## [0.10.58] - 2025-12-16
+- chore(deps): Bump urllib3 from 2.5.0 to 2.6.2
+
+## [0.10.57] - 2025-12-06
+- Add description field on create chat completions params.
+
+## [0.10.56] - 2025-12-05
+- Add description field on create chat completions params.
+
+## [0.10.55] - 2025-12-04
+- Allow configuring inherit access on folder creation.
+
+## [0.10.54] - 2025-12-02
+- Add types for Agentic Table api methods.
+
+## [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
 

unique_sdk-0.10.60/PKG-INFO

@@ -0,0 +1,351 @@
+Metadata-Version: 2.1
+Name: unique_sdk
+Version: 0.10.60
+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.60] - 2025-12-19
+- Expose startedStreamingAt and gptRequest fields
+
+## [0.10.59] - 2025-12-19
+- Add context field to MagicTableSheetIngestParams.
+- Add rowMetadata and context fields to MagicTableRow.
+
+## [0.10.58] - 2025-12-16
+- chore(deps): Bump urllib3 from 2.5.0 to 2.6.2
+
+## [0.10.57] - 2025-12-06
+- Add description field on create chat completions params.
+
+## [0.10.56] - 2025-12-05
+- Add description field on create chat completions params.
+
+## [0.10.55] - 2025-12-04
+- Allow configuring inherit access on folder creation.
+
+## [0.10.54] - 2025-12-02
+- Add types for Agentic Table api methods.
+
+## [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
+

unique_sdk-0.10.60/README.md

@@ -0,0 +1,4 @@
+# Unique Python SDK
+
+
+Visit: [https://unique-ag.github.io/](https://unique-ag.github.io/ai/unique-sdk/) for the documentation.

{unique_sdk-0.10.49 → unique_sdk-0.10.60}/pyproject.toml

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

{unique_sdk-0.10.49 → unique_sdk-0.10.60}/unique_sdk/api_resources/_agentic_table.py

@@ -27,7 +27,7 @@ class LogEntry(TypedDict):
     createdAt: str
     actorType: Literal["USER", "SYSTEM", "ASSISTANT", "TOOL"]
     messageId: NotRequired[str]
-    details: NotRequired[list[LogDetail]]
+    details: NotRequired[LogDetail]
 
 
 class AgenticTableCell(TypedDict, total=False):
@@ -36,7 +36,7 @@ class AgenticTableCell(TypedDict, total=False):
     columnOrder: int
     rowLocked: bool
     text: str
-    logEntries: list[LogEntry]
+    logEntries: list[LogEntry] | None
 
 
 class ColumnMetadataUpdateStatus(TypedDict, total=False):
@@ -73,6 +73,29 @@ class CellRendererTypes(StrEnum):
     SELECTABLE_CELL_RENDERER = "SelectableCellRenderer"
 
 
+class MagicTableAction(StrEnum):
+    DELETE_ROW = "DeleteRow"
+    DELETE_COLUMN = "DeleteColumn"
+    UPDATE_CELL = "UpdateCell"
+    ADD_QUESTION_TEXT = "AddQuestionText"
+    ADD_META_DATA = "AddMetaData"
+    GENERATE_ARTIFACT = "GenerateArtifact"
+    SHEET_COMPLETED = "SheetCompleted"
+    LIBRARY_SHEET_ROW_VERIFIED = "LibrarySheetRowVerified"
+    SHEET_CREATED = "SheetCreated"
+
+
+class ActivityStatus(StrEnum):
+    IN_PROGRESS = "IN_PROGRESS"
+    COMPLETED = "COMPLETED"
+    FAILED = "FAILED"
+
+
+class SheetType(StrEnum):
+    DEFAULT = "DEFAULT"
+    LIBRARY = "LIBRARY"
+
+
 class SelectionMethod(StrEnum):
     DEFAULT = "DEFAULT"
     MANUAL = "MANUAL"
@@ -105,24 +128,12 @@ class AgenticTable(APIResource["AgenticTable"]):
         tableId: str
         rowOrder: int
         columnOrder: int
+        includeRowMetadata: NotRequired[bool]
 
     class SetActivityStatus(RequestOptions):
         tableId: str
-        activity: Literal[
-            "DeleteRow",
-            "DeleteColumn",
-            "UpdateCell",
-            "AddQuestionText",
-            "AddMetaData",
-            "GenerateArtifact",
-            "SheetCompleted",
-            "LibrarySheetRowVerified",
-        ]
-        status: Literal[
-            "IN_PROGRESS",
-            "COMPLETED",
-            "FAILED",
-        ]
+        activity: MagicTableAction
+        status: ActivityStatus
         text: str
 
     class SetArtifact(RequestOptions):
@@ -200,6 +211,9 @@ class AgenticTable(APIResource["AgenticTable"]):
     ) -> "AgenticTableCell":
         """ """
         url = f"/magic-table/{params['tableId']}/cell?rowOrder={params['rowOrder']}&columnOrder={params['columnOrder']}"
+        params.pop("tableId")
+        params.pop("rowOrder")
+        params.pop("columnOrder")
         return cast(
             "AgenticTableCell",
             await cls._static_request_async(
@@ -207,7 +221,7 @@ class AgenticTable(APIResource["AgenticTable"]):
                 url,
                 user_id,
                 company_id,
-                params={},
+                params=params,
             ),
         )
 

{unique_sdk-0.10.49 → unique_sdk-0.10.60}/unique_sdk/api_resources/_content.py

@@ -210,20 +210,23 @@ class Content(APIResource["Content"]):
         columnName: str
         content: str
 
-    class MagicTableSheetTable(TypedDict):
+    class MagicTableRow(TypedDict):
         rowId: str
         columns: List["Content.MagicTableSheetTableColumn"]
+        context: NotRequired[str]
+        rowMetadata: NotRequired[str]
 
     class MagicTableSheetIngestionConfiguration(TypedDict):
         columnIdsInMetadata: List[str]
         columnIdsInChunkText: List[str]
 
     class MagicTableSheetIngestParams(TypedDict):
-        data: List["Content.MagicTableSheetTable"]
+        data: List["Content.MagicTableRow"]
         ingestionConfiguration: "Content.MagicTableSheetIngestionConfiguration"
         metadata: Dict[str, Optional[str]]
         scopeId: str
         sheetName: str
+        context: NotRequired[str]
 
     class MagicTableSheetRowIdToContentId(TypedDict):
         rowId: str

{unique_sdk-0.10.49 → unique_sdk-0.10.60}/unique_sdk/api_resources/_folder.py

@@ -69,6 +69,7 @@ class Folder(APIResource["Folder"]):
 
     class CreateParams(RequestOptions):
         paths: List[str]
+        inheritAccess: NotRequired[bool]
 
     class FolderInfo(TypedDict):
         """

{unique_sdk-0.10.49 → unique_sdk-0.10.60}/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-0.10.49 → unique_sdk-0.10.60}/unique_sdk/api_resources/_integrated.py

@@ -42,6 +42,7 @@ class Integrated(APIResource["Integrated"]):
         chunkId: str
         key: str
         title: NotRequired["str"]
+        description: NotRequired["str"]
         url: NotRequired["str"]
 
     class ChatCompletionRequestMessage(TypedDict, total=False):

{unique_sdk-0.10.49 → unique_sdk-0.10.60}/unique_sdk/api_resources/_message.py

@@ -47,10 +47,14 @@ class Message(APIResource["Message"]):
 
     class ModifyParams(RequestOptions):
         chatId: str
+        originalText: NotRequired[str | None]
         text: NotRequired[Optional["str"]]
-        references: Optional[List["Message.Reference"]]
-        debugInfo: Optional[Dict[str, Any]]
-        completedAt: Optional[datetime]
+        references: NotRequired[List["Message.Reference"] | None]
+        gptRequest: NotRequired[Dict[str, Any] | None]
+        debugInfo: NotRequired[Dict[str, Any] | None]
+        startedStreamingAt: NotRequired[datetime | None]
+        stoppedStreamingAt: NotRequired[datetime | None]
+        completedAt: NotRequired[datetime | None]
 
     class DeleteParams(RequestOptions):
         chatId: str
@@ -61,21 +65,16 @@ class Message(APIResource["Message"]):
     class RetrieveParams(RequestOptions):
         chatId: str
 
-    class CreateEventParams(RequestOptions):
+    class CreateEventParams(ModifyParams):
         messageId: str
-        chatId: str
-        originalText: NotRequired[str | None]
-        text: NotRequired[str | None]
-        references: NotRequired[List["Message.Reference"] | None]
-        gptRequest: NotRequired[Dict[str, Any] | None]
-        debugInfo: NotRequired[Dict[str, Any] | None]
-        completedAt: NotRequired[datetime | None]
 
     chatId: str
     text: Optional[str]
     role: Literal["SYSTEM", "USER", "ASSISTANT"]
     gptRequest: Optional[Dict[str, Any]]
     debugInfo: Optional[Dict[str, Any]]
+    startedStreamingAt: Optional[datetime]
+    stoppedStreamingAt: Optional[datetime]
 
     @classmethod
     def list(