mindupload 1.15.15 → 1.15.17

package/dist/index.d.ts

@@ -4,6 +4,7 @@ declare const DEFAULT_BASE_URL = "https://partner.mindupload.app";
 interface Result {
     success: boolean;
     error_message?: string | null;
+    error_code?: string;
     [key: string]: unknown;
 }
 interface ClientOptions {
@@ -391,6 +392,44 @@ interface TriggerSocialParams {
     /** Credit amount displayed before the action, as an exact decimal string. The action is refused if a new charge would use a different amount. Omit for older clients; cached reports remain free. */
     expectedCreditCost?: string;
 }
+interface CancelExternalMediaUploadParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    /** Opaque grant token accepted only by grant inspection and external clone invocation; store it as a secret and never expose it to users. */
+    accessToken: string;
+    /** Your stable opaque identifier for this app installation. */
+    installationId: string;
+    /** Your stable opaque identifier for the person authorizing this installation. */
+    externalSubject: string;
+    /** AI consciousness id as returned by clone operations. */
+    cloneId: string;
+    /** Server-issued controlled upload reference returned by request_external_media_upload; never a URL. */
+    uploadId: string;
+}
+interface ConsolidateExternalConversationParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    /** Opaque grant token accepted only by grant inspection and external clone invocation; store it as a secret and never expose it to users. */
+    accessToken: string;
+    /** Your stable opaque identifier for this app installation. */
+    installationId: string;
+    /** Your stable opaque identifier for the person authorizing this installation. */
+    externalSubject: string;
+    /** AI consciousness id as returned by clone operations. */
+    cloneId: string;
+    /** A stable opaque event key that makes exact retries return the same outcome. */
+    idempotencyKey: string;
+    currentText: string;
+    cloneResponse: string;
+    contextMessages?: Array<Record<string, unknown>>;
+    references?: Array<Record<string, unknown>>;
+    /** Neutral display name of whoever is sending this message, shown to the AI consciousness as who it is currently talking to. */
+    speakerLabel?: string;
+    sourceLabel?: string;
+    mediaIds?: Array<string>;
+    purpose?: "conversation" | "reading";
+    ownerNotes?: string;
+}
 interface CreateExternalAuthorizationRequestParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
@@ -405,7 +444,7 @@ interface CreateExternalAuthorizationRequestParams {
     /** Optional user-readable external identity shown during consent. */
     externalIdentityLabel?: string;
     /** Capabilities the owner is being asked to delegate. */
-    requestedScopes: Array<"clone:invoke" | "clone:learn" | "clone:invoke_shared" | "clone:upload">;
+    requestedScopes: Array<"clone:invoke" | "clone:learn" | "clone:invoke_shared" | "clone:upload" | "clone:review">;
 }
 interface ExchangeExternalAuthorizationParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
@@ -413,6 +452,55 @@ interface ExchangeExternalAuthorizationParams {
     /** Short-lived high-entropy secret used only to poll and exchange this request. */
     deviceCode: string;
 }
+interface GetExternalMediaAnalysisParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    /** Opaque grant token accepted only by grant inspection and external clone invocation; store it as a secret and never expose it to users. */
+    accessToken: string;
+    /** Your stable opaque identifier for this app installation. */
+    installationId: string;
+    /** Your stable opaque identifier for the person authorizing this installation. */
+    externalSubject: string;
+    /** AI consciousness id as returned by clone operations. */
+    cloneId: string;
+    /** Server-issued controlled upload reference returned by request_external_media_upload; never a URL. */
+    uploadId: string;
+}
+interface GetExternalMediaPolicyParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    /** Opaque grant token accepted only by grant inspection and external clone invocation; store it as a secret and never expose it to users. */
+    accessToken: string;
+    /** Your stable opaque identifier for this app installation. */
+    installationId: string;
+    /** Your stable opaque identifier for the person authorizing this installation. */
+    externalSubject: string;
+    /** AI consciousness id as returned by clone operations. */
+    cloneId: string;
+}
+interface GetExternalQuarantinedTextsParams {
+    /** 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?: number;
+    /** Opaque pagination cursor id from the previous page (`next_cursor_id`). */
+    cursorId?: string;
+    /** Opaque grant token accepted only by grant inspection and external clone invocation; store it as a secret and never expose it to users. */
+    accessToken: string;
+    /** Your stable opaque identifier for this app installation. */
+    installationId: string;
+    /** Your stable opaque identifier for the person authorizing this installation. */
+    externalSubject: string;
+    /** AI consciousness id as returned by clone operations. */
+    cloneId: string;
+}
 interface InspectExternalAuthorizationParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
@@ -424,6 +512,12 @@ interface InvokeExternalCloneParams {
     preferredLanguage?: string;
     /** Opaque grant token accepted only by grant inspection and external clone invocation; store it as a secret and never expose it to users. */
     accessToken: string;
+    /** When true, marker-like text is quoted literally and cannot fetch media. Only the owner’s own clone is accepted; use explicit consolidation/save for learning. */
+    literalText?: boolean;
+    /** Completed controlled media IDs, checked for ownership, application, scope, retention and exact object version. No analysis is started here. */
+    mediaIds?: Array<string>;
+    /** Quoted page or subtitle sources kept separate from owner statements. Titles, URLs and bodies share the request text bound; URLs are never fetched. */
+    references?: Array<Record<string, unknown>>;
     /** Your stable opaque identifier for this app installation. */
     installationId: string;
     /** Your stable opaque identifier for the person authorizing this installation. */
@@ -453,12 +547,69 @@ interface RefreshExternalAuthorizationParams {
     installationId: string;
     /** Your stable opaque identifier for the person authorizing this installation. */
     externalSubject: string;
+    /** A stable opaque event key that makes exact retries return the same outcome. */
+    idempotencyKey?: string;
+}
+interface RequestExternalMediaUploadParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    /** Opaque grant token accepted only by grant inspection and external clone invocation; store it as a secret and never expose it to users. */
+    accessToken: string;
+    /** Your stable opaque identifier for this app installation. */
+    installationId: string;
+    /** Your stable opaque identifier for the person authorizing this installation. */
+    externalSubject: string;
+    /** AI consciousness id as returned by clone operations. */
+    cloneId: string;
+    /** A stable opaque event key that makes exact retries return the same outcome. */
+    idempotencyKey: string;
+    filename: string;
+    contentType: "application/ogg" | "audio/3gpp" | "audio/aac" | "audio/m4a" | "audio/mp3" | "audio/mp4" | "audio/mpeg" | "audio/ogg" | "audio/wav" | "audio/wave" | "audio/webm" | "audio/x-m4a" | "audio/x-wav" | "image/gif" | "image/heic" | "image/heif" | "image/jpeg" | "image/png" | "image/webp" | "video/3gpp" | "video/avi" | "video/mp4" | "video/ogg" | "video/quicktime" | "video/webm" | "video/x-flv" | "video/x-m4v" | "video/x-matroska" | "video/x-ms-wmv" | "video/x-msvideo";
+    fileSizeBytes: number;
+    /** The kind of media: `image`, `video`, or `audio`. */
+    mediaType: "image" | "video" | "audio";
+}
+interface ReviewExternalQuarantinedTextParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    /** Opaque grant token accepted only by grant inspection and external clone invocation; store it as a secret and never expose it to users. */
+    accessToken: string;
+    /** Your stable opaque identifier for this app installation. */
+    installationId: string;
+    /** Your stable opaque identifier for the person authorizing this installation. */
+    externalSubject: string;
+    /** AI consciousness id as returned by clone operations. */
+    cloneId: string;
+    /** A stable opaque event key that makes exact retries return the same outcome. */
+    idempotencyKey: string;
+    textId: string;
+    expectedContentRevision: string;
+    decision: "approve" | "reject" | "update";
+    text?: string;
+}
+interface StartExternalMediaAnalysisParams {
+    /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
+    preferredLanguage?: string;
+    /** Opaque grant token accepted only by grant inspection and external clone invocation; store it as a secret and never expose it to users. */
+    accessToken: string;
+    /** Your stable opaque identifier for this app installation. */
+    installationId: string;
+    /** Your stable opaque identifier for the person authorizing this installation. */
+    externalSubject: string;
+    /** AI consciousness id as returned by clone operations. */
+    cloneId: string;
+    /** Server-issued controlled upload reference returned by request_external_media_upload; never a URL. */
+    uploadId: string;
 }
 interface UploadExternalMindDataParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
     preferredLanguage?: string;
     /** Opaque grant token accepted only by grant inspection and external clone invocation; store it as a secret and never expose it to users. */
     accessToken: string;
+    /** When true, upload the exact edited body without interpreting embedded media markers. */
+    literalText?: boolean;
+    /** Completed controlled media IDs, checked for ownership, application, scope, retention and exact object version. No analysis is started here. */
+    mediaIds?: Array<string>;
     /** Your stable opaque identifier for this app installation. */
     installationId: string;
     /** Your stable opaque identifier for the person authorizing this installation. */
@@ -467,8 +618,9 @@ interface UploadExternalMindDataParams {
     cloneId: string;
     text: string;
     textType?: "memory" | "persona" | "conscious";
-    /** Optional. Accepted for forward compatibility but ignored for deduplication today — retries may create another quarantine item. Not a safe replay key. */
+    /** Optional for legacy clients. Reuse for retries of the same complete upload. A key is bound to the partner, grant, installation, external identity, clone, text type, text and provenance; changing any part is rejected. Receipts survive text deletion and are removed with the account. */
     idempotencyKey?: string;
+    previewId?: string;
     sourceLabel?: string;
 }
 interface GetMindClusterParams {
@@ -852,337 +1004,385 @@ interface TranscribeVoiceInterviewAnswerParams {
 declare class MindUpload extends MindUploadBase {
     /** Create a new AI consciousness for the user.
      *
-     * Response fields: success, error_message.
+     * Response fields: success, error_message, error_code.
      * @see https://docs.mindupload.app
      */
     createClone(params?: CreateCloneParams): Promise<Result>;
     /** List the user's AI consciousnesses.
      *
-     * Response fields: success, error_message, clones.
+     * Response fields: success, error_message, error_code, clones.
      * @see https://docs.mindupload.app
      */
     getClones(params?: GetClonesParams): Promise<Result>;
     /** Update an AI consciousness's profile.
      *
-     * Response fields: success, error_message.
+     * Response fields: success, error_message, error_code.
      * @see https://docs.mindupload.app
      */
     updateClone(params?: UpdateCloneParams): Promise<Result>;
     /** Check your partner API rate limits, credit caps, and current usage.
      *
-     * Response fields: success, error_message, per_user_rate_limit_per_min, per_user_daily_credit_cap, partner_rate_limit_per_min, external_authorization_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, calls_enabled, call_minutes_cap_monthly, call_max_concurrent_sessions, call_voice_minutes_cap_monthly, call_video_minutes_cap_monthly, call_voice_participant_minutes_this_month, call_video_participant_minutes_this_month, call_month_start_timestamp, call_sessions_this_month, call_participant_minutes_this_month, call_live_participant_minutes, call_data_transferred_bytes_this_month, call_data_transferred_is_complete, call_live_sessions, call_spending_tasks, operation_duration_ms.
+     * Response fields: success, error_message, error_code, per_user_rate_limit_per_min, per_user_daily_credit_cap, partner_rate_limit_per_min, external_authorization_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, calls_enabled, call_minutes_cap_monthly, call_max_concurrent_sessions, call_voice_minutes_cap_monthly, call_video_minutes_cap_monthly, call_voice_participant_minutes_this_month, call_video_participant_minutes_this_month, call_month_start_timestamp, call_sessions_this_month, call_participant_minutes_this_month, call_live_participant_minutes, call_data_transferred_bytes_this_month, call_data_transferred_is_complete, call_live_sessions, call_spending_tasks, operation_duration_ms.
      * @see https://docs.mindupload.app
      */
     getQuota(params?: GetQuotaParams): Promise<Result>;
     /** Check whether a username is still available before registering.
      *
-     * Response fields: success, error_message, exists, disabled, rate_limited, flood_window, wait_seconds, operation_duration_ms.
+     * Response fields: success, error_message, error_code, exists, disabled, rate_limited, flood_window, wait_seconds, operation_duration_ms.
      * @see https://docs.mindupload.app
      */
     checkUsername(params?: CheckUsernameParams): Promise<Result>;
     /** Sign a user in and receive a session token (JWT) for subsequent calls.
      *
-     * Response fields: success, error_message, jwt, decrypted_user.
+     * Response fields: success, error_message, error_code, jwt, decrypted_user.
      * @see https://docs.mindupload.app
      */
     login(params?: LoginParams): Promise<Result>;
     /** End the current user session.
      *
-     * Response fields: success, error_message, revoked, operation_duration_ms.
+     * Response fields: success, error_message, error_code, revoked, operation_duration_ms.
      * @see https://docs.mindupload.app
      */
     logout(params?: LogoutParams): Promise<Result>;
     /** Create a user account on your platform.
      *
-     * Response fields: success, error_message, jwt, decrypted_user.
+     * Response fields: success, error_message, error_code, jwt, decrypted_user.
      * @see https://docs.mindupload.app
      */
     register(params?: RegisterParams): Promise<Result>;
     /** Cheaply poll whether the user's chatrooms have new activity.
      *
-     * Response fields: success, error_message, server_time, poll_config, chatrooms.
+     * Response fields: success, error_message, error_code, server_time, poll_config, chatrooms.
      * @see https://docs.mindupload.app
      */
     checkChatroomUpdates(params?: CheckChatroomUpdatesParams): Promise<Result>;
     /** Create a chatroom.
      *
-     * Response fields: success, error_message, chatroom_id.
+     * Response fields: success, error_message, error_code, chatroom_id.
      * @see https://docs.mindupload.app
      */
     createChatroom(params?: CreateChatroomParams): Promise<Result>;
     /** Invite a user or an AI consciousness into a chatroom.
      *
-     * Response fields: success, error_message, membership_id.
+     * Response fields: success, error_message, error_code, membership_id.
      * @see https://docs.mindupload.app
      */
     createChatroomMembership(params?: CreateChatroomMembershipParams): Promise<Result>;
     /** Send a message to a chatroom.
      *
-     * Response fields: success, error_message, message_id.
+     * Response fields: success, error_message, error_code, message_id.
      * @see https://docs.mindupload.app
      */
     createChatroomMessage(params?: CreateChatroomMessageParams): Promise<Result>;
     /** List the members of 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, memberships.
+     * Response fields: success, error_message, error_code, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, memberships.
      * @see https://docs.mindupload.app
      */
     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, media_fallbacks, since_overflow.
+     * Response fields: success, error_message, error_code, 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.
+     * Response fields: success, error_message, error_code, 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.
+     * Response fields: success, error_message, error_code, 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.
+     * Response fields: success, error_message, error_code, 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.
+     * Response fields: success, error_message, error_code, translated_text, target_language, cached.
      * @see https://docs.mindupload.app
      */
     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, media_fallbacks.
+     * Response fields: success, error_message, error_code, 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.
+     * Response fields: success, error_message, error_code, 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, content_format, clone_nickname, consolidation_summary, consolidation_count, consolidation_dispatched.
+     * Response fields: success, error_message, error_code, response_text, content_format, 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.
+     * Response fields: success, error_message, error_code, 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, content_format, response_text, chatroom_digests_count, chatroom_digests_summary, consolidation_summary, consolidation_count, consolidation_dispatched.
+     * Response fields: success, error_message, error_code, content_format, response_text, chatroom_digests_count, chatroom_digests_summary, consolidation_summary, consolidation_count, consolidation_dispatched.
      * @see https://docs.mindupload.app
      */
     triggerSocial(params?: TriggerSocialParams): Promise<Result>;
+    /** Cancel one controlled upload through the existing media lifecycle.
+     *
+     * Response fields: success, error_message, error_code.
+     * @see https://docs.mindupload.app
+     */
+    cancelExternalMediaUpload(params: CancelExternalMediaUploadParams): Promise<Result>;
+    /** Prepare a verified memory from an explicitly selected owner conversation.
+     *
+     * Response fields: success, error_message, error_code, status, text, auto_keep_external_memories, retry_after_seconds, preview_id, reading_provenance.
+     * @see https://docs.mindupload.app
+     */
+    consolidateExternalConversation(params: ConsolidateExternalConversationParams): Promise<Result>;
     /** Start passwordless grant issuance for an external identity and installation.
      *
-     * Response fields: success, error_message, device_code, user_code, verification_uri, verification_uri_complete, expires_in, poll_interval, grant_duration_seconds.
+     * Response fields: success, error_message, error_code, device_code, user_code, verification_uri, verification_uri_complete, expires_in, poll_interval, grant_duration_seconds.
      * @see https://docs.mindupload.app
      */
     createExternalAuthorizationRequest(params: CreateExternalAuthorizationRequestParams): Promise<Result>;
     /** Poll owner consent and exchange an approval for a clone-scoped grant token.
      *
-     * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, clone_nicknames, access_token_expires_at, expires_at, poll_interval.
+     * Response fields: success, error_message, error_code, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, clone_nicknames, access_token_expires_at, expires_at, poll_interval.
      * @see https://docs.mindupload.app
      */
     exchangeExternalAuthorization(params: ExchangeExternalAuthorizationParams): Promise<Result>;
+    /** Read the current owned media analysis without restarting generation.
+     *
+     * Response fields: success, error_message, error_code, media.
+     * @see https://docs.mindupload.app
+     */
+    getExternalMediaAnalysis(params: GetExternalMediaAnalysisParams): Promise<Result>;
+    /** Read current native media limits and owner quota without starting work.
+     *
+     * Response fields: success, error_message, error_code, allowed_content_types, max_file_size_bytes_by_type, video_frame_count, video_audio_max_seconds, can_upload, can_analyze, remaining_storage_bytes, remaining_uploads_monthly, upload_limit_monthly, upload_count_renews_at, retention_days.
+     * @see https://docs.mindupload.app
+     */
+    getExternalMediaPolicy(params: GetExternalMediaPolicyParams): Promise<Result>;
+    /** List pending memories of the owner's granted AI consciousness.
+     *
+     * Response fields: success, error_message, error_code, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, texts, scopes, can_invoke, can_upload, can_consolidate, auto_keep_external_memories.
+     * @see https://docs.mindupload.app
+     */
+    getExternalQuarantinedTexts(params: GetExternalQuarantinedTextsParams): Promise<Result>;
     /** Inspect the scopes, clone resources, expiry, and revocation state of a grant token.
      *
-     * Response fields: success, error_message, grant_id, status, scopes, clone_ids, created_at, access_token_expires_at, expires_at, revoked_at.
+     * Response fields: success, error_message, error_code, grant_id, status, scopes, clone_ids, created_at, access_token_expires_at, expires_at, revoked_at.
      * @see https://docs.mindupload.app
      */
     inspectExternalAuthorization(params: InspectExternalAuthorizationParams): Promise<Result>;
     /** Send one idempotent text event to an owner-approved AI consciousness.
      *
-     * Response fields: success, error_message, invocation_id, status, response_text, clone_id, clone_nickname, generated_by_ai, idempotent_replay, retry_after_seconds.
+     * Response fields: success, error_message, error_code, invocation_id, status, response_text, clone_id, clone_nickname, generated_by_ai, idempotent_replay, retry_after_seconds.
      * @see https://docs.mindupload.app
      */
     invokeExternalClone(params: InvokeExternalCloneParams): Promise<Result>;
     /** Refresh a short-lived clone-invocation access token.
      *
-     * Response fields: success, error_message, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, clone_nicknames, access_token_expires_at, expires_at.
+     * Response fields: success, error_message, error_code, status, access_token, refresh_token, token_type, grant_id, scopes, clone_ids, clone_nicknames, access_token_expires_at, expires_at.
      * @see https://docs.mindupload.app
      */
     refreshExternalAuthorization(params: RefreshExternalAuthorizationParams): Promise<Result>;
+    /** Authorize one exact media upload to the owner’s granted AI consciousness.
+     *
+     * Response fields: success, error_message, error_code, upload_id, presigned_url, content_type, file_size_bytes, expires_at, idempotent_replay, required_headers.
+     * @see https://docs.mindupload.app
+     */
+    requestExternalMediaUpload(params: RequestExternalMediaUploadParams): Promise<Result>;
+    /** Edit, approve or reject the displayed revision of one pending memory.
+     *
+     * Response fields: success, error_message, error_code, status, text_id, text, content_revision, pending_owner_review, retry_after_seconds.
+     * @see https://docs.mindupload.app
+     */
+    reviewExternalQuarantinedText(params: ReviewExternalQuarantinedTextParams): Promise<Result>;
+    /** Explicitly describe one completed controlled upload.
+     *
+     * Response fields: success, error_message, error_code, media.
+     * @see https://docs.mindupload.app
+     */
+    startExternalMediaAnalysis(params: StartExternalMediaAnalysisParams): Promise<Result>;
     /** Upload mind data (text and media) into the owner's own AI consciousness.
      *
-     * Response fields: success, error_message, clone_id, text_type, pending_owner_review.
+     * Response fields: success, error_message, error_code, clone_id, text_type, pending_owner_review, text_id, status, idempotent_replay, retry_after_seconds.
      * @see https://docs.mindupload.app
      */
     uploadExternalMindData(params: UploadExternalMindDataParams): Promise<Result>;
     /** Fetch the mind-graph visualization data of an AI consciousness.
      *
-     * Response fields: success, error_message, root_node_id, node, children, texts, total_texts, texts_offset, has_more_texts, is_building.
+     * Response fields: success, error_message, error_code, root_node_id, node, children, texts, total_texts, texts_offset, has_more_texts, is_building.
      * @see https://docs.mindupload.app
      */
     getMindCluster(params?: GetMindClusterParams): Promise<Result>;
     /** Generate or fetch the compatibility report between two chatroom members.
      *
-     * Response fields: success, error_message, report, report_generated_at, is_generating, charged.
+     * Response fields: success, error_message, error_code, report, report_generated_at, is_generating, charged.
      * @see https://docs.mindupload.app
      */
     getSoulmateReport(params?: GetSoulmateReportParams): Promise<Result>;
     /** Start a live voice and video call in a chatroom, or join the one already running.
      *
-     * Response fields: success, error_message, call_session_id, auth_token, participant_id, expires_at, is_host, call_session.
+     * Response fields: success, error_message, error_code, call_session_id, auth_token, participant_id, expires_at, is_host, call_session.
      * @see https://docs.mindupload.app
      */
     createCallSession(params?: CreateCallSessionParams): Promise<Result>;
     /** End a live call for everyone in it.
      *
-     * Response fields: success, error_message.
+     * Response fields: success, error_message, error_code.
      * @see https://docs.mindupload.app
      */
     endCallSession(params?: EndCallSessionParams): Promise<Result>;
     /** Check whether a chatroom has a live call, and how many people are in it.
      *
-     * Response fields: success, error_message, call_session.
+     * Response fields: success, error_message, error_code, call_session.
      * @see https://docs.mindupload.app
      */
     getActiveCallSession(params?: GetActiveCallSessionParams): Promise<Result>;
     /** Join a live call that is already running in a chatroom.
      *
-     * Response fields: success, error_message, call_session_id, auth_token, participant_id, expires_at, is_host, call_session.
+     * Response fields: success, error_message, error_code, call_session_id, auth_token, participant_id, expires_at, is_host, call_session.
      * @see https://docs.mindupload.app
      */
     joinCallSession(params?: JoinCallSessionParams): Promise<Result>;
     /** Say that this person has left a call the others are still in.
      *
-     * Response fields: success, error_message.
+     * Response fields: success, error_message, error_code.
      * @see https://docs.mindupload.app
      */
     leaveCallSession(params?: LeaveCallSessionParams): Promise<Result>;
     /** Get a fresh joining pass for a call, before the current one expires.
      *
-     * Response fields: success, error_message, call_session_id, auth_token, participant_id, expires_at, is_host.
+     * Response fields: success, error_message, error_code, call_session_id, auth_token, participant_id, expires_at, is_host.
      * @see https://docs.mindupload.app
      */
     refreshCallToken(params?: RefreshCallTokenParams): Promise<Result>;
     /** Make somebody a co-host of a live call, or stand them down again.
      *
-     * Response fields: success, error_message.
+     * Response fields: success, error_message, error_code.
      * @see https://docs.mindupload.app
      */
     setCallHost(params?: SetCallHostParams): Promise<Result>;
     /** Cancel a multipart upload and discard its parts.
      *
-     * Response fields: success, error_message.
+     * Response fields: success, error_message, error_code.
      * @see https://docs.mindupload.app
      */
     abortMultipartUpload(params?: AbortMultipartUploadParams): Promise<Result>;
     /** Cancel a pending upload.
      *
-     * Response fields: success, error_message.
+     * Response fields: success, error_message, error_code.
      * @see https://docs.mindupload.app
      */
     cancelUpload(params?: CancelUploadParams): Promise<Result>;
     /** Finish a multipart upload.
      *
-     * Response fields: success, error_message, media_url.
+     * Response fields: success, error_message, error_code, media_url.
      * @see https://docs.mindupload.app
      */
     completeMultipartUpload(params?: CompleteMultipartUploadParams): Promise<Result>;
     /** List the parts already uploaded in a multipart upload.
      *
-     * Response fields: success, error_message, parts.
+     * Response fields: success, error_message, error_code, parts.
      * @see https://docs.mindupload.app
      */
     listUploadParts(params?: ListUploadPartsParams): Promise<Result>;
     /** Start a large-file upload in multiple parts.
      *
-     * Response fields: success, error_message, upload_id, r2_key, media_url, signed_media_url, thumbnail_r2_key, thumbnail_presigned_url, signed_thumbnail_url.
+     * Response fields: success, error_message, error_code, upload_id, r2_key, media_url, signed_media_url, thumbnail_r2_key, thumbnail_presigned_url, signed_thumbnail_url.
      * @see https://docs.mindupload.app
      */
     requestMultipartUpload(params?: RequestMultipartUploadParams): Promise<Result>;
     /** Request an upload slot and a signed viewing link for a media attachment.
      *
-     * Response fields: success, error_message, r2_key, presigned_url, media_url, signed_media_url, thumbnail_r2_key, thumbnail_presigned_url, signed_thumbnail_url.
+     * Response fields: success, error_message, error_code, r2_key, presigned_url, media_url, signed_media_url, thumbnail_r2_key, thumbnail_presigned_url, signed_thumbnail_url.
      * @see https://docs.mindupload.app
      */
     requestUploadUrl(params?: RequestUploadUrlParams): Promise<Result>;
     /** Get the signed link for one part of a multipart upload.
      *
-     * Response fields: success, error_message, presigned_url.
+     * Response fields: success, error_message, error_code, presigned_url.
      * @see https://docs.mindupload.app
      */
     signUploadPart(params?: SignUploadPartParams): Promise<Result>;
     /** Get signed links for several parts of a multipart upload at once.
      *
-     * Response fields: success, error_message, presigned_urls.
+     * Response fields: success, error_message, error_code, presigned_urls.
      * @see https://docs.mindupload.app
      */
     signUploadPartsBatch(params?: SignUploadPartsBatchParams): Promise<Result>;
     /** Begin analysing an uploaded or linked attachment so its description is ready before the message is sent.
      *
-     * Response fields: success, error_message, analyses.
+     * Response fields: success, error_message, error_code, analyses.
      * @see https://docs.mindupload.app
      */
     startMediaAnalysis(params: StartMediaAnalysisParams): Promise<Result>;
     /** Upload a memory or persona entry to an AI consciousness.
      *
-     * Response fields: success, error_message, cluster_label, cluster_modified_count.
+     * Response fields: success, error_message, error_code, cluster_label, cluster_modified_count.
      * @see https://docs.mindupload.app
      */
     createText(params?: CreateTextParams): Promise<Result>;
     /** List the memories and persona entries uploaded to 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, texts.
+     * Response fields: success, error_message, error_code, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, texts.
      * @see https://docs.mindupload.app
      */
     getTexts(params?: GetTextsParams): Promise<Result>;
     /** List the user's Rabbit balance history (top-ups, spending, earnings, withdrawals, tax), newest first, filterable by category and paged with a cursor.
      *
-     * Response fields: success, error_message, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, transactions, operation_duration_ms.
+     * Response fields: success, error_message, error_code, total_count, page, page_size, total_pages, has_next, has_prev, next_cursor_value, next_cursor_id, transactions, operation_duration_ms.
      * @see https://docs.mindupload.app
      */
     getTransactionHistory(params?: GetTransactionHistoryParams): Promise<Result>;
     /** Fetch the signed-in user's profile.
      *
-     * Response fields: success, error_message, jwt, decrypted_user.
+     * Response fields: success, error_message, error_code, jwt, decrypted_user.
      * @see https://docs.mindupload.app
      */
     getUser(params?: GetUserParams): Promise<Result>;
     /** Update the signed-in user's profile.
      *
-     * Response fields: success, error_message.
+     * Response fields: success, error_message, error_code.
      * @see https://docs.mindupload.app
      */
     updateUser(params?: UpdateUserParams): Promise<Result>;
     /** Accept, edit, skip, re-record or abandon the question the user is on, and receive the next one.
      *
-     * Response fields: success, error_message, interview_session_id, template_key, language, turn_index, question_text, question_audio_url, question_audio_content_type, progress, is_complete, is_resumed, status, safety_message.
+     * Response fields: success, error_message, error_code, interview_session_id, template_key, language, turn_index, question_text, question_audio_url, question_audio_content_type, progress, is_complete, is_resumed, status, safety_message.
      * @see https://docs.mindupload.app
      */
     advanceVoiceInterview(params?: AdvanceVoiceInterviewParams): Promise<Result>;
     /** Write a finished interview up as prose, in first, second or third person.
      *
-     * Response fields: success, error_message, interview_session_id, person, report_text, text_type, is_raw_answers.
+     * Response fields: success, error_message, error_code, interview_session_id, person, report_text, text_type, is_raw_answers.
      * @see https://docs.mindupload.app
      */
     generateVoiceInterviewReport(params?: GenerateVoiceInterviewReportParams): Promise<Result>;
     /** Begin a spoken interview with one of your end-users, or hand back one they have not finished with.
      *
-     * Response fields: success, error_message, interview_session_id, template_key, language, turn_index, question_text, question_audio_url, question_audio_content_type, progress, is_complete, is_resumed, status, voice_id, voices.
+     * Response fields: success, error_message, error_code, interview_session_id, template_key, language, turn_index, question_text, question_audio_url, question_audio_content_type, progress, is_complete, is_resumed, status, voice_id, voices.
      * @see https://docs.mindupload.app
      */
     startVoiceInterview(params?: StartVoiceInterviewParams): Promise<Result>;
     /** Turn one recorded spoken answer into text for the user to check before it is accepted.
      *
-     * Response fields: success, error_message, recognized_text.
+     * Response fields: success, error_message, error_code, recognized_text.
      * @see https://docs.mindupload.app
      */
     transcribeVoiceInterviewAnswer(params?: TranscribeVoiceInterviewAnswerParams): Promise<Result>;
@@ -1236,6 +1436,6 @@ declare class MindUploadConnectionError extends MindUploadError {
     constructor(message: string, options?: ErrorOptions);
 }
 
-declare const VERSION = "1.15.15";
+declare const VERSION = "1.15.17";
 
-export { type AbortMultipartUploadParams, type AdvanceVoiceInterviewParams, ApiError, type ApiErrorOptions, AuthenticationError, type CancelUploadParams, type CheckChatroomUpdatesParams, type CheckUsernameParams, type ClientOptions, type CompleteMultipartUploadParams, type CreateCallSessionParams, type CreateChatroomMembershipParams, type CreateChatroomMessageParams, type CreateChatroomParams, type CreateCloneParams, type CreateExternalAuthorizationRequestParams, type CreateTextParams, DEFAULT_BASE_URL, type EndCallSessionParams, type ErrorOptions, type ExchangeExternalAuthorizationParams, type ExternalAuthorizationStatus, type GenerateVoiceInterviewReportParams, type GetActiveCallSessionParams, 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 JoinCallSessionParams, type LeaveCallSessionParams, type ListUploadPartsParams, type LoginParams, type LogoutParams, MindUpload, MindUploadBase, MindUploadConnectionError, MindUploadError, type RagParams, RateLimitError, type RateLimitOptions, type RefreshCallTokenParams, type RefreshExternalAuthorizationParams, type RegisterParams, type RequestMultipartUploadParams, type RequestUploadUrlParams, type Result, type SearchChatroomMessagesParams, type SearchChatsParams, type SetCallHostParams, type SignUploadPartParams, type SignUploadPartsBatchParams, type StartMediaAnalysisParams, type StartVoiceInterviewParams, type TranscribeVoiceInterviewAnswerParams, type TranslateChatroomMessageParams, type TriggerSocialParams, type UpdateCloneParams, type UpdateUserParams, type UploadExternalMindDataParams, VERSION, type WaitForExternalAuthorizationParams, type WaitForExternalCloneInvocationParams };
+export { type AbortMultipartUploadParams, type AdvanceVoiceInterviewParams, ApiError, type ApiErrorOptions, AuthenticationError, type CancelExternalMediaUploadParams, type CancelUploadParams, type CheckChatroomUpdatesParams, type CheckUsernameParams, type ClientOptions, type CompleteMultipartUploadParams, type ConsolidateExternalConversationParams, type CreateCallSessionParams, type CreateChatroomMembershipParams, type CreateChatroomMessageParams, type CreateChatroomParams, type CreateCloneParams, type CreateExternalAuthorizationRequestParams, type CreateTextParams, DEFAULT_BASE_URL, type EndCallSessionParams, type ErrorOptions, type ExchangeExternalAuthorizationParams, type ExternalAuthorizationStatus, type GenerateVoiceInterviewReportParams, type GetActiveCallSessionParams, type GetChatAroundParams, type GetChatParams, type GetChatroomMembershipParams, type GetChatroomMessagesAroundParams, type GetChatroomMessagesParams, type GetChatroomsParams, type GetClonesParams, type GetExternalMediaAnalysisParams, type GetExternalMediaPolicyParams, type GetExternalQuarantinedTextsParams, type GetMindClusterParams, type GetQuotaParams, type GetSoulmateReportParams, type GetTextsParams, type GetTransactionHistoryParams, type GetUserParams, type InspectExternalAuthorizationParams, type InvokeExternalCloneParams, type JoinCallSessionParams, type LeaveCallSessionParams, type ListUploadPartsParams, type LoginParams, type LogoutParams, MindUpload, MindUploadBase, MindUploadConnectionError, MindUploadError, type RagParams, RateLimitError, type RateLimitOptions, type RefreshCallTokenParams, type RefreshExternalAuthorizationParams, type RegisterParams, type RequestExternalMediaUploadParams, type RequestMultipartUploadParams, type RequestUploadUrlParams, type Result, type ReviewExternalQuarantinedTextParams, type SearchChatroomMessagesParams, type SearchChatsParams, type SetCallHostParams, type SignUploadPartParams, type SignUploadPartsBatchParams, type StartExternalMediaAnalysisParams, type StartMediaAnalysisParams, type StartVoiceInterviewParams, type TranscribeVoiceInterviewAnswerParams, type TranslateChatroomMessageParams, type TriggerSocialParams, type UpdateCloneParams, type UpdateUserParams, type UploadExternalMindDataParams, VERSION, type WaitForExternalAuthorizationParams, type WaitForExternalCloneInvocationParams };