cheshirecat-python-sdk 1.7.9__py3-none-any.whl → 1.8.4__py3-none-any.whl

cheshirecat_python_sdk/builders/__init__.py

@@ -1,3 +1,3 @@
-from cheshirecat_python_sdk.builders.memory import MemoryBuilder, MemoryPointBuilder
+from cheshirecat_python_sdk.builders.memory import MemoryPointBuilder
 from cheshirecat_python_sdk.builders.settings_input import SettingInputBuilder
 from cheshirecat_python_sdk.builders.why import WhyBuilder

cheshirecat_python_sdk/builders/memory.py

@@ -1,26 +1,7 @@
 from typing import Dict, Any
 
 from cheshirecat_python_sdk.builders.base import BaseBuilder
-from cheshirecat_python_sdk.models.dtos import Memory, MemoryPoint
-
-
-class MemoryBuilder(BaseBuilder):
-    def __init__(self):
-        self.declarative: Dict[str, Any] | None = None
-
-    @staticmethod
-    def create():
-        return MemoryBuilder()
-
-    def set_declarative(self, declarative: Dict[str, Any] | None = None):
-        self.declarative = declarative or {}
-        return self
-
-    def build(self):
-        memory = Memory()
-        memory.declarative = self.declarative
-
-        return memory
+from cheshirecat_python_sdk.models.dtos import MemoryPoint
 
 
 class MemoryPointBuilder(BaseBuilder):

cheshirecat_python_sdk/builders/why.py

@@ -1,14 +1,14 @@
-from typing import Dict, Any
+from typing import List
 
 from cheshirecat_python_sdk.builders.base import BaseBuilder
-from cheshirecat_python_sdk.models.dtos import Memory, Why
+from cheshirecat_python_sdk.models.dtos import Why
 
 
 class WhyBuilder(BaseBuilder):
     def __init__(self):
         self.input: str | None = None
-        self.intermediate_steps: Dict[str, Any] | None = None
-        self.memory: Memory | None = None
+        self.intermediate_steps: List | None = []
+        self.memory: List | None = []
 
     @staticmethod
     def create() -> "WhyBuilder":
@@ -18,12 +18,12 @@ class WhyBuilder(BaseBuilder):
         self.input = input
         return self
 
-    def set_intermediate_steps(self, intermediate_steps: Dict[str, Any] | None = None) -> "WhyBuilder":
-        self.intermediate_steps = intermediate_steps
+    def set_intermediate_steps(self, intermediate_steps: List | None = None) -> "WhyBuilder":
+        self.intermediate_steps = intermediate_steps or []
         return self
 
-    def set_memory(self, memory: Memory) -> "WhyBuilder":
-        self.memory = memory
+    def set_memory(self, memory: List | None = None) -> "WhyBuilder":
+        self.memory = memory or []
         return self
 
     def build(self) -> Why:

cheshirecat_python_sdk/client.py

@@ -18,6 +18,7 @@ from cheshirecat_python_sdk.endpoints import (
     UtilsEndpoint,
     VectorDatabaseEndpoint,
     HealthCheckEndpoint,
+    AgenticWorkflowEndpoint,
 )
 
 
@@ -64,6 +65,10 @@ class CheshireCatClient:
     def auth_handler(self):
         return AuthHandlerEndpoint(self)
 
+    @property
+    def agentic_workflow(self):
+        return AgenticWorkflowEndpoint(self)
+
     @property
     def chunker(self):
         return ChunkerEndpoint(self)

cheshirecat_python_sdk/endpoints/__init__.py

@@ -1,4 +1,5 @@
 from cheshirecat_python_sdk.endpoints.admins import AdminsEndpoint
+from cheshirecat_python_sdk.endpoints.agentic_workflow import AgenticWorkflowEndpoint
 from cheshirecat_python_sdk.endpoints.auth import AuthEndpoint
 from cheshirecat_python_sdk.endpoints.auth_handler import AuthHandlerEndpoint
 from cheshirecat_python_sdk.endpoints.chunker import ChunkerEndpoint

cheshirecat_python_sdk/endpoints/admins.py

@@ -1,8 +1,5 @@
-from typing import List
-
 from cheshirecat_python_sdk.endpoints.base import AbstractEndpoint, MultipartPayload
 from cheshirecat_python_sdk.models.api.admins import (
-    AdminOutput,
     PluginInstallOutput,
     PluginInstallFromRegistryOutput,
     PluginDetailsOutput,
@@ -10,89 +7,13 @@ from cheshirecat_python_sdk.models.api.admins import (
 )
 from cheshirecat_python_sdk.models.api.nested.plugins import PluginSettingsOutput
 from cheshirecat_python_sdk.models.api.plugins import PluginCollectionOutput, PluginsSettingsOutput, PluginToggleOutput
-from cheshirecat_python_sdk.utils import deserialize, file_attributes
+from cheshirecat_python_sdk.utils import file_attributes
 
 
 class AdminsEndpoint(AbstractEndpoint):
     def __init__(self, client: "CheshireCatClient"):
         super().__init__(client)
-        self.prefix = "/admins"
-
-    def post_admin(self, username: str, password: str, permissions: dict | None = None) -> AdminOutput:
-        """
-        Create a new admin user.
-        :param username: The username of the user.
-        :param password: The password of the user.
-        :param permissions: The permissions of the user.
-        :return: AdminOutput, the details of the user.
-        """
-        payload = {"username": username, "password": password}
-        if permissions:
-            payload["permissions"] = permissions  # type: ignore
-
-        return self.post_json(self.format_url("/users"), self.system_id, output_class=AdminOutput, payload=payload)
-
-    def get_admins(self, limit: int | None = None, skip: int | None = None) -> List[AdminOutput]:
-        """
-        Get a list of all admin users.
-        :param limit: The maximum number of users to return.
-        :param skip: The number of users to skip.
-        :return: List[AdminOutput], the details
-        """
-        query = {}
-        if limit:
-            query["limit"] = limit
-        if skip:
-            query["skip"] = skip
-
-        response = self.get_http_client(self.system_id).get(self.format_url("/users"), params=query)
-        response.raise_for_status()
-
-        result = []
-        for item in response.json():
-            result.append(deserialize(item, AdminOutput))
-        return result
-
-    def get_admin(self, admin_id: str) -> AdminOutput:
-        """
-        Get the details of an admin user.
-        :param admin_id: The ID of the user.
-        :return: AdminOutput, the details of the user.
-        """
-        return self.get(self.format_url(f"/users/{admin_id}"), self.system_id, output_class=AdminOutput)
-
-    def put_admin(
-        self,
-        admin_id: str,
-        username: str | None = None,
-        password: str | None = None,
-        permissions: dict | None = None,
-    ) -> AdminOutput:
-        """
-        Update the details of an admin user.
-        :param admin_id: The ID of the user.
-        :param username: The new username.
-        :param password: The new password.
-        :param permissions: The new permissions.
-        :return: AdminOutput, the details of the user.
-        """
-        payload = {}
-        if username:
-            payload["username"] = username
-        if password:
-            payload["password"] = password
-        if permissions:
-            payload["permissions"] = permissions
-
-        return self.put(self.format_url(f"/users/{admin_id}"), self.system_id, output_class=AdminOutput, payload=payload)
-
-    def delete_admin(self, admin_id: str) -> AdminOutput:
-        """
-        Delete an admin user.
-        :param admin_id: The ID of the user.
-        :return: AdminOutput, the details of the user.
-        """
-        return self.delete(self.format_url(f"/users/{admin_id}"), self.system_id, output_class=AdminOutput)
+        self.prefix = "/plugins"
 
     def get_available_plugins(self, plugin_name: str | None = None) -> PluginCollectionOutput:
         """
@@ -101,7 +22,7 @@ class AdminsEndpoint(AbstractEndpoint):
         :return: PluginCollectionOutput, the details of the plugins.
         """
         return self.get(
-            self.format_url("/plugins"),
+            self.format_url("/installed"),
             self.system_id,
             output_class=PluginCollectionOutput,
             query={"query": plugin_name} if plugin_name else None,
@@ -113,7 +34,7 @@ class AdminsEndpoint(AbstractEndpoint):
         with open(path_zip, "rb") as file:
             payload.files = [("file", file_attributes(path_zip, file))]
             result = self.post_multipart(
-                self.format_url("/plugins/upload"),
+                self.format_url("/install/upload"),
                 self.system_id,
                 output_class=PluginInstallOutput,
                 payload=payload,
@@ -127,7 +48,7 @@ class AdminsEndpoint(AbstractEndpoint):
         :return: PluginInstallFromRegistryOutput, the details of the installation.
         """
         return self.post_json(
-            self.format_url("/plugins/upload/registry"),
+            self.format_url("/install/registry"),
             self.system_id,
             output_class=PluginInstallFromRegistryOutput,
             payload={"url": url},
@@ -138,7 +59,7 @@ class AdminsEndpoint(AbstractEndpoint):
         Get the default settings of all the plugins.
         :return: PluginsSettingsOutput, the details of the settings.
         """
-        return self.get(self.format_url("/plugins/settings"), self.system_id, output_class=PluginsSettingsOutput)
+        return self.get(self.format_url("/system/settings"), self.system_id, output_class=PluginsSettingsOutput)
 
     def get_plugin_settings(self, plugin_id: str) -> PluginSettingsOutput:
         """
@@ -147,7 +68,7 @@ class AdminsEndpoint(AbstractEndpoint):
         :return: PluginSettingsOutput, the details of the settings.
         """
         return self.get(
-            self.format_url(f"/plugins/settings/{plugin_id}"), self.system_id, output_class=PluginSettingsOutput
+            self.format_url(f"/system/settings/{plugin_id}"), self.system_id, output_class=PluginSettingsOutput
         )
 
     def get_plugin_details(self, plugin_id: str) -> PluginDetailsOutput:
@@ -156,7 +77,7 @@ class AdminsEndpoint(AbstractEndpoint):
         :param plugin_id: The ID of the plugin.
         :return: PluginDetailsOutput, the details of the plugin.
         """
-        return self.get(self.format_url(f"/plugins/{plugin_id}"), self.system_id, output_class=PluginDetailsOutput)
+        return self.get(self.format_url(f"/system/details/{plugin_id}"), self.system_id, output_class=PluginDetailsOutput)
 
     def delete_plugin(self, plugin_id: str) -> PluginDeleteOutput:
         """
@@ -164,7 +85,7 @@ class AdminsEndpoint(AbstractEndpoint):
         :param plugin_id: The ID of the plugin.
         :return: PluginDeleteOutput, the details of the plugin.
         """
-        return self.delete(self.format_url(f"/plugins/{plugin_id}"), self.system_id, output_class=PluginDeleteOutput)
+        return self.delete(self.format_url(f"/uninstall/{plugin_id}"), self.system_id, output_class=PluginDeleteOutput)
 
     def put_toggle_plugin(self, plugin_id: str) -> PluginToggleOutput:
         """
@@ -173,7 +94,7 @@ class AdminsEndpoint(AbstractEndpoint):
         :return: PluginToggleOutput, the toggled plugin
         """
         return self.put(
-            self.format_url(f"/plugins/toggle/{plugin_id}"),
+            self.format_url(f"/system/toggle/{plugin_id}"),
             self.system_id,
             output_class=PluginToggleOutput,
         )

cheshirecat_python_sdk/endpoints/agentic_workflow.py

@@ -0,0 +1,52 @@
+from typing import Dict, Any
+
+from cheshirecat_python_sdk.endpoints.base import AbstractEndpoint
+from cheshirecat_python_sdk.models.api.factories import FactoryObjectSettingsOutput, FactoryObjectSettingOutput
+
+
+class AgenticWorkflowEndpoint(AbstractEndpoint):
+    def __init__(self, client: "CheshireCatClient"):
+        super().__init__(client)
+        self.prefix = "/agentic_workflow"
+
+    def get_agentic_workflows_settings(self, agent_id: str) -> FactoryObjectSettingsOutput:
+        """
+        Get all agentic workflow settings for the agent with the given ID.
+        :param agent_id: The ID of the agent.
+        :return: FactoryObjectSettingsOutput, containing the settings for all agentic workflows.
+        """
+        return self.get(
+            self.format_url("/settings"),
+            agent_id,
+            output_class=FactoryObjectSettingsOutput,
+        )
+
+    def get_agentic_workflow_settings(self, agentic_workflow: str, agent_id: str) -> FactoryObjectSettingOutput:
+        """
+        Get the settings for the agentic workflow with the given name.
+        :param agentic_workflow: The name of the agentic workflow.
+        :param agent_id: The ID of the agent.
+        :return: FactoryObjectSettingOutput, containing the settings for the agentic workflow.
+        """
+        return self.get(
+            self.format_url(f"/settings/{agentic_workflow}"),
+            agent_id,
+            output_class=FactoryObjectSettingOutput,
+        )
+
+    def put_agentic_workflow_settings(
+        self, agentic_workflow: str, agent_id: str, values: Dict[str, Any]
+    ) -> FactoryObjectSettingOutput:
+        """
+        Update the settings for the agentic workflow with the given name.
+        :param agentic_workflow: The name of the agentic workflow.
+        :param agent_id: The ID of the agent.
+        :param values: The new settings for the agentic workflow.
+        :return: FactoryObjectSettingOutput, containing the updated settings for the agentic workflow.
+        """
+        return self.put(
+            self.format_url(f"/settings/{agentic_workflow}"),
+            agent_id,
+            output_class=FactoryObjectSettingOutput,
+            payload=values,
+        )

cheshirecat_python_sdk/endpoints/base.py

@@ -43,12 +43,13 @@ class AbstractEndpoint(ABC):
         output_class: Type[T] | None = None,
         query: Dict[str, Any] | None = None,
         user_id: str | None = None,
+        chat_id: str | None = None,
     ) -> T:
         options = {}
         if query:
             options["params"] = query
 
-        response = self.get_http_client(agent_id, user_id).get(endpoint, **options)
+        response = self.get_http_client(agent_id, user_id, chat_id).get(endpoint, **options)
         response.raise_for_status()
 
         if output_class is None:
@@ -103,12 +104,13 @@ class AbstractEndpoint(ABC):
         output_class: Type[T] | None = None,
         payload: Dict[str, Any] | None = None,
         user_id: str | None = None,
+        chat_id: str | None = None,
     ) -> T:
         options = {}
         if payload:
             options["json"] = payload
 
-        response = self.get_http_client(agent_id, user_id).put(endpoint, **options)
+        response = self.get_http_client(agent_id, user_id, chat_id).put(endpoint, **options)
         response.raise_for_status()
 
         if output_class is None:
@@ -121,13 +123,14 @@ class AbstractEndpoint(ABC):
         agent_id: str,
         output_class: Type[T] | None = None,
         user_id: str | None = None,
+        chat_id: str | None = None,
         payload: Dict[str, Any] | None = None,
     ) -> T:
         options = {}
         if payload:
             options["json"] = payload
 
-        response = self.get_http_client(agent_id, user_id).delete(endpoint, **options)
+        response = self.get_http_client(agent_id, user_id, chat_id).delete(endpoint, **options)
         response.raise_for_status()
 
         if output_class is None:

cheshirecat_python_sdk/endpoints/file_manager.py

@@ -53,22 +53,24 @@ class FileManagerEndpoint(AbstractEndpoint):
             payload=values,
         )
 
-    def get_file_manager_attributes(self, agent_id: str) -> FileManagerAttributes:
+    def get_file_manager_attributes(self, agent_id: str, chat_id: str | None = None) -> FileManagerAttributes:
         """
         Get the attributes of the file manager for the agent specified by agent_id
         :param agent_id: The agent id
+        :param chat_id: The chat id, optional
         :return: FileManagerAttributes, the attributes of the file manager
         """
-        return self.get(self.prefix, agent_id, output_class=FileManagerAttributes)
+        return self.get(self.prefix, agent_id, output_class=FileManagerAttributes, chat_id=chat_id)
 
-    def get_file(self, agent_id: str, file_name: str) -> Response:
+    def get_file(self, agent_id: str, file_name: str, chat_id: str | None = None) -> Response:
         """
         Download a file from the file manager for the agent specified by agent_id
         :param agent_id: The agent id
         :param file_name: The name of the file to download
+        :param chat_id: The chat id, optional
         :return: Response, the response containing the file content
         """
-        response = self.get_http_client(agent_id).get(
+        response = self.get_http_client(agent_id, chat_id=chat_id).get(
             self.format_url(f"/files/{file_name}"),
             stream=True,
             headers={"Accept": "application/octet-stream"}
@@ -77,27 +79,31 @@ class FileManagerEndpoint(AbstractEndpoint):
 
         return response
 
-    def delete_file(self, agent_id: str, file_name: str) -> FileManagerDeletedFiles:
+    def delete_file(self, agent_id: str, file_name: str, chat_id: str | None = None) -> FileManagerDeletedFiles:
         """
         Download a file from the file manager for the agent specified by agent_id
         :param agent_id: The agent id
         :param file_name: The name of the file to delete
+        :param chat_id: The chat id, optional
         :return: FileManagerDeletedFiles, the response containing info about the deleted file
         """
         return self.delete(
             self.format_url(f"/files/{file_name}"),
             agent_id,
             output_class=FileManagerDeletedFiles,
+            chat_id=chat_id,
         )
 
-    def delete_files(self, agent_id: str) -> FileManagerDeletedFiles:
+    def delete_files(self, agent_id: str, chat_id: str | None = None) -> FileManagerDeletedFiles:
         """
         Download a file from the file manager for the agent specified by agent_id
         :param agent_id: The agent id
+        :param chat_id: The chat id, optional
         :return: bool, True if all files were deleted successfully
         """
         return self.delete(
             self.format_url("/files"),
             agent_id,
             output_class=FileManagerDeletedFiles,
+            chat_id=chat_id,
         )

cheshirecat_python_sdk/endpoints/memory.py

@@ -12,7 +12,7 @@ from cheshirecat_python_sdk.models.api.memories import (
     MemoryPointsOutput,
 )
 from cheshirecat_python_sdk.models.api.nested.memories import CollectionsItem
-from cheshirecat_python_sdk.models.dtos import Why, MemoryPoint
+from cheshirecat_python_sdk.models.dtos import Why, MemoryPoint, FilterSource
 
 
 class MemoryEndpoint(AbstractEndpoint):
@@ -85,6 +85,7 @@ class MemoryEndpoint(AbstractEndpoint):
         user_id: str,
         k: int | None = None,
         metadata: Dict[str, Any] | None = None,
+        chat_id: str | None = None,
     ) -> MemoryRecallOutput:
         """
         This endpoint retrieves memory points based on the input text. The text parameter is the input text for which
@@ -94,6 +95,7 @@ class MemoryEndpoint(AbstractEndpoint):
         :param user_id: The user ID to filter the memory points.
         :param k: The number of memory points to retrieve.
         :param metadata: The metadata to filter the memory points.
+        :param chat_id: The chat id, optional
         :return: MemoryRecallOutput, a list of memory points retrieved.
         """
         query = {"text": text}
@@ -108,6 +110,7 @@ class MemoryEndpoint(AbstractEndpoint):
             output_class=MemoryRecallOutput,
             user_id=user_id,
             query=query,
+            chat_id=chat_id,
         )
 
     def post_memory_point(
@@ -239,4 +242,31 @@ class MemoryEndpoint(AbstractEndpoint):
             query=query,
         )
 
+    def has_source(self, agent_id: str, filter_source: FilterSource, chat_id: str | None = None) -> bool:
+        """
+        Checks if the given filter source exists for a specified agent.
+
+        This method determines whether a specific source, defined by the given filter_source, is associated with the
+        provided agent in the memory database.
+        It optionally considers a specific chat ID when filtering the data. The result indicates the existence of such a
+        source.
+
+        Args:
+            agent_id: Unique identifier of the agent for which the check is performed.
+            filter_source: FilterSource object that defines the source or hash to check.
+            chat_id: An optional chat identifier to narrow the scope of the check. If not provided, the check will
+                operate in a broader context.
+
+        Returns:
+            A boolean value indicating whether the specified filter source exists in the agent's memory database.
+        """
+        metadata = {"source": filter_source.source} if filter_source.source else {"hash": filter_source.hash}
+        if chat_id:
+            metadata["chat_id"] = chat_id
+
+        collection_name = "declarative" if chat_id is None else "episodic"
+        points = self.get_memory_points(collection_name, agent_id, metadata=metadata)
+
+        return len(points.points) > 0
+
     # END Memory Points API

cheshirecat_python_sdk/endpoints/rabbit_hole.py

@@ -158,14 +158,16 @@ class RabbitHoleEndpoint(AbstractEndpoint):
             output_class=AllowedMimeTypesOutput
         )
 
-    def get_web_sources(self, agent_id: str) -> List[str]:
+    def get_web_sources(self, agent_id: str, chat_id: str | None = None) -> List[str]:
         """
         This method retrieves the web sources for the RabbitHole API. The web sources are the web URLs that are allowed
         to be uploaded to the RabbitHole API. The web sources are returned in a list.
         :param agent_id: The ID of the agent.
+        :param chat_id: The chat id, optional
         :return: List[str]
         """
         return self.get(
             self.format_url("/web"),
             agent_id,
+            chat_id=chat_id,
         )

cheshirecat_python_sdk/endpoints/users.py

@@ -11,7 +11,12 @@ class UsersEndpoint(AbstractEndpoint):
         self.prefix = "/users"
 
     def post_user(
-        self, agent_id: str, username: str, password: str, permissions: dict[str, Any] | None = None
+        self,
+        agent_id: str,
+        username: str,
+        password: str,
+        permissions: dict[str, Any] | None = None,
+        metadata: dict[str, Any] | None = None,
     ) -> UserOutput:
         """
         This endpoint is used to create a new user in the system. The user is created with the specified username and
@@ -22,6 +27,7 @@ class UsersEndpoint(AbstractEndpoint):
         :param username: The username of the user to create
         :param password: The password of the user to create
         :param permissions: The permissions of the user to create (optional)
+        :param metadata: The metadata of the user to create (optional)
         :return UserOutput, the created user
         """
         payload = {
@@ -31,6 +37,9 @@ class UsersEndpoint(AbstractEndpoint):
         if permissions is not None:
             payload["permissions"] = permissions  # type: ignore
 
+        if metadata is not None:
+            payload["metadata"] = metadata  # type: ignore
+
         return self.post_json(
             self.prefix,
             agent_id,
@@ -75,6 +84,7 @@ class UsersEndpoint(AbstractEndpoint):
         username: str | None = None,
         password: str | None = None,
         permissions: Dict[str, Any] | None = None,
+        metadata: Dict[str, Any] | None = None,
     ) -> UserOutput:
         """
         The endpoint is used to update the user in the system. The user is identified by the userId parameter, previously
@@ -87,6 +97,7 @@ class UsersEndpoint(AbstractEndpoint):
         :param username: The new username of the user (optional)
         :param password: The new password of the user (optional)
         :param permissions: The new permissions of the user (optional)
+        :param metadata: The new metadata of the user (optional)
         :return UserOutput, the updated user
         """
         payload = {}
@@ -96,6 +107,8 @@ class UsersEndpoint(AbstractEndpoint):
             payload["password"] = password
         if permissions is not None:
             payload["permissions"] = permissions
+        if metadata is not None:
+            payload["metadata"] = metadata
 
         return self.put(self.format_url(user_id), agent_id, output_class=UserOutput, payload=payload)
 

cheshirecat_python_sdk/models/api/admins.py

@@ -1,15 +1,9 @@
-from typing import Dict, List, Any
+from typing import Dict, Any
 from pydantic import BaseModel
 
 from cheshirecat_python_sdk.models.api.plugins import PluginToggleOutput
 
 
-class AdminOutput(BaseModel):
-    username: str
-    permissions: Dict[str, List[str]]
-    id: str
-
-
 class CreatedOutput(BaseModel):
     created: bool
 

cheshirecat_python_sdk/models/api/users.py

@@ -1,10 +1,11 @@
-from typing import Dict, List
+from typing import Dict, List, Any
 from pydantic import BaseModel
 
 
 class UserOutput(BaseModel):
     username: str
     permissions: Dict[str, List[str]]
+    metadata: Dict[str, Any] | None = None
     id: str
     created_at: float | None = None
     updated_at: float | None = None

cheshirecat_python_sdk/models/dtos.py

@@ -1,9 +1,5 @@
 from typing import Dict, List, Any
-from pydantic import BaseModel, Field
-
-
-class Memory(BaseModel):
-    declarative: List | None = Field(default_factory=list)
+from pydantic import BaseModel, Field, model_validator
 
 
 class MemoryPoint(BaseModel):
@@ -29,4 +25,14 @@ class SettingInput(BaseModel):
 class Why(BaseModel):
     input: str | None = None
     intermediate_steps: List | None = Field(default_factory=list)
-    memory: Memory = Field(default_factory=Memory)
+    memory: List | None = Field(default_factory=list)
+
+
+class FilterSource(BaseModel):
+    source: str | None = None
+    hash: str | None = None
+
+    @model_validator(mode="after")
+    def validate_source_or_hash(self):
+        assert self.source or self.hash, "Either source or hash must be provided"
+        return self

{cheshirecat_python_sdk-1.7.9.dist-info → cheshirecat_python_sdk-1.8.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cheshirecat-python-sdk
-Version: 1.7.9
+Version: 1.8.4
 Summary: Python SDK for the Cloud-ready fork of the Cheshire Cat
 Project-URL: Repository, https://github.com/matteocacciola/cheshirecat-python-sdk
 Project-URL: Documentation, https://github.com/matteocacciola/cheshirecat-python-sdk#README

{cheshirecat_python_sdk-1.7.9.dist-info → cheshirecat_python_sdk-1.8.4.dist-info}/RECORD

@@ -1,37 +1,38 @@
 cheshirecat_python_sdk/__init__.py,sha256=59esRUsh_6xPlfoCz-gQYQdDgp2xbaINYWyDcTJlvys,284
-cheshirecat_python_sdk/client.py,sha256=J8C8j9q-Lz3cGKyYbd9w19Ayh9muMa8s3N_gYpmLI-E,2839
+cheshirecat_python_sdk/client.py,sha256=J9sX8FxtE6bkwshDq5AHycG1bqHEOeqZlfr9g1mb13I,2960
 cheshirecat_python_sdk/configuration.py,sha256=7uXebZGzCuJdpgOeN5l1YXkWVIrTk4apxvjPKZFcJTE,283
 cheshirecat_python_sdk/enums.py,sha256=qJyhl5D_oDMHqNcIivr9pTxNrZY6XkX7lGgGydk22TY,665
 cheshirecat_python_sdk/utils.py,sha256=2pcSCREOuIAUi5El5ou2rCm-VtmzyGVd3YHcKrFHgBM,458
-cheshirecat_python_sdk/builders/__init__.py,sha256=sFzhmAPkKY2-9CGw5838S-2CMBosK4yCuTi9KmyetEo,223
+cheshirecat_python_sdk/builders/__init__.py,sha256=MEgXtw52hpQSTZ_EGOuS6WbbuXpIJGKmnYYImyoIM-s,208
 cheshirecat_python_sdk/builders/base.py,sha256=YyE0pLp2iYyIFQVD1hLDeR8Wg578ebzoEEEtX9G8KZw,216
-cheshirecat_python_sdk/builders/memory.py,sha256=vIoQADNZF51mMjPoJ-xW6DFWgUeAufiFXa-uDPb71A0,1088
+cheshirecat_python_sdk/builders/memory.py,sha256=UqznTdPcrcmWO1WqHcpQ0AoMe-ucWrViUjR6lsvzKEM,640
 cheshirecat_python_sdk/builders/settings_input.py,sha256=EvaCDmmYOtHWUwCgG-nWonkY6UF6g1blytBwAmH477I,762
-cheshirecat_python_sdk/builders/why.py,sha256=liwellCzZ6EyzWcL3lNgBy9SU76zAqGufxiaZ_o3ZT4,1008
+cheshirecat_python_sdk/builders/why.py,sha256=mz58CpjCm5nf7hDXhLqi9o5uRAaGbSHyM5v2pNTX2HU,993
 cheshirecat_python_sdk/clients/__init__.py,sha256=i4Hqux9vihFRbXVK48yJ1k9gm4JeCHnfPgosizQZv-g,135
 cheshirecat_python_sdk/clients/http_client.py,sha256=LnP0kr-kHRCwC-BZiysj1Zg-T3b3yuLd81wOctfcBTg,2319
 cheshirecat_python_sdk/clients/websocket_client.py,sha256=xNjkLSEZhpHzRqIZL21V0oG3srAGFaqYveMqlma2gvI,1932
-cheshirecat_python_sdk/endpoints/__init__.py,sha256=uQPclok3DdKTibR7ywDVM67eqtxEMwx_iuza37Wqkr8,1247
-cheshirecat_python_sdk/endpoints/admins.py,sha256=rc6jEhYF8KTTWFXLinm3xPV7Rj87iKT8Kp0zHn1qUO4,7024
+cheshirecat_python_sdk/endpoints/__init__.py,sha256=N8_vA7D304QCcaP-nhz039xkykRsBc-79COL_Ge19AY,1333
+cheshirecat_python_sdk/endpoints/admins.py,sha256=b4YpHO-Xqkd-PQxvQcXYAUmQkrTLTvEjf5R9pals-50,4116
+cheshirecat_python_sdk/endpoints/agentic_workflow.py,sha256=u0D9t7nGWcSPXUOeTmu1-madnWLlB7dlLP8hlP9yTJ4,2197
 cheshirecat_python_sdk/endpoints/auth.py,sha256=_22fLGznoxo2pybcQGgcsHCpLoq76P6RplmSMMgajEQ,2031
 cheshirecat_python_sdk/endpoints/auth_handler.py,sha256=Jfi7E7L3SIzJyECbJnUenIyl6xxkJlyC31AHpAlmqSs,2117
-cheshirecat_python_sdk/endpoints/base.py,sha256=W_ynJur_cbT31KLp6F4pJ212tMaAa1BxnG75YS1UgNU,4075
+cheshirecat_python_sdk/endpoints/base.py,sha256=0X2EQxRGqR6VG5gXE5XKcscmQ7rNM9de61GBrQlKD90,4210
 cheshirecat_python_sdk/endpoints/chunker.py,sha256=bgp-2gQpKt7W_B46eEb-KFRkd4eZJH0euwsf3N0jfC8,1979
 cheshirecat_python_sdk/endpoints/conversation.py,sha256=jG1z7ivdD53H8JZe7WZWihoBWy2_-W951SwKXmnpmTk,3282
 cheshirecat_python_sdk/endpoints/custom_endpoint.py,sha256=HVRQMqA5JfPr87gHtWpYcsXsE-TA-coXLcvsPKabqds,2791
 cheshirecat_python_sdk/endpoints/embedder.py,sha256=4B2yc3KBThKGreq_KPTTCsxt2Ekktw_muZ5gBfxrrwY,1741
-cheshirecat_python_sdk/endpoints/file_manager.py,sha256=qzMzvSt3eBYNb5VstQq8MdV1JC6QsUNOPrwb8yAR_OA,4226
+cheshirecat_python_sdk/endpoints/file_manager.py,sha256=U4kc2oR3UszK0EKzYnES_RkgF1zhaPINAW_3X2WgX7A,4614
 cheshirecat_python_sdk/endpoints/health_check.py,sha256=qv_5imbN39PqPyuBvlNoSqXqAvTvPv7UXI4zcfH8tlg,710
 cheshirecat_python_sdk/endpoints/large_language_model.py,sha256=SS787ZKMZQ7KQNvl7a7rfBCm6s1j3ifDfWQcrM4tn-k,2109
-cheshirecat_python_sdk/endpoints/memory.py,sha256=dEnQ2Hb_VG907p7T9oQgPCWWFHAUwkgwpVVJ1bLsWGw,8959
+cheshirecat_python_sdk/endpoints/memory.py,sha256=dgfoyjZH0gL3kln31gFJ42JHfL-S-oZHmEUzBmab3bw,10446
 cheshirecat_python_sdk/endpoints/message.py,sha256=QTUSUJcj52VhfnX9hdjsD2aLeFC43O4eU8ld5lRvITU,2607
 cheshirecat_python_sdk/endpoints/plugins.py,sha256=FasjwNY2UVv7zfg9lvXEj2ATefPDOPQpJXzQ2BbQIYI,3474
-cheshirecat_python_sdk/endpoints/rabbit_hole.py,sha256=DH5KGpk0Ur8RPi1fZIO9D925mc2D0GHQpsOeIKIa1G0,7213
-cheshirecat_python_sdk/endpoints/users.py,sha256=PXlPPobLoWpiuAzi0k89YUyqSp24Sc5DEcDQYGRXRBA,5369
+cheshirecat_python_sdk/endpoints/rabbit_hole.py,sha256=KjF5IRG6ghGEji-Js5try-9FhmWsuiM5v04jA68VoVY,7316
+cheshirecat_python_sdk/endpoints/users.py,sha256=ySpFi9ILyoT44fnAz8p4LSGTaEAMWv3RBWq72Hv73mI,5803
 cheshirecat_python_sdk/endpoints/utils.py,sha256=yKGrFRpu6ItLnBEuc98093LbXqGYaGdgCLiWuLQJVno,2551
 cheshirecat_python_sdk/endpoints/vector_database.py,sha256=Xu6zcopjZgcFVVmyN547piiqFcaTUtF35X0QxQHycXQ,2149
-cheshirecat_python_sdk/models/dtos.py,sha256=yK6CfCGdwLvZtYFPoImDEgpV5eyHB2iwji2t6dh6gxc,668
-cheshirecat_python_sdk/models/api/admins.py,sha256=K1HzZrjEk--rmBSxEg3cbWm2MVQaSxTheMBhhBr54_4,767
+cheshirecat_python_sdk/models/dtos.py,sha256=0N6Auv43Gifo0ptdZxMZXAB6QGk8NNbcf8vQGm8HClo,869
+cheshirecat_python_sdk/models/api/admins.py,sha256=sIX4NdEntjORgVACsqkBkzte4zwD6w35BdPRRG0D7uo,661
 cheshirecat_python_sdk/models/api/conversations.py,sha256=Ej8677MLBqZEME1lZFd4UhHokdja762zYNjV9ZaEg-I,505
 cheshirecat_python_sdk/models/api/factories.py,sha256=_NWz0nKhaVYEbaphxe2YZGznDIUiMKb-xqA1xymME5A,594
 cheshirecat_python_sdk/models/api/file_managers.py,sha256=V0ZBjQWmYM1t0Qpfp3W2NDI_tScOtORB0i5YMEpTiRU,301
@@ -40,10 +41,10 @@ cheshirecat_python_sdk/models/api/messages.py,sha256=PDojYuXUDXSek8nkg8QKoVdAJ2N
 cheshirecat_python_sdk/models/api/plugins.py,sha256=uX8SYbcTxQSxv1IaVChEBd3rr6kc83rwq3IILnmq5EE,1996
 cheshirecat_python_sdk/models/api/rabbit_holes.py,sha256=01FcPSIG6nq9WJhL_rQopLMSD81CU9lfP-t0xtf35Gw,285
 cheshirecat_python_sdk/models/api/tokens.py,sha256=GavSaCq0-SRWjvLtDgrYBOdUELd7VoVXlykmIBT23ds,455
-cheshirecat_python_sdk/models/api/users.py,sha256=WR6m_V_jn5YiWYSC_H4ybpooEtdMRQAbReakT4WJgWE,232
+cheshirecat_python_sdk/models/api/users.py,sha256=_T3-8hfmlZK9cZcqBTbNMYS74yEnDrRACRQn9PNCEiQ,280
 cheshirecat_python_sdk/models/api/nested/memories.py,sha256=ddGDsmZa2refElM0sGz9QfKHGk50wsTpkwN5qDC5bF4,946
 cheshirecat_python_sdk/models/api/nested/plugins.py,sha256=7vrwgXh0csaUn11YKY_OWnGEnD8Fu_ewKxt024VOBEs,738
-cheshirecat_python_sdk-1.7.9.dist-info/METADATA,sha256=pIDHH87QNazNr6DRVODRdOov4FDs5kofaCfby1QUOUA,44136
-cheshirecat_python_sdk-1.7.9.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-cheshirecat_python_sdk-1.7.9.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-cheshirecat_python_sdk-1.7.9.dist-info/RECORD,,
+cheshirecat_python_sdk-1.8.4.dist-info/METADATA,sha256=f5sjZkDGm4AXlxsMLbEjOEEgD2Pyke2NMqM7zi0Ag_4,44136
+cheshirecat_python_sdk-1.8.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+cheshirecat_python_sdk-1.8.4.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+cheshirecat_python_sdk-1.8.4.dist-info/RECORD,,