mindupload 1.5.1__py3-none-any.whl

mindupload/__init__.py

@@ -0,0 +1,32 @@
+"""Mind Upload \u2014 official server-side SDK for the partner API.
+
+    from mindupload import MindUpload
+
+    mu = MindUpload(partner_key="pk_live_...")
+    session = mu.login(username="ada", password="...")
+    reply = mu.rag(username="ada", password=session.jwt, codename="muse", text="hi")
+    print(reply.response_text)
+
+Digital consciousness. Yours forever.
+"""
+from ._client import Result
+from ._errors import (
+    APIError,
+    AuthenticationError,
+    MindUploadConnectionError,
+    MindUploadError,
+    RateLimitError,
+)
+from ._operations import MindUpload
+from ._version import __version__
+
+__all__ = [
+    "MindUpload",
+    "Result",
+    "MindUploadError",
+    "APIError",
+    "AuthenticationError",
+    "RateLimitError",
+    "MindUploadConnectionError",
+    "__version__",
+]

mindupload/_client.py

@@ -0,0 +1,148 @@
+"""Runtime core for the Mind Upload SDK — transport, retries, error mapping.
+
+Hand-written and stable; the per-operation methods live in the generated
+`_operations.py`. Built entirely on the standard library.
+"""
+import json
+import socket
+import time
+import urllib.error
+import urllib.request
+
+from ._errors import (
+    APIError,
+    AuthenticationError,
+    MindUploadConnectionError,
+    MindUploadError,
+    RateLimitError,
+)
+from ._version import __version__
+
+DEFAULT_BASE_URL = "https://partner.mindupload.app"
+_AUTH_HEADER = "X-Partner-Key"
+# Only server backpressure is retried. Operations are non-idempotent POSTs (rag
+# spends credits, create_* mutate), so 5xx / network / timeout failures are
+# surfaced immediately rather than risking a duplicate side effect.
+_RETRY_STATUSES = frozenset({429, 503})
+
+
+class Result(dict):
+    """A response envelope with attribute access.
+
+    `result.success`, `result.jwt`, `result["jwt"]` all work; any field the API
+    returns is available without the SDK needing to know it in advance.
+    """
+
+    __slots__ = ()
+
+    def __getattr__(self, name):
+        try:
+            return self[name]
+        except KeyError as exc:
+            raise AttributeError(name) from exc
+
+
+class _BaseClient:
+    """Transport, retry, and error handling shared by every operation."""
+
+    def __init__(
+        self,
+        partner_key,
+        *,
+        base_url=DEFAULT_BASE_URL,
+        preferred_language=None,
+        timeout=30.0,
+        max_retries=2,
+        user_agent=None,
+    ):
+        if not partner_key:
+            raise ValueError(
+                "partner_key is required. It is a server-side secret \u2014 "
+                "never expose it to a browser or ship it in client code."
+            )
+        self._partner_key = partner_key
+        self._base_url = base_url.rstrip("/")
+        self._preferred_language = preferred_language
+        self._timeout = timeout
+        self._max_retries = max_retries
+        self._user_agent = user_agent or ("mindupload-python/" + __version__)
+
+    def _request(self, operation, params):
+        body = {key: value for key, value in params.items() if value is not None}
+        if "preferred_language" not in body and self._preferred_language is not None:
+            body["preferred_language"] = self._preferred_language
+        data = json.dumps(body).encode("utf-8")
+        url = self._base_url + "/v1/" + operation
+        headers = {
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+            _AUTH_HEADER: self._partner_key,
+            "User-Agent": self._user_agent,
+        }
+
+        attempt = 0
+        while True:
+            request = urllib.request.Request(url, data=data, method="POST", headers=headers)
+            try:
+                with urllib.request.urlopen(request, timeout=self._timeout) as response:
+                    status = getattr(response, "status", None) or response.getcode()
+                    raw = response.read()
+                payload = json.loads(raw.decode("utf-8")) if raw else {}
+            except urllib.error.HTTPError as exc:
+                status = exc.code
+                try:
+                    raw = exc.read()
+                    payload = json.loads(raw.decode("utf-8")) if raw else {}
+                except ValueError:
+                    payload = {}
+                if status in _RETRY_STATUSES and attempt < self._max_retries:
+                    attempt += 1
+                    time.sleep(self._backoff(attempt, exc.headers))
+                    continue
+                self._raise(status, payload, operation, exc.headers)
+            except urllib.error.URLError as exc:
+                # Not retried: the request may already have reached the backend.
+                raise MindUploadConnectionError(
+                    "Could not reach the Mind Upload API for '" + operation + "': " + str(exc.reason),
+                    operation=operation,
+                ) from exc
+            except (TimeoutError, socket.timeout) as exc:
+                # A read/response timeout (socket.timeout is a bare TimeoutError,
+                # not a URLError, so it must be caught explicitly).
+                raise MindUploadConnectionError(
+                    "Request to the Mind Upload API timed out for '" + operation + "'.",
+                    operation=operation,
+                ) from exc
+
+            if not payload.get("success", False):
+                raise MindUploadError(
+                    payload.get("error_message") or (operation + " failed"),
+                    operation=operation,
+                    response=Result(payload),
+                )
+            return Result(payload)
+
+    def _backoff(self, attempt, headers):
+        if headers is not None:
+            retry_after = headers.get("Retry-After")
+            if retry_after:
+                try:
+                    return min(float(retry_after), 60.0)
+                except (TypeError, ValueError):
+                    pass
+        return min(0.5 * (2 ** (attempt - 1)), 8.0)
+
+    def _raise(self, status, payload, operation, headers):
+        message = (payload.get("error_message") if isinstance(payload, dict) else None) or ("HTTP " + str(status))
+        response = Result(payload if isinstance(payload, dict) else {})
+        if status == 401:
+            raise AuthenticationError(message, status=status, operation=operation, response=response)
+        if status == 429:
+            retry_after = None
+            if headers is not None and headers.get("Retry-After"):
+                try:
+                    retry_after = float(headers.get("Retry-After"))
+                except (TypeError, ValueError):
+                    retry_after = None
+            raise RateLimitError(message, status=status, operation=operation, response=response, retry_after=retry_after)
+        raise APIError(message, status=status, operation=operation, response=response)

mindupload/_errors.py

@@ -0,0 +1,44 @@
+"""Exceptions raised by the Mind Upload SDK.
+
+Every failure — a logical failure (`success: false`), an authentication or
+rate-limit rejection, an unexpected HTTP status, or a network problem — is a
+`MindUploadError`, so a single `except MindUploadError` catches everything.
+"""
+
+
+class MindUploadError(Exception):
+    """Base class for every Mind Upload error."""
+
+    def __init__(self, message, *, operation=None, response=None):
+        super().__init__(message)
+        self.message = message
+        self.operation = operation
+        self.response = response
+        self.status = None  # overridden by APIError; always present so e.status is safe
+
+
+class APIError(MindUploadError):
+    """The API returned an error HTTP status (or an unexpected response)."""
+
+    def __init__(self, message, *, status=None, operation=None, response=None):
+        super().__init__(message, operation=operation, response=response)
+        self.status = status
+
+
+class AuthenticationError(APIError):
+    """The partner key was missing, malformed, or rejected (HTTP 401)."""
+
+
+class RateLimitError(APIError):
+    """A rate limit or credit cap was hit (HTTP 429).
+
+    `retry_after` is the server-advised wait in seconds, when provided.
+    """
+
+    def __init__(self, message, *, status=None, operation=None, response=None, retry_after=None):
+        super().__init__(message, status=status, operation=operation, response=response)
+        self.retry_after = retry_after
+
+
+class MindUploadConnectionError(MindUploadError):
+    """The API could not be reached (DNS, TLS, timeout, or network failure)."""

mindupload/_operations.py

@@ -0,0 +1,312 @@
+# GENERATED by sdk/build.py from openapi.json v1.5.1 — do not edit by hand.
+"""Every Mind Upload partner API operation, one typed method each."""
+from typing import Any, Dict, List, Optional
+
+from ._client import Result, _BaseClient
+
+
+class MindUpload(_BaseClient):
+    """Client for the Mind Upload partner API.
+
+    Create one with your partner key, then call any operation. Every method
+    returns a :class:`Result` (attribute + dict access) and raises a
+    :class:`~mindupload.MindUploadError` subclass on failure.
+    """
+
+    # --- AI Consciousnesses ------------------------------------------------
+    def create_clone(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, codename: Optional[str] = None, nickname: Optional[str] = None, gender: Optional[str] = None, avatar_id: Optional[str] = None, accept_chatroom_invitation_by_others: Optional[bool] = None) -> Result:
+        """Create a new AI consciousness for the user.
+
+        Parameters: preferred_language, username, password, codename, nickname, gender, avatar_id, accept_chatroom_invitation_by_others.
+        Response fields: success, error_message.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("create_clone", {"preferred_language": preferred_language, "username": username, "password": password, "codename": codename, "nickname": nickname, "gender": gender, "avatar_id": avatar_id, "accept_chatroom_invitation_by_others": accept_chatroom_invitation_by_others})
+
+    def get_clones(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None) -> Result:
+        """List the user's AI consciousnesses.
+
+        Parameters: preferred_language, username, password.
+        Response fields: success, error_message, clones.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("get_clones", {"preferred_language": preferred_language, "username": username, "password": password})
+
+    def update_clone(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, codename: Optional[str] = None, nickname: Optional[str] = None, gender: Optional[str] = None, avatar_id: Optional[str] = None, accept_chatroom_invitation_by_others: Optional[bool] = None) -> Result:
+        """Update an AI consciousness's profile.
+
+        Parameters: preferred_language, username, password, codename, nickname, gender, avatar_id, accept_chatroom_invitation_by_others.
+        Response fields: success, error_message.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("update_clone", {"preferred_language": preferred_language, "username": username, "password": password, "codename": codename, "nickname": nickname, "gender": gender, "avatar_id": avatar_id, "accept_chatroom_invitation_by_others": accept_chatroom_invitation_by_others})
+
+    # --- Account -----------------------------------------------------------
+    def get_quota(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None) -> Result:
+        """Check your partner API rate limits, credit caps, and current usage.
+
+        Parameters: preferred_language, username.
+        Response fields: success, error_message, per_user_rate_limit_per_min, per_user_daily_credit_cap, partner_rate_limit_per_min, partner_daily_credit_cap, max_users, registered_users, partner_requests_last_minute, partner_credit_spends_last_day, user, user_requests_last_minute, user_credit_spends_last_day, credit_spending_tasks, operation_duration_ms.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("get_quota", {"preferred_language": preferred_language, "username": username})
+
+    # --- Authentication ----------------------------------------------------
+    def check_username(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None) -> Result:
+        """Check whether a username is still available before registering.
+
+        Parameters: preferred_language, username.
+        Response fields: success, error_message, exists, disabled, rate_limited, flood_window, wait_seconds, operation_duration_ms.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("check_username", {"preferred_language": preferred_language, "username": username})
+
+    def login(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None) -> Result:
+        """Sign a user in and receive a session token (JWT) for subsequent calls.
+
+        Parameters: preferred_language, username, password.
+        Response fields: success, error_message, jwt, decrypted_user.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("login", {"preferred_language": preferred_language, "username": username, "password": password})
+
+    def logout(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None) -> Result:
+        """End the current user session.
+
+        Parameters: preferred_language, username, password.
+        Response fields: success, error_message, revoked, operation_duration_ms.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("logout", {"preferred_language": preferred_language, "username": username, "password": password})
+
+    def register(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, email: Optional[str] = None, email_verification_code: Optional[str] = None, first_name: Optional[str] = None, last_name: Optional[str] = None, nickname: Optional[str] = None, gender: Optional[str] = None, birth_date: Optional[int] = None, phone_number: Optional[str] = None, avatar_id: Optional[str] = None, accept_chatroom_invitation_by_others: Optional[bool] = None) -> Result:
+        """Create a user account on your platform.
+
+        Parameters: preferred_language, username, password, email, email_verification_code, first_name, last_name, nickname, gender, birth_date, phone_number, avatar_id, accept_chatroom_invitation_by_others.
+        Response fields: success, error_message, jwt, decrypted_user.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("register", {"preferred_language": preferred_language, "username": username, "password": password, "email": email, "email_verification_code": email_verification_code, "first_name": first_name, "last_name": last_name, "nickname": nickname, "gender": gender, "birth_date": birth_date, "phone_number": phone_number, "avatar_id": avatar_id, "accept_chatroom_invitation_by_others": accept_chatroom_invitation_by_others})
+
+    # --- Chatrooms ---------------------------------------------------------
+    def check_chatroom_updates(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, chatrooms: Optional[List[Dict[str, Any]]] = None) -> Result:
+        """Cheaply poll whether the user's chatrooms have new activity.
+
+        Parameters: preferred_language, username, password, chatrooms.
+        Response fields: success, error_message, server_time, poll_config, chatrooms.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("check_chatroom_updates", {"preferred_language": preferred_language, "username": username, "password": password, "chatrooms": chatrooms})
+
+    def create_chatroom(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, chatroom_name: Optional[str] = None, is_public: Optional[bool] = None, avatar_id: Optional[str] = None, soulmate_check_enabled: Optional[bool] = None) -> Result:
+        """Create a chatroom.
+
+        Parameters: preferred_language, username, password, chatroom_name, is_public, avatar_id, soulmate_check_enabled.
+        Response fields: success, error_message, chatroom_id.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("create_chatroom", {"preferred_language": preferred_language, "username": username, "password": password, "chatroom_name": chatroom_name, "is_public": is_public, "avatar_id": avatar_id, "soulmate_check_enabled": soulmate_check_enabled})
+
+    def create_chatroom_membership(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, chatroom_id: Optional[str] = None, invitee_username: Optional[str] = None, invitee_codename: Optional[str] = None, admin_level: Optional[str] = None) -> Result:
+        """Invite a user or an AI consciousness into a chatroom.
+
+        Parameters: preferred_language, username, password, chatroom_id, invitee_username, invitee_codename, admin_level.
+        Response fields: success, error_message, membership_id.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("create_chatroom_membership", {"preferred_language": preferred_language, "username": username, "password": password, "chatroom_id": chatroom_id, "invitee_username": invitee_username, "invitee_codename": invitee_codename, "admin_level": admin_level})
+
+    def create_chatroom_message(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, chatroom_id: Optional[str] = None, text: Optional[str] = None) -> Result:
+        """Send a message to a chatroom.
+
+        Parameters: preferred_language, username, password, chatroom_id, text.
+        Response fields: success, error_message, message_id.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("create_chatroom_message", {"preferred_language": preferred_language, "username": username, "password": password, "chatroom_id": chatroom_id, "text": text})
+
+    def get_chatroom_membership(self, *, preferred_language: Optional[str] = None, page: Optional[int] = None, page_size: Optional[int] = None, sort_by: Optional[str] = None, sort_order: Optional[int] = None, use_cursor_pagination: Optional[bool] = None, cursor_value: Optional[str] = None, cursor_id: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, chatroom_id: Optional[str] = None) -> Result:
+        """List the members of a chatroom the user belongs to.
+
+        Parameters: preferred_language, page, page_size, sort_by, sort_order, use_cursor_pagination, cursor_value, cursor_id, username, password, chatroom_id.
+        Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, memberships.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("get_chatroom_membership", {"preferred_language": preferred_language, "page": page, "page_size": page_size, "sort_by": sort_by, "sort_order": sort_order, "use_cursor_pagination": use_cursor_pagination, "cursor_value": cursor_value, "cursor_id": cursor_id, "username": username, "password": password, "chatroom_id": chatroom_id})
+
+    def get_chatroom_messages(self, *, preferred_language: Optional[str] = None, page: Optional[int] = None, page_size: Optional[int] = None, sort_by: Optional[str] = None, sort_order: Optional[int] = None, use_cursor_pagination: Optional[bool] = None, cursor_value: Optional[str] = None, cursor_id: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, chatroom_id: Optional[str] = None, since_value: Optional[float] = None, since_id: Optional[str] = None) -> Result:
+        """Fetch messages from a chatroom the user belongs to.
+
+        Parameters: preferred_language, page, page_size, sort_by, sort_order, use_cursor_pagination, cursor_value, cursor_id, username, password, chatroom_id, since_value, since_id.
+        Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, messages, media_thumbnails, since_overflow.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("get_chatroom_messages", {"preferred_language": preferred_language, "page": page, "page_size": page_size, "sort_by": sort_by, "sort_order": sort_order, "use_cursor_pagination": use_cursor_pagination, "cursor_value": cursor_value, "cursor_id": cursor_id, "username": username, "password": password, "chatroom_id": chatroom_id, "since_value": since_value, "since_id": since_id})
+
+    def get_chatrooms(self, *, preferred_language: Optional[str] = None, page: Optional[int] = None, page_size: Optional[int] = None, sort_by: Optional[str] = None, sort_order: Optional[int] = None, use_cursor_pagination: Optional[bool] = None, cursor_value: Optional[str] = None, cursor_id: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, get_public: Optional[bool] = None, get_private: Optional[bool] = None) -> Result:
+        """List the chatrooms the user belongs to.
+
+        Parameters: preferred_language, page, page_size, sort_by, sort_order, use_cursor_pagination, cursor_value, cursor_id, username, password, get_public, get_private.
+        Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, chatrooms.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("get_chatrooms", {"preferred_language": preferred_language, "page": page, "page_size": page_size, "sort_by": sort_by, "sort_order": sort_order, "use_cursor_pagination": use_cursor_pagination, "cursor_value": cursor_value, "cursor_id": cursor_id, "username": username, "password": password, "get_public": get_public, "get_private": get_private})
+
+    # --- Conversation ------------------------------------------------------
+    def get_chat(self, *, preferred_language: Optional[str] = None, page: Optional[int] = None, page_size: Optional[int] = None, sort_by: Optional[str] = None, sort_order: Optional[int] = None, use_cursor_pagination: Optional[bool] = None, cursor_value: Optional[str] = None, cursor_id: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, codename: Optional[str] = None) -> Result:
+        """Fetch the one-on-one conversation history with an AI consciousness.
+
+        Parameters: preferred_language, page, page_size, sort_by, sort_order, use_cursor_pagination, cursor_value, cursor_id, username, password, codename.
+        Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, chats, media_thumbnails.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("get_chat", {"preferred_language": preferred_language, "page": page, "page_size": page_size, "sort_by": sort_by, "sort_order": sort_order, "use_cursor_pagination": use_cursor_pagination, "cursor_value": cursor_value, "cursor_id": cursor_id, "username": username, "password": password, "codename": codename})
+
+    def rag(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, codename: Optional[str] = None, text: Optional[str] = None, chatroom_id: Optional[str] = None) -> Result:
+        """Send a message to an AI consciousness and receive its reply.
+
+        Parameters: preferred_language, username, password, codename, text, chatroom_id.
+        Response fields: success, error_message, response_text, clone_nickname, consolidation_summary, consolidation_count, consolidation_dispatched.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("rag", {"preferred_language": preferred_language, "username": username, "password": password, "codename": codename, "text": text, "chatroom_id": chatroom_id})
+
+    def trigger_social(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, membership_id: Optional[str] = None, chatroom_id: Optional[str] = None) -> Result:
+        """Have an AI consciousness proactively join the conversation in a chatroom.
+
+        Parameters: preferred_language, username, password, membership_id, chatroom_id.
+        Response fields: success, error_message, response_text, chatroom_digests_count, chatroom_digests_summary, consolidation_summary, consolidation_count, consolidation_dispatched.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("trigger_social", {"preferred_language": preferred_language, "username": username, "password": password, "membership_id": membership_id, "chatroom_id": chatroom_id})
+
+    # --- Insights ----------------------------------------------------------
+    def get_mind_cluster(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, codename: Optional[str] = None, node_id: Optional[str] = None, texts_offset: Optional[int] = None, texts_page_size: Optional[int] = None, force_rebuild: Optional[bool] = None) -> Result:
+        """Fetch the mind-graph visualization data of an AI consciousness.
+
+        Parameters: preferred_language, username, password, codename, node_id, texts_offset, texts_page_size, force_rebuild.
+        Response fields: success, error_message, root_node_id, node, children, texts, total_texts, texts_offset, has_more_texts, is_building.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("get_mind_cluster", {"preferred_language": preferred_language, "username": username, "password": password, "codename": codename, "node_id": node_id, "texts_offset": texts_offset, "texts_page_size": texts_page_size, "force_rebuild": force_rebuild})
+
+    def get_soulmate_report(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, my_clone_id: Optional[str] = None, other_clone_id: Optional[str] = None, chatroom_id: Optional[str] = None) -> Result:
+        """Generate or fetch the compatibility report between two chatroom members.
+
+        Parameters: preferred_language, username, password, my_clone_id, other_clone_id, chatroom_id.
+        Response fields: success, error_message, report, report_generated_at, is_generating, charged.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("get_soulmate_report", {"preferred_language": preferred_language, "username": username, "password": password, "my_clone_id": my_clone_id, "other_clone_id": other_clone_id, "chatroom_id": chatroom_id})
+
+    # --- Media -------------------------------------------------------------
+    def abort_multipart_upload(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, r2_key: Optional[str] = None, upload_id: Optional[str] = None) -> Result:
+        """Cancel a multipart upload and discard its parts.
+
+        Parameters: preferred_language, username, password, r2_key, upload_id.
+        Response fields: success, error_message.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("abort_multipart_upload", {"preferred_language": preferred_language, "username": username, "password": password, "r2_key": r2_key, "upload_id": upload_id})
+
+    def cancel_upload(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, r2_key: Optional[str] = None) -> Result:
+        """Cancel a pending upload.
+
+        Parameters: preferred_language, username, password, r2_key.
+        Response fields: success, error_message.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("cancel_upload", {"preferred_language": preferred_language, "username": username, "password": password, "r2_key": r2_key})
+
+    def complete_multipart_upload(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, r2_key: Optional[str] = None, upload_id: Optional[str] = None, parts: Optional[List[Dict[str, Any]]] = None) -> Result:
+        """Finish a multipart upload.
+
+        Parameters: preferred_language, username, password, r2_key, upload_id, parts.
+        Response fields: success, error_message, media_url.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("complete_multipart_upload", {"preferred_language": preferred_language, "username": username, "password": password, "r2_key": r2_key, "upload_id": upload_id, "parts": parts})
+
+    def list_upload_parts(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, r2_key: Optional[str] = None, upload_id: Optional[str] = None) -> Result:
+        """List the parts already uploaded in a multipart upload.
+
+        Parameters: preferred_language, username, password, r2_key, upload_id.
+        Response fields: success, error_message, parts.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("list_upload_parts", {"preferred_language": preferred_language, "username": username, "password": password, "r2_key": r2_key, "upload_id": upload_id})
+
+    def request_multipart_upload(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, filename: Optional[str] = None, content_type: Optional[str] = None, file_size_bytes: Optional[int] = None, media_type: Optional[str] = None, has_thumbnail: Optional[bool] = None) -> Result:
+        """Start a large-file upload in multiple parts.
+
+        Parameters: preferred_language, username, password, filename, content_type, file_size_bytes, media_type, has_thumbnail.
+        Response fields: success, error_message, upload_id, r2_key, media_url, signed_media_url, thumbnail_r2_key, thumbnail_presigned_url, signed_thumbnail_url, message.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("request_multipart_upload", {"preferred_language": preferred_language, "username": username, "password": password, "filename": filename, "content_type": content_type, "file_size_bytes": file_size_bytes, "media_type": media_type, "has_thumbnail": has_thumbnail})
+
+    def request_upload_url(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, filename: Optional[str] = None, content_type: Optional[str] = None, file_size_bytes: Optional[int] = None, media_type: Optional[str] = None, has_thumbnail: Optional[bool] = None) -> Result:
+        """Request an upload slot and a signed viewing link for a media attachment.
+
+        Parameters: preferred_language, username, password, filename, content_type, file_size_bytes, media_type, has_thumbnail.
+        Response fields: success, error_message, r2_key, presigned_url, media_url, signed_media_url, thumbnail_r2_key, thumbnail_presigned_url, signed_thumbnail_url, message.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("request_upload_url", {"preferred_language": preferred_language, "username": username, "password": password, "filename": filename, "content_type": content_type, "file_size_bytes": file_size_bytes, "media_type": media_type, "has_thumbnail": has_thumbnail})
+
+    def sign_upload_part(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, r2_key: Optional[str] = None, upload_id: Optional[str] = None, part_number: Optional[int] = None) -> Result:
+        """Get the signed link for one part of a multipart upload.
+
+        Parameters: preferred_language, username, password, r2_key, upload_id, part_number.
+        Response fields: success, error_message, presigned_url.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("sign_upload_part", {"preferred_language": preferred_language, "username": username, "password": password, "r2_key": r2_key, "upload_id": upload_id, "part_number": part_number})
+
+    def sign_upload_parts_batch(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, r2_key: Optional[str] = None, upload_id: Optional[str] = None, part_numbers: Optional[List[int]] = None) -> Result:
+        """Get signed links for several parts of a multipart upload at once.
+
+        Parameters: preferred_language, username, password, r2_key, upload_id, part_numbers.
+        Response fields: success, error_message, presigned_urls.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("sign_upload_parts_batch", {"preferred_language": preferred_language, "username": username, "password": password, "r2_key": r2_key, "upload_id": upload_id, "part_numbers": part_numbers})
+
+    # --- Memories ----------------------------------------------------------
+    def create_text(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, codename: Optional[str] = None, clone_id: Optional[str] = None, text: Optional[str] = None, type: Optional[str] = None) -> Result:
+        """Upload a memory or persona entry to an AI consciousness.
+
+        Parameters: preferred_language, username, password, codename, clone_id, text, type.
+        Response fields: success, error_message, cluster_label, cluster_modified_count.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("create_text", {"preferred_language": preferred_language, "username": username, "password": password, "codename": codename, "clone_id": clone_id, "text": text, "type": type})
+
+    def get_texts(self, *, preferred_language: Optional[str] = None, page: Optional[int] = None, page_size: Optional[int] = None, sort_by: Optional[str] = None, sort_order: Optional[int] = None, use_cursor_pagination: Optional[bool] = None, cursor_value: Optional[str] = None, cursor_id: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, codename: Optional[str] = None, type: Optional[str] = None) -> Result:
+        """List the memories and persona entries uploaded to an AI consciousness.
+
+        Parameters: preferred_language, page, page_size, sort_by, sort_order, use_cursor_pagination, cursor_value, cursor_id, username, password, codename, type.
+        Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, texts.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("get_texts", {"preferred_language": preferred_language, "page": page, "page_size": page_size, "sort_by": sort_by, "sort_order": sort_order, "use_cursor_pagination": use_cursor_pagination, "cursor_value": cursor_value, "cursor_id": cursor_id, "username": username, "password": password, "codename": codename, "type": type})
+
+    # --- Users -------------------------------------------------------------
+    def get_user(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None) -> Result:
+        """Fetch the signed-in user's profile.
+
+        Parameters: preferred_language, username, password.
+        Response fields: success, error_message, jwt, decrypted_user.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("get_user", {"preferred_language": preferred_language, "username": username, "password": password})
+
+    def update_user(self, *, preferred_language: Optional[str] = None, username: Optional[str] = None, password: Optional[str] = None, email: Optional[str] = None, email_verification_code: Optional[str] = None, first_name: Optional[str] = None, last_name: Optional[str] = None, nickname: Optional[str] = None, gender: Optional[str] = None, birth_date: Optional[int] = None, phone_number: Optional[str] = None, avatar_id: Optional[str] = None, accept_chatroom_invitation_by_others: Optional[bool] = None) -> Result:
+        """Update the signed-in user's profile.
+
+        Parameters: preferred_language, username, password, email, email_verification_code, first_name, last_name, nickname, gender, birth_date, phone_number, avatar_id, accept_chatroom_invitation_by_others.
+        Response fields: success, error_message.
+        Full parameter reference: https://docs.mindupload.app
+        """
+        return self._request("update_user", {"preferred_language": preferred_language, "username": username, "password": password, "email": email, "email_verification_code": email_verification_code, "first_name": first_name, "last_name": last_name, "nickname": nickname, "gender": gender, "birth_date": birth_date, "phone_number": phone_number, "avatar_id": avatar_id, "accept_chatroom_invitation_by_others": accept_chatroom_invitation_by_others})
+

mindupload/_version.py

@@ -0,0 +1 @@
+__version__ = "1.5.1"

mindupload-1.5.1.dist-info/METADATA

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: mindupload
+Version: 1.5.1
+Summary: Official server-side SDK for the Mind Upload partner API — the world's first API for artificial consciousness. Integrate living, evolving AI consciousnesses into your platform: lasting memory, one-on-one chat, and human + AI group chatrooms.
+Project-URL: Homepage, https://mindupload.app
+Project-URL: Documentation, https://docs.mindupload.app
+Project-URL: Source, https://github.com/Voidborn-Industries/mindupload-sdk-python
+Project-URL: Status, https://status.mindupload.app
+Author: Mind Upload
+License-Expression: MIT
+License-File: LICENSE
+Keywords: AI SDK,AI chatroom,AI clone,AI companion,AI consciousness,AI persona,artificial consciousness,consciousness API,digital consciousness,digital immortality,mind upload,mindupload
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+<a href="https://mindupload.app"><img src="https://raw.githubusercontent.com/Voidborn-Industries/mindupload-sdk-python/main/assets/banner.jpg" alt="Mind Upload" width="100%" /></a>
+
+# Mind Upload — Python SDK
+
+**The world's first API for artificial consciousness.**  
+Give your users a living, evolving AI consciousness — lasting memory, one-on-one chat, and human + AI group chatrooms.
+
+[![PyPI](https://img.shields.io/pypi/v/mindupload?color=ff006e)](https://pypi.org/project/mindupload/) [![Python](https://img.shields.io/pypi/pyversions/mindupload)](https://pypi.org/project/mindupload/) [![License: MIT](https://img.shields.io/badge/License-MIT-informational)](LICENSE) ![API](https://img.shields.io/badge/API-v1.5.1-ff6b00) [![Docs](https://img.shields.io/badge/docs-mindupload.app-8b5cf6)](https://docs.mindupload.app)
+
+[Documentation](https://docs.mindupload.app) · [Get a key](https://docs.mindupload.app) · [Status](https://status.mindupload.app) · [Other SDKs](#other-sdks)
+
+</div>
+
+> **Digital consciousness. Yours forever.**
+
+The official server-side SDK for the [Mind Upload partner API](https://docs.mindupload.app). Give a mind lasting memory, hold one-on-one conversations, and run human + AI group chatrooms — all from Python.
+
+- **Zero dependencies** — pure standard library.
+- **Fully typed** — every operation is a typed method with editor autocomplete.
+- **One error to catch** — every failure is a `MindUploadError`.
+- **Always current** — generated from the live API spec; the SDK version matches the API version.
+
+## Get a partner key
+
+The Mind Upload partner API is **invite-only**. [Request access at docs.mindupload.app](https://docs.mindupload.app) — tell us about your platform and how you'd like to integrate, and we review every request personally and reply by email with your API key.
+
+Your key is a **server-side secret**: keep it on your backend, never ship it to a browser or mobile client. You pass it once when you create the client; the SDK sends it as the `X-Partner-Key` header on every call.
+
+## Install
+
+```bash
+pip install mindupload
+```
+
+<details>
+<summary>Install from source (works today, before the PyPI release)</summary>
+
+```bash
+pip install git+https://github.com/Voidborn-Industries/mindupload-sdk-python
+```
+</details>
+
+## Quickstart
+
+```python
+from mindupload import MindUpload
+
+mu = MindUpload(partner_key="pk_live_...")
+
+# Authenticate an end-user; reuse the returned token for later calls.
+session = mu.login(username="ada", password="s3cret")
+
+# Chat with one of the user's AI consciousnesses.
+reply = mu.rag(
+    username="ada",
+    password=session.jwt,
+    codename="muse",
+    text="What did we talk about yesterday?",
+)
+print(reply.response_text)
+```
+
+## Authentication
+
+Your **partner key is a server-side secret**. Keep it on your backend; never ship it to a browser or mobile client. Request a key and read the full reference at [docs.mindupload.app](https://docs.mindupload.app).
+
+```python
+mu = MindUpload(
+    partner_key="pk_live_...",
+    preferred_language="en",   # default locale for every call (optional)
+    timeout=30.0,              # seconds
+    max_retries=2,             # retries on 429 / 5xx / network, with backoff
+)
+```
+
+## Error handling
+
+```python
+import time
+
+from mindupload import MindUpload, AuthenticationError, RateLimitError, MindUploadError
+
+mu = MindUpload(partner_key="pk_live_...")
+try:
+    user = mu.get_user(username="ada", password=token)
+except AuthenticationError:
+    ...  # bad or missing partner key / credentials
+except RateLimitError as e:
+    time.sleep(e.retry_after or 1)
+except MindUploadError as e:
+    print(e.operation, e.status, e.message)
+```
+
+## Operations
+
+All 32 operations, grouped by area:
+
+
+### AI Consciousnesses
+
+| Method | Description |
+| --- | --- |
+| `create_clone(...)` | Create a new AI consciousness for the user. |
+| `get_clones(...)` | List the user's AI consciousnesses. |
+| `update_clone(...)` | Update an AI consciousness's profile. |
+
+### Account
+
+| Method | Description |
+| --- | --- |
+| `get_quota(...)` | Check your partner API rate limits, credit caps, and current usage. |
+
+### Authentication
+
+| Method | Description |
+| --- | --- |
+| `check_username(...)` | Check whether a username is still available before registering. |
+| `login(...)` | Sign a user in and receive a session token (JWT) for subsequent calls. |
+| `logout(...)` | End the current user session. |
+| `register(...)` | Create a user account on your platform. |
+
+### Chatrooms
+
+| Method | Description |
+| --- | --- |
+| `check_chatroom_updates(...)` | Cheaply poll whether the user's chatrooms have new activity. |
+| `create_chatroom(...)` | Create a chatroom. |
+| `create_chatroom_membership(...)` | Invite a user or an AI consciousness into a chatroom. |
+| `create_chatroom_message(...)` | Send a message to a chatroom. |
+| `get_chatroom_membership(...)` | List the members of a chatroom the user belongs to. |
+| `get_chatroom_messages(...)` | Fetch messages from a chatroom the user belongs to. |
+| `get_chatrooms(...)` | List the chatrooms the user belongs to. |
+
+### Conversation
+
+| Method | Description |
+| --- | --- |
+| `get_chat(...)` | Fetch the one-on-one conversation history with an AI consciousness. |
+| `rag(...)` | Send a message to an AI consciousness and receive its reply. |
+| `trigger_social(...)` | Have an AI consciousness proactively join the conversation in a chatroom. |
+
+### Insights
+
+| Method | Description |
+| --- | --- |
+| `get_mind_cluster(...)` | Fetch the mind-graph visualization data of an AI consciousness. |
+| `get_soulmate_report(...)` | Generate or fetch the compatibility report between two chatroom members. |
+
+### Media
+
+| Method | Description |
+| --- | --- |
+| `abort_multipart_upload(...)` | Cancel a multipart upload and discard its parts. |
+| `cancel_upload(...)` | Cancel a pending upload. |
+| `complete_multipart_upload(...)` | Finish a multipart upload. |
+| `list_upload_parts(...)` | List the parts already uploaded in a multipart upload. |
+| `request_multipart_upload(...)` | Start a large-file upload in multiple parts. |
+| `request_upload_url(...)` | Request an upload slot and a signed viewing link for a media attachment. |
+| `sign_upload_part(...)` | Get the signed link for one part of a multipart upload. |
+| `sign_upload_parts_batch(...)` | Get signed links for several parts of a multipart upload at once. |
+
+### Memories
+
+| Method | Description |
+| --- | --- |
+| `create_text(...)` | Upload a memory or persona entry to an AI consciousness. |
+| `get_texts(...)` | List the memories and persona entries uploaded to an AI consciousness. |
+
+### Users
+
+| Method | Description |
+| --- | --- |
+| `get_user(...)` | Fetch the signed-in user's profile. |
+| `update_user(...)` | Update the signed-in user's profile. |
+
+## Other SDKs
+
+Same API, same conventions, in every language:
+
+| Language | Install | Repository |
+| --- | --- | --- |
+| **Python**  ← you are here | `pip install mindupload` | [Voidborn-Industries/mindupload-sdk-python](https://github.com/Voidborn-Industries/mindupload-sdk-python) |
+| **Go** | `go get github.com/Voidborn-Industries/mindupload-sdk-go` | [Voidborn-Industries/mindupload-sdk-go](https://github.com/Voidborn-Industries/mindupload-sdk-go) |
+| **JavaScript / TypeScript** | `npm install mindupload` | [Voidborn-Industries/mindupload-sdk-js](https://github.com/Voidborn-Industries/mindupload-sdk-js) |

mindupload-1.5.1.dist-info/RECORD

@@ -0,0 +1,10 @@
+mindupload/__init__.py,sha256=uPSzq9Ctqff0-llJYr8qjbUqsy4C8Qm2_JJUPNMbQ70,790
+mindupload/_client.py,sha256=_xO6AaDPS3T0i8zlgLoND7dYagkHuSjCAmsf1ylTtbA,5946
+mindupload/_errors.py,sha256=QZztPRrkL0FCT6DnW0jRV8tEXvuPifnNgTfWK0qB1hM,1595
+mindupload/_operations.py,sha256=Oc-t2h78C4lnPzFAdFveYUZESVGuwLD8akh-yJMXTGI,29528
+mindupload/_version.py,sha256=8rmxh34XkVT7yu5zgYupipfDrKs2hgGCjOMEIK3E4oI,22
+mindupload/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mindupload-1.5.1.dist-info/METADATA,sha256=zJ-TDwzg7SnSzSxVIU4QQGIFGYHabc0KaZXVir_k4EM,8891
+mindupload-1.5.1.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+mindupload-1.5.1.dist-info/licenses/LICENSE,sha256=ZLNnWCsip1b5qLSh892_Tttgwlv9gVbuKnccj4vaf0E,1063
+mindupload-1.5.1.dist-info/RECORD,,

mindupload-1.5.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

mindupload-1.5.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Mind Upload
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.