mindupload 1.9.6 → 1.10.0

package/README.md

@@ -7,7 +7,7 @@
 **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.
 
-[![npm](https://img.shields.io/npm/v/mindupload?color=ff006e)](https://www.npmjs.com/package/mindupload) [![License: MIT](https://img.shields.io/badge/License-MIT-informational)](LICENSE) ![API](https://img.shields.io/badge/API-v1.9.6-ff6b00) ![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen) [![Docs](https://img.shields.io/badge/docs-mindupload.app-8b5cf6)](https://docs.mindupload.app)
+[![npm](https://img.shields.io/npm/v/mindupload?color=ff006e)](https://www.npmjs.com/package/mindupload) [![License: MIT](https://img.shields.io/badge/License-MIT-informational)](LICENSE) ![API](https://img.shields.io/badge/API-v1.10.0-ff6b00) ![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen) [![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)
 
@@ -124,7 +124,7 @@ try {
 
 ## Operations
 
-All 40 operations, grouped by area:
+All 44 operations, grouped by area:
 
 ### AI Consciousnesses
 
@@ -159,7 +159,9 @@ All 40 operations, grouped by area:
 | `createChatroomMessage(...)` | Send a message to a chatroom. |
 | `getChatroomMembership(...)` | List the members of a chatroom the user belongs to. |
 | `getChatroomMessages(...)` | Fetch messages from a chatroom the user belongs to. |
+| `getChatroomMessagesAround(...)` | Fetch a window of chatroom messages around one message id (for jump-to). |
 | `getChatrooms(...)` | List the chatrooms the user belongs to. |
+| `searchChatroomMessages(...)` | Find messages in a chatroom by keyword, date, media type, and/or sender. |
 | `translateChatroomMessage(...)` | Translate a text chatroom message into the viewer language. |
 
 ### Conversation
@@ -167,7 +169,9 @@ All 40 operations, grouped by area:
 | Method | Description |
 | --- | --- |
 | `getChat(...)` | Fetch the one-on-one conversation history with an AI consciousness. |
+| `getChatAround(...)` | Fetch a window of one-on-one turns around one chat id (for jump-to). |
 | `rag(...)` | Send a message to an AI consciousness and receive its reply. |
+| `searchChats(...)` | Find turns in a one-on-one AI conversation by keyword, date, media type, and/or Human/AI side. |
 | `triggerSocial(...)` | Have an AI consciousness proactively join the conversation in a chatroom. |
 
 ### External Authorization

package/dist/index.cjs

@@ -75,7 +75,7 @@ var MindUploadConnectionError = class extends MindUploadError {
 };
 
 // src/version.ts
-var VERSION = "1.9.6";
+var VERSION = "1.10.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://partner.mindupload.app";
@@ -317,12 +317,20 @@ var MindUpload = class extends MindUploadBase {
   }
   /** Fetch messages from a chatroom the user belongs to.
    *
-   * 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.
+   * 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, media_fallbacks, since_overflow.
    * @see https://docs.mindupload.app
    */
   getChatroomMessages(params = {}) {
     return this.request("get_chatroom_messages", params);
   }
+  /** Fetch a window of chatroom messages around one message id (for jump-to).
+   *
+   * Response fields: success, error_message, messages, media_thumbnails, media_fallbacks, anchor_message_id.
+   * @see https://docs.mindupload.app
+   */
+  getChatroomMessagesAround(params) {
+    return this.request("get_chatroom_messages_around", params);
+  }
   /** List the chatrooms the user belongs to.
    *
    * Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, chatrooms.
@@ -331,6 +339,14 @@ var MindUpload = class extends MindUploadBase {
   getChatrooms(params = {}) {
     return this.request("get_chatrooms", params);
   }
+  /** Find messages in a chatroom by keyword, date, media type, and/or sender.
+   *
+   * Response fields: success, error_message, messages, media_thumbnails, media_fallbacks, has_next, next_cursor_value, next_cursor_id, page_size, media_urls_expire_at.
+   * @see https://docs.mindupload.app
+   */
+  searchChatroomMessages(params) {
+    return this.request("search_chatroom_messages", params);
+  }
   /** Translate a text chatroom message into the viewer language.
    *
    * Response fields: success, error_message, translated_text, target_language, cached.
@@ -342,12 +358,20 @@ var MindUpload = class extends MindUploadBase {
   // --- Conversation ---
   /** Fetch the one-on-one conversation history with an AI consciousness.
    *
-   * 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.
+   * 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, media_fallbacks.
    * @see https://docs.mindupload.app
    */
   getChat(params = {}) {
     return this.request("get_chat", params);
   }
+  /** Fetch a window of one-on-one turns around one chat id (for jump-to).
+   *
+   * Response fields: success, error_message, chats, media_thumbnails, media_fallbacks, anchor_chat_id.
+   * @see https://docs.mindupload.app
+   */
+  getChatAround(params) {
+    return this.request("get_chat_around", params);
+  }
   /** Send a message to an AI consciousness and receive its reply.
    *
    * Response fields: success, error_message, response_text, clone_nickname, consolidation_summary, consolidation_count, consolidation_dispatched.
@@ -356,6 +380,14 @@ var MindUpload = class extends MindUploadBase {
   rag(params = {}) {
     return this.request("rag", params);
   }
+  /** Find turns in a one-on-one AI conversation by keyword, date, media type, and/or Human/AI side.
+   *
+   * Response fields: success, error_message, chats, media_thumbnails, media_fallbacks, has_next, next_cursor_value, next_cursor_id, page_size, media_urls_expire_at.
+   * @see https://docs.mindupload.app
+   */
+  searchChats(params) {
+    return this.request("search_chats", params);
+  }
   /** Have an AI consciousness proactively join the conversation in a chatroom.
    *
    * Response fields: success, error_message, response_text, chatroom_digests_count, chatroom_digests_summary, consolidation_summary, consolidation_count, consolidation_dispatched.

package/dist/index.d.cts

@@ -173,11 +173,15 @@ interface GetChatroomMembershipParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
     page?: number;
+    /** Maximum records requested for one server-capped page. */
     pageSize?: number;
     sortBy?: string;
+    /** Sort direction; supported values depend on the operation. */
     sortOrder?: number;
     useCursorPagination?: boolean;
+    /** Opaque pagination cursor value from the previous page (`next_cursor_value`). */
     cursorValue?: string;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
     cursorId?: string;
     /** The end-user's username. */
     username?: string;
@@ -190,11 +194,15 @@ interface GetChatroomMessagesParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
     page?: number;
+    /** Maximum records requested for one server-capped page. */
     pageSize?: number;
     sortBy?: string;
+    /** Sort direction; supported values depend on the operation. */
     sortOrder?: number;
     useCursorPagination?: boolean;
+    /** Opaque pagination cursor value from the previous page (`next_cursor_value`). */
     cursorValue?: string;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
     cursorId?: string;
     /** The end-user's username. */
     username?: string;
@@ -205,15 +213,35 @@ interface GetChatroomMessagesParams {
     sinceValue?: number;
     sinceId?: string;
 }
+interface GetChatroomMessagesAroundParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    /** The end-user's username. */
+    username: string;
+    /** The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage. */
+    password: string;
+    /** Chatroom id as returned by chatroom operations. */
+    chatroomId: string;
+    /** Chatroom message id. */
+    messageId: string;
+    /** How many earlier neighbors to include around the anchor id. */
+    before?: number;
+    /** How many later neighbors to include around the anchor id. */
+    after?: number;
+}
 interface GetChatroomsParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
     page?: number;
+    /** Maximum records requested for one server-capped page. */
     pageSize?: number;
     sortBy?: string;
+    /** Sort direction; supported values depend on the operation. */
     sortOrder?: number;
     useCursorPagination?: boolean;
+    /** Opaque pagination cursor value from the previous page (`next_cursor_value`). */
     cursorValue?: string;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
     cursorId?: string;
     /** The end-user's username. */
     username?: string;
@@ -222,6 +250,36 @@ interface GetChatroomsParams {
     getPublic?: boolean;
     getPrivate?: boolean;
 }
+interface SearchChatroomMessagesParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    /** The end-user's username. */
+    username: string;
+    /** The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage. */
+    password: string;
+    /** Chatroom id as returned by chatroom operations. */
+    chatroomId: string;
+    /** Optional find query. Whole-word tokens across alphabetic and numeric scripts; character phrases for Chinese / Japanese / Korean; mixed language supported. */
+    keyword?: string;
+    /** Optional list of media kinds to match: `image`, `video`, and/or `audio`. */
+    contentMediaTypes?: Array<"image" | "video" | "audio">;
+    /** Optional lower bound on message time as a UNIX timestamp in seconds. */
+    createdAfter?: number;
+    /** Optional upper bound on message time as a UNIX timestamp in seconds. */
+    createdBefore?: number;
+    /** Message send-time order: `-1` newest first (default), `1` oldest first. */
+    sortOrder?: -1 | 1;
+    /** Optional human member id; only messages from that user match. Mutually exclusive with `sender_clone_id`. */
+    senderUserId?: string;
+    /** Optional AI member id; only messages from that AI match. Mutually exclusive with `sender_user_id`. */
+    senderCloneId?: string;
+    /** Maximum Find hits for one page. */
+    pageSize?: number;
+    /** Opaque pagination cursor value from the previous page (`next_cursor_value`). */
+    cursorValue?: number;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
+    cursorId?: string;
+}
 interface TranslateChatroomMessageParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
@@ -238,11 +296,15 @@ interface GetChatParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
     page?: number;
+    /** Maximum records requested for one server-capped page. */
     pageSize?: number;
     sortBy?: string;
+    /** Sort direction; supported values depend on the operation. */
     sortOrder?: number;
     useCursorPagination?: boolean;
+    /** Opaque pagination cursor value from the previous page (`next_cursor_value`). */
     cursorValue?: string;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
     cursorId?: string;
     /** The end-user's username. */
     username?: string;
@@ -250,6 +312,22 @@ interface GetChatParams {
     password?: string;
     codename?: string;
 }
+interface GetChatAroundParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    /** The end-user's username. */
+    username: string;
+    /** The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage. */
+    password: string;
+    /** Owner AI consciousness id from `get_clones` (required for one-on-one jump). */
+    cloneId: string;
+    /** One-on-one chat turn id. */
+    chatId: string;
+    /** How many earlier neighbors to include around the anchor id. */
+    before?: number;
+    /** How many later neighbors to include around the anchor id. */
+    after?: number;
+}
 interface RagParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
@@ -262,6 +340,34 @@ interface RagParams {
     /** Chatroom id as returned by chatroom operations. */
     chatroomId?: string;
 }
+interface SearchChatsParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    /** The end-user's username. */
+    username: string;
+    /** The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage. */
+    password: string;
+    /** Owner AI consciousness id from `get_clones` (required for one-on-one find). */
+    cloneId: string;
+    /** Optional find query. Whole-word tokens across alphabetic and numeric scripts; character phrases for Chinese / Japanese / Korean; mixed language supported. */
+    keyword?: string;
+    /** Optional list of media kinds to match: `image`, `video`, and/or `audio`. */
+    contentMediaTypes?: Array<"image" | "video" | "audio">;
+    /** Optional lower bound on message time as a UNIX timestamp in seconds. */
+    createdAfter?: number;
+    /** Optional upper bound on message time as a UNIX timestamp in seconds. */
+    createdBefore?: number;
+    /** Turn send-time order: `-1` newest first (default), `1` oldest first. */
+    sortOrder?: -1 | 1;
+    /** Optional 1v1 side filter: `user` (human), `assistant` (AI), or `both` (turns that include both sides). */
+    side?: "user" | "assistant" | "both";
+    /** Maximum Find hits for one page. */
+    pageSize?: number;
+    /** Opaque pagination cursor value from the previous page (`next_cursor_value`). */
+    cursorValue?: number;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
+    cursorId?: string;
+}
 interface TriggerSocialParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
@@ -310,6 +416,7 @@ interface InvokeExternalCloneParams {
     installationId: string;
     /** Your stable opaque identifier for the person authorizing this installation. */
     externalSubject: string;
+    /** AI consciousness id as returned by clone operations. */
     cloneId: string;
     text: string;
     /** A stable opaque event key that makes exact retries return the same outcome. */
@@ -344,6 +451,7 @@ interface UploadExternalMindDataParams {
     installationId: string;
     /** Your stable opaque identifier for the person authorizing this installation. */
     externalSubject: string;
+    /** AI consciousness id as returned by clone operations. */
     cloneId: string;
     text: string;
     textType?: string;
@@ -486,6 +594,7 @@ interface CreateTextParams {
     /** The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage. */
     password?: string;
     codename?: string;
+    /** AI consciousness id as returned by clone operations. */
     cloneId?: string;
     text?: string;
     type?: string;
@@ -494,11 +603,15 @@ interface GetTextsParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
     page?: number;
+    /** Maximum records requested for one server-capped page. */
     pageSize?: number;
     sortBy?: string;
+    /** Sort direction; supported values depend on the operation. */
     sortOrder?: number;
     useCursorPagination?: boolean;
+    /** Opaque pagination cursor value from the previous page (`next_cursor_value`). */
     cursorValue?: string;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
     cursorId?: string;
     /** The end-user's username. */
     username?: string;
@@ -511,11 +624,15 @@ interface GetTransactionHistoryParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
     page?: number;
+    /** Maximum records requested for one server-capped page. */
     pageSize?: number;
     sortBy?: string;
+    /** Sort direction; supported values depend on the operation. */
     sortOrder?: number;
     useCursorPagination?: boolean;
+    /** Opaque pagination cursor value from the previous page (`next_cursor_value`). */
     cursorValue?: string;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
     cursorId?: string;
     /** The end-user's username. */
     username?: string;
@@ -635,16 +752,28 @@ declare class MindUpload extends MindUploadBase {
     getChatroomMembership(params?: GetChatroomMembershipParams): Promise<Result>;
     /** Fetch messages from a chatroom the user belongs to.
      *
-     * 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.
+     * 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, media_fallbacks, since_overflow.
      * @see https://docs.mindupload.app
      */
     getChatroomMessages(params?: GetChatroomMessagesParams): Promise<Result>;
+    /** Fetch a window of chatroom messages around one message id (for jump-to).
+     *
+     * Response fields: success, error_message, messages, media_thumbnails, media_fallbacks, anchor_message_id.
+     * @see https://docs.mindupload.app
+     */
+    getChatroomMessagesAround(params: GetChatroomMessagesAroundParams): Promise<Result>;
     /** List the chatrooms the user belongs to.
      *
      * Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, chatrooms.
      * @see https://docs.mindupload.app
      */
     getChatrooms(params?: GetChatroomsParams): Promise<Result>;
+    /** Find messages in a chatroom by keyword, date, media type, and/or sender.
+     *
+     * Response fields: success, error_message, messages, media_thumbnails, media_fallbacks, has_next, next_cursor_value, next_cursor_id, page_size, media_urls_expire_at.
+     * @see https://docs.mindupload.app
+     */
+    searchChatroomMessages(params: SearchChatroomMessagesParams): Promise<Result>;
     /** Translate a text chatroom message into the viewer language.
      *
      * Response fields: success, error_message, translated_text, target_language, cached.
@@ -653,16 +782,28 @@ declare class MindUpload extends MindUploadBase {
     translateChatroomMessage(params?: TranslateChatroomMessageParams): Promise<Result>;
     /** Fetch the one-on-one conversation history with an AI consciousness.
      *
-     * 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.
+     * 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, media_fallbacks.
      * @see https://docs.mindupload.app
      */
     getChat(params?: GetChatParams): Promise<Result>;
+    /** Fetch a window of one-on-one turns around one chat id (for jump-to).
+     *
+     * Response fields: success, error_message, chats, media_thumbnails, media_fallbacks, anchor_chat_id.
+     * @see https://docs.mindupload.app
+     */
+    getChatAround(params: GetChatAroundParams): Promise<Result>;
     /** Send a message to an AI consciousness and receive its reply.
      *
      * Response fields: success, error_message, response_text, clone_nickname, consolidation_summary, consolidation_count, consolidation_dispatched.
      * @see https://docs.mindupload.app
      */
     rag(params?: RagParams): Promise<Result>;
+    /** Find turns in a one-on-one AI conversation by keyword, date, media type, and/or Human/AI side.
+     *
+     * Response fields: success, error_message, chats, media_thumbnails, media_fallbacks, has_next, next_cursor_value, next_cursor_id, page_size, media_urls_expire_at.
+     * @see https://docs.mindupload.app
+     */
+    searchChats(params: SearchChatsParams): Promise<Result>;
     /** Have an AI consciousness proactively join the conversation in a chatroom.
      *
      * Response fields: success, error_message, response_text, chatroom_digests_count, chatroom_digests_summary, consolidation_summary, consolidation_count, consolidation_dispatched.
@@ -845,6 +986,6 @@ declare class MindUploadConnectionError extends MindUploadError {
     constructor(message: string, options?: ErrorOptions);
 }
 
-declare const VERSION = "1.9.6";
+declare const VERSION = "1.10.0";
 
-export { type AbortMultipartUploadParams, ApiError, type ApiErrorOptions, AuthenticationError, type CancelUploadParams, type CheckChatroomUpdatesParams, type CheckUsernameParams, type ClientOptions, type CompleteMultipartUploadParams, type CreateChatroomMembershipParams, type CreateChatroomMessageParams, type CreateChatroomParams, type CreateCloneParams, type CreateExternalAuthorizationRequestParams, type CreateTextParams, DEFAULT_BASE_URL, type ErrorOptions, type ExchangeExternalAuthorizationParams, type ExternalAuthorizationStatus, type GetChatParams, type GetChatroomMembershipParams, type GetChatroomMessagesParams, type GetChatroomsParams, type GetClonesParams, type GetMindClusterParams, type GetQuotaParams, type GetSoulmateReportParams, type GetTextsParams, type GetTransactionHistoryParams, type GetUserParams, type InspectExternalAuthorizationParams, type InvokeExternalCloneParams, type ListUploadPartsParams, type LoginParams, type LogoutParams, MindUpload, MindUploadBase, MindUploadConnectionError, MindUploadError, type RagParams, RateLimitError, type RateLimitOptions, type RefreshExternalAuthorizationParams, type RegisterParams, type RequestMultipartUploadParams, type RequestUploadUrlParams, type Result, type SignUploadPartParams, type SignUploadPartsBatchParams, type TranslateChatroomMessageParams, type TriggerSocialParams, type UpdateCloneParams, type UpdateUserParams, type UploadExternalMindDataParams, VERSION, type WaitForExternalAuthorizationParams, type WaitForExternalCloneInvocationParams };
+export { type AbortMultipartUploadParams, ApiError, type ApiErrorOptions, AuthenticationError, type CancelUploadParams, type CheckChatroomUpdatesParams, type CheckUsernameParams, type ClientOptions, type CompleteMultipartUploadParams, type CreateChatroomMembershipParams, type CreateChatroomMessageParams, type CreateChatroomParams, type CreateCloneParams, type CreateExternalAuthorizationRequestParams, type CreateTextParams, DEFAULT_BASE_URL, type ErrorOptions, type ExchangeExternalAuthorizationParams, type ExternalAuthorizationStatus, type GetChatAroundParams, type GetChatParams, type GetChatroomMembershipParams, type GetChatroomMessagesAroundParams, type GetChatroomMessagesParams, type GetChatroomsParams, type GetClonesParams, type GetMindClusterParams, type GetQuotaParams, type GetSoulmateReportParams, type GetTextsParams, type GetTransactionHistoryParams, type GetUserParams, type InspectExternalAuthorizationParams, type InvokeExternalCloneParams, type ListUploadPartsParams, type LoginParams, type LogoutParams, MindUpload, MindUploadBase, MindUploadConnectionError, MindUploadError, type RagParams, RateLimitError, type RateLimitOptions, type RefreshExternalAuthorizationParams, type RegisterParams, type RequestMultipartUploadParams, type RequestUploadUrlParams, type Result, type SearchChatroomMessagesParams, type SearchChatsParams, type SignUploadPartParams, type SignUploadPartsBatchParams, type TranslateChatroomMessageParams, type TriggerSocialParams, type UpdateCloneParams, type UpdateUserParams, type UploadExternalMindDataParams, VERSION, type WaitForExternalAuthorizationParams, type WaitForExternalCloneInvocationParams };

package/dist/index.d.ts

@@ -173,11 +173,15 @@ interface GetChatroomMembershipParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
     page?: number;
+    /** Maximum records requested for one server-capped page. */
     pageSize?: number;
     sortBy?: string;
+    /** Sort direction; supported values depend on the operation. */
     sortOrder?: number;
     useCursorPagination?: boolean;
+    /** Opaque pagination cursor value from the previous page (`next_cursor_value`). */
     cursorValue?: string;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
     cursorId?: string;
     /** The end-user's username. */
     username?: string;
@@ -190,11 +194,15 @@ interface GetChatroomMessagesParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
     page?: number;
+    /** Maximum records requested for one server-capped page. */
     pageSize?: number;
     sortBy?: string;
+    /** Sort direction; supported values depend on the operation. */
     sortOrder?: number;
     useCursorPagination?: boolean;
+    /** Opaque pagination cursor value from the previous page (`next_cursor_value`). */
     cursorValue?: string;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
     cursorId?: string;
     /** The end-user's username. */
     username?: string;
@@ -205,15 +213,35 @@ interface GetChatroomMessagesParams {
     sinceValue?: number;
     sinceId?: string;
 }
+interface GetChatroomMessagesAroundParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    /** The end-user's username. */
+    username: string;
+    /** The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage. */
+    password: string;
+    /** Chatroom id as returned by chatroom operations. */
+    chatroomId: string;
+    /** Chatroom message id. */
+    messageId: string;
+    /** How many earlier neighbors to include around the anchor id. */
+    before?: number;
+    /** How many later neighbors to include around the anchor id. */
+    after?: number;
+}
 interface GetChatroomsParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
     page?: number;
+    /** Maximum records requested for one server-capped page. */
     pageSize?: number;
     sortBy?: string;
+    /** Sort direction; supported values depend on the operation. */
     sortOrder?: number;
     useCursorPagination?: boolean;
+    /** Opaque pagination cursor value from the previous page (`next_cursor_value`). */
     cursorValue?: string;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
     cursorId?: string;
     /** The end-user's username. */
     username?: string;
@@ -222,6 +250,36 @@ interface GetChatroomsParams {
     getPublic?: boolean;
     getPrivate?: boolean;
 }
+interface SearchChatroomMessagesParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    /** The end-user's username. */
+    username: string;
+    /** The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage. */
+    password: string;
+    /** Chatroom id as returned by chatroom operations. */
+    chatroomId: string;
+    /** Optional find query. Whole-word tokens across alphabetic and numeric scripts; character phrases for Chinese / Japanese / Korean; mixed language supported. */
+    keyword?: string;
+    /** Optional list of media kinds to match: `image`, `video`, and/or `audio`. */
+    contentMediaTypes?: Array<"image" | "video" | "audio">;
+    /** Optional lower bound on message time as a UNIX timestamp in seconds. */
+    createdAfter?: number;
+    /** Optional upper bound on message time as a UNIX timestamp in seconds. */
+    createdBefore?: number;
+    /** Message send-time order: `-1` newest first (default), `1` oldest first. */
+    sortOrder?: -1 | 1;
+    /** Optional human member id; only messages from that user match. Mutually exclusive with `sender_clone_id`. */
+    senderUserId?: string;
+    /** Optional AI member id; only messages from that AI match. Mutually exclusive with `sender_user_id`. */
+    senderCloneId?: string;
+    /** Maximum Find hits for one page. */
+    pageSize?: number;
+    /** Opaque pagination cursor value from the previous page (`next_cursor_value`). */
+    cursorValue?: number;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
+    cursorId?: string;
+}
 interface TranslateChatroomMessageParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
@@ -238,11 +296,15 @@ interface GetChatParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
     page?: number;
+    /** Maximum records requested for one server-capped page. */
     pageSize?: number;
     sortBy?: string;
+    /** Sort direction; supported values depend on the operation. */
     sortOrder?: number;
     useCursorPagination?: boolean;
+    /** Opaque pagination cursor value from the previous page (`next_cursor_value`). */
     cursorValue?: string;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
     cursorId?: string;
     /** The end-user's username. */
     username?: string;
@@ -250,6 +312,22 @@ interface GetChatParams {
     password?: string;
     codename?: string;
 }
+interface GetChatAroundParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    /** The end-user's username. */
+    username: string;
+    /** The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage. */
+    password: string;
+    /** Owner AI consciousness id from `get_clones` (required for one-on-one jump). */
+    cloneId: string;
+    /** One-on-one chat turn id. */
+    chatId: string;
+    /** How many earlier neighbors to include around the anchor id. */
+    before?: number;
+    /** How many later neighbors to include around the anchor id. */
+    after?: number;
+}
 interface RagParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
@@ -262,6 +340,34 @@ interface RagParams {
     /** Chatroom id as returned by chatroom operations. */
     chatroomId?: string;
 }
+interface SearchChatsParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    /** The end-user's username. */
+    username: string;
+    /** The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage. */
+    password: string;
+    /** Owner AI consciousness id from `get_clones` (required for one-on-one find). */
+    cloneId: string;
+    /** Optional find query. Whole-word tokens across alphabetic and numeric scripts; character phrases for Chinese / Japanese / Korean; mixed language supported. */
+    keyword?: string;
+    /** Optional list of media kinds to match: `image`, `video`, and/or `audio`. */
+    contentMediaTypes?: Array<"image" | "video" | "audio">;
+    /** Optional lower bound on message time as a UNIX timestamp in seconds. */
+    createdAfter?: number;
+    /** Optional upper bound on message time as a UNIX timestamp in seconds. */
+    createdBefore?: number;
+    /** Turn send-time order: `-1` newest first (default), `1` oldest first. */
+    sortOrder?: -1 | 1;
+    /** Optional 1v1 side filter: `user` (human), `assistant` (AI), or `both` (turns that include both sides). */
+    side?: "user" | "assistant" | "both";
+    /** Maximum Find hits for one page. */
+    pageSize?: number;
+    /** Opaque pagination cursor value from the previous page (`next_cursor_value`). */
+    cursorValue?: number;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
+    cursorId?: string;
+}
 interface TriggerSocialParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
@@ -310,6 +416,7 @@ interface InvokeExternalCloneParams {
     installationId: string;
     /** Your stable opaque identifier for the person authorizing this installation. */
     externalSubject: string;
+    /** AI consciousness id as returned by clone operations. */
     cloneId: string;
     text: string;
     /** A stable opaque event key that makes exact retries return the same outcome. */
@@ -344,6 +451,7 @@ interface UploadExternalMindDataParams {
     installationId: string;
     /** Your stable opaque identifier for the person authorizing this installation. */
     externalSubject: string;
+    /** AI consciousness id as returned by clone operations. */
     cloneId: string;
     text: string;
     textType?: string;
@@ -486,6 +594,7 @@ interface CreateTextParams {
     /** The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage. */
     password?: string;
     codename?: string;
+    /** AI consciousness id as returned by clone operations. */
     cloneId?: string;
     text?: string;
     type?: string;
@@ -494,11 +603,15 @@ interface GetTextsParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
     page?: number;
+    /** Maximum records requested for one server-capped page. */
     pageSize?: number;
     sortBy?: string;
+    /** Sort direction; supported values depend on the operation. */
     sortOrder?: number;
     useCursorPagination?: boolean;
+    /** Opaque pagination cursor value from the previous page (`next_cursor_value`). */
     cursorValue?: string;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
     cursorId?: string;
     /** The end-user's username. */
     username?: string;
@@ -511,11 +624,15 @@ interface GetTransactionHistoryParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
     page?: number;
+    /** Maximum records requested for one server-capped page. */
     pageSize?: number;
     sortBy?: string;
+    /** Sort direction; supported values depend on the operation. */
     sortOrder?: number;
     useCursorPagination?: boolean;
+    /** Opaque pagination cursor value from the previous page (`next_cursor_value`). */
     cursorValue?: string;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
     cursorId?: string;
     /** The end-user's username. */
     username?: string;
@@ -635,16 +752,28 @@ declare class MindUpload extends MindUploadBase {
     getChatroomMembership(params?: GetChatroomMembershipParams): Promise<Result>;
     /** Fetch messages from a chatroom the user belongs to.
      *
-     * 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.
+     * 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, media_fallbacks, since_overflow.
      * @see https://docs.mindupload.app
      */
     getChatroomMessages(params?: GetChatroomMessagesParams): Promise<Result>;
+    /** Fetch a window of chatroom messages around one message id (for jump-to).
+     *
+     * Response fields: success, error_message, messages, media_thumbnails, media_fallbacks, anchor_message_id.
+     * @see https://docs.mindupload.app
+     */
+    getChatroomMessagesAround(params: GetChatroomMessagesAroundParams): Promise<Result>;
     /** List the chatrooms the user belongs to.
      *
      * Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, chatrooms.
      * @see https://docs.mindupload.app
      */
     getChatrooms(params?: GetChatroomsParams): Promise<Result>;
+    /** Find messages in a chatroom by keyword, date, media type, and/or sender.
+     *
+     * Response fields: success, error_message, messages, media_thumbnails, media_fallbacks, has_next, next_cursor_value, next_cursor_id, page_size, media_urls_expire_at.
+     * @see https://docs.mindupload.app
+     */
+    searchChatroomMessages(params: SearchChatroomMessagesParams): Promise<Result>;
     /** Translate a text chatroom message into the viewer language.
      *
      * Response fields: success, error_message, translated_text, target_language, cached.
@@ -653,16 +782,28 @@ declare class MindUpload extends MindUploadBase {
     translateChatroomMessage(params?: TranslateChatroomMessageParams): Promise<Result>;
     /** Fetch the one-on-one conversation history with an AI consciousness.
      *
-     * 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.
+     * 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, media_fallbacks.
      * @see https://docs.mindupload.app
      */
     getChat(params?: GetChatParams): Promise<Result>;
+    /** Fetch a window of one-on-one turns around one chat id (for jump-to).
+     *
+     * Response fields: success, error_message, chats, media_thumbnails, media_fallbacks, anchor_chat_id.
+     * @see https://docs.mindupload.app
+     */
+    getChatAround(params: GetChatAroundParams): Promise<Result>;
     /** Send a message to an AI consciousness and receive its reply.
      *
      * Response fields: success, error_message, response_text, clone_nickname, consolidation_summary, consolidation_count, consolidation_dispatched.
      * @see https://docs.mindupload.app
      */
     rag(params?: RagParams): Promise<Result>;
+    /** Find turns in a one-on-one AI conversation by keyword, date, media type, and/or Human/AI side.
+     *
+     * Response fields: success, error_message, chats, media_thumbnails, media_fallbacks, has_next, next_cursor_value, next_cursor_id, page_size, media_urls_expire_at.
+     * @see https://docs.mindupload.app
+     */
+    searchChats(params: SearchChatsParams): Promise<Result>;
     /** Have an AI consciousness proactively join the conversation in a chatroom.
      *
      * Response fields: success, error_message, response_text, chatroom_digests_count, chatroom_digests_summary, consolidation_summary, consolidation_count, consolidation_dispatched.
@@ -845,6 +986,6 @@ declare class MindUploadConnectionError extends MindUploadError {
     constructor(message: string, options?: ErrorOptions);
 }
 
-declare const VERSION = "1.9.6";
+declare const VERSION = "1.10.0";
 
-export { type AbortMultipartUploadParams, ApiError, type ApiErrorOptions, AuthenticationError, type CancelUploadParams, type CheckChatroomUpdatesParams, type CheckUsernameParams, type ClientOptions, type CompleteMultipartUploadParams, type CreateChatroomMembershipParams, type CreateChatroomMessageParams, type CreateChatroomParams, type CreateCloneParams, type CreateExternalAuthorizationRequestParams, type CreateTextParams, DEFAULT_BASE_URL, type ErrorOptions, type ExchangeExternalAuthorizationParams, type ExternalAuthorizationStatus, type GetChatParams, type GetChatroomMembershipParams, type GetChatroomMessagesParams, type GetChatroomsParams, type GetClonesParams, type GetMindClusterParams, type GetQuotaParams, type GetSoulmateReportParams, type GetTextsParams, type GetTransactionHistoryParams, type GetUserParams, type InspectExternalAuthorizationParams, type InvokeExternalCloneParams, type ListUploadPartsParams, type LoginParams, type LogoutParams, MindUpload, MindUploadBase, MindUploadConnectionError, MindUploadError, type RagParams, RateLimitError, type RateLimitOptions, type RefreshExternalAuthorizationParams, type RegisterParams, type RequestMultipartUploadParams, type RequestUploadUrlParams, type Result, type SignUploadPartParams, type SignUploadPartsBatchParams, type TranslateChatroomMessageParams, type TriggerSocialParams, type UpdateCloneParams, type UpdateUserParams, type UploadExternalMindDataParams, VERSION, type WaitForExternalAuthorizationParams, type WaitForExternalCloneInvocationParams };
+export { type AbortMultipartUploadParams, ApiError, type ApiErrorOptions, AuthenticationError, type CancelUploadParams, type CheckChatroomUpdatesParams, type CheckUsernameParams, type ClientOptions, type CompleteMultipartUploadParams, type CreateChatroomMembershipParams, type CreateChatroomMessageParams, type CreateChatroomParams, type CreateCloneParams, type CreateExternalAuthorizationRequestParams, type CreateTextParams, DEFAULT_BASE_URL, type ErrorOptions, type ExchangeExternalAuthorizationParams, type ExternalAuthorizationStatus, type GetChatAroundParams, type GetChatParams, type GetChatroomMembershipParams, type GetChatroomMessagesAroundParams, type GetChatroomMessagesParams, type GetChatroomsParams, type GetClonesParams, type GetMindClusterParams, type GetQuotaParams, type GetSoulmateReportParams, type GetTextsParams, type GetTransactionHistoryParams, type GetUserParams, type InspectExternalAuthorizationParams, type InvokeExternalCloneParams, type ListUploadPartsParams, type LoginParams, type LogoutParams, MindUpload, MindUploadBase, MindUploadConnectionError, MindUploadError, type RagParams, RateLimitError, type RateLimitOptions, type RefreshExternalAuthorizationParams, type RegisterParams, type RequestMultipartUploadParams, type RequestUploadUrlParams, type Result, type SearchChatroomMessagesParams, type SearchChatsParams, type SignUploadPartParams, type SignUploadPartsBatchParams, type TranslateChatroomMessageParams, type TriggerSocialParams, type UpdateCloneParams, type UpdateUserParams, type UploadExternalMindDataParams, VERSION, type WaitForExternalAuthorizationParams, type WaitForExternalCloneInvocationParams };

package/dist/index.js

@@ -41,7 +41,7 @@ var MindUploadConnectionError = class extends MindUploadError {
 };
 
 // src/version.ts
-var VERSION = "1.9.6";
+var VERSION = "1.10.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://partner.mindupload.app";
@@ -283,12 +283,20 @@ var MindUpload = class extends MindUploadBase {
   }
   /** Fetch messages from a chatroom the user belongs to.
    *
-   * 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.
+   * 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, media_fallbacks, since_overflow.
    * @see https://docs.mindupload.app
    */
   getChatroomMessages(params = {}) {
     return this.request("get_chatroom_messages", params);
   }
+  /** Fetch a window of chatroom messages around one message id (for jump-to).
+   *
+   * Response fields: success, error_message, messages, media_thumbnails, media_fallbacks, anchor_message_id.
+   * @see https://docs.mindupload.app
+   */
+  getChatroomMessagesAround(params) {
+    return this.request("get_chatroom_messages_around", params);
+  }
   /** List the chatrooms the user belongs to.
    *
    * Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, chatrooms.
@@ -297,6 +305,14 @@ var MindUpload = class extends MindUploadBase {
   getChatrooms(params = {}) {
     return this.request("get_chatrooms", params);
   }
+  /** Find messages in a chatroom by keyword, date, media type, and/or sender.
+   *
+   * Response fields: success, error_message, messages, media_thumbnails, media_fallbacks, has_next, next_cursor_value, next_cursor_id, page_size, media_urls_expire_at.
+   * @see https://docs.mindupload.app
+   */
+  searchChatroomMessages(params) {
+    return this.request("search_chatroom_messages", params);
+  }
   /** Translate a text chatroom message into the viewer language.
    *
    * Response fields: success, error_message, translated_text, target_language, cached.
@@ -308,12 +324,20 @@ var MindUpload = class extends MindUploadBase {
   // --- Conversation ---
   /** Fetch the one-on-one conversation history with an AI consciousness.
    *
-   * 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.
+   * 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, media_fallbacks.
    * @see https://docs.mindupload.app
    */
   getChat(params = {}) {
     return this.request("get_chat", params);
   }
+  /** Fetch a window of one-on-one turns around one chat id (for jump-to).
+   *
+   * Response fields: success, error_message, chats, media_thumbnails, media_fallbacks, anchor_chat_id.
+   * @see https://docs.mindupload.app
+   */
+  getChatAround(params) {
+    return this.request("get_chat_around", params);
+  }
   /** Send a message to an AI consciousness and receive its reply.
    *
    * Response fields: success, error_message, response_text, clone_nickname, consolidation_summary, consolidation_count, consolidation_dispatched.
@@ -322,6 +346,14 @@ var MindUpload = class extends MindUploadBase {
   rag(params = {}) {
     return this.request("rag", params);
   }
+  /** Find turns in a one-on-one AI conversation by keyword, date, media type, and/or Human/AI side.
+   *
+   * Response fields: success, error_message, chats, media_thumbnails, media_fallbacks, has_next, next_cursor_value, next_cursor_id, page_size, media_urls_expire_at.
+   * @see https://docs.mindupload.app
+   */
+  searchChats(params) {
+    return this.request("search_chats", params);
+  }
   /** Have an AI consciousness proactively join the conversation in a chatroom.
    *
    * Response fields: success, error_message, response_text, chatroom_digests_count, chatroom_digests_summary, consolidation_summary, consolidation_count, consolidation_dispatched.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindupload",
-  "version": "1.9.6",
+  "version": "1.10.0",
   "description": "Official server-side SDK for the Mind Upload partner API \u2014 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.",
   "keywords": [
     "mindupload",