mindupload 1.13.1 → 1.15.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.13.1-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.15.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 52 operations, grouped by area:
+All 56 operations, grouped by area:
 
 ### AI Consciousnesses
 
@@ -233,6 +233,15 @@ All 52 operations, grouped by area:
 | `getUser(...)` | Fetch the signed-in user's profile. |
 | `updateUser(...)` | Update the signed-in user's profile. |
 
+### Voice Interviews
+
+| Method | Description |
+| --- | --- |
+| `advanceVoiceInterview(...)` | Accept, edit, skip, re-record or abandon the question the user is on, and receive the next one. |
+| `generateVoiceInterviewReport(...)` | Write a finished interview up as prose, in first, second or third person. |
+| `startVoiceInterview(...)` | Begin a spoken interview with one of your end-users, or hand back one they have not finished with. |
+| `transcribeVoiceInterviewAnswer(...)` | Turn one recorded spoken answer into text for the user to check before it is accepted. |
+
 ## Other SDKs
 
 Same API, same conventions, in every language:

package/dist/index.cjs

@@ -75,7 +75,7 @@ var MindUploadConnectionError = class extends MindUploadError {
 };
 
 // src/version.ts
-var VERSION = "1.13.1";
+var VERSION = "1.15.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://partner.mindupload.app";
@@ -634,6 +634,39 @@ var MindUpload = class extends MindUploadBase {
   updateUser(params = {}) {
     return this.request("update_user", params);
   }
+  // --- Voice Interviews ---
+  /** 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.
+   * @see https://docs.mindupload.app
+   */
+  advanceVoiceInterview(params = {}) {
+    return this.request("advance_voice_interview", params);
+  }
+  /** 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.
+   * @see https://docs.mindupload.app
+   */
+  generateVoiceInterviewReport(params = {}) {
+    return this.request("generate_voice_interview_report", params);
+  }
+  /** 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.
+   * @see https://docs.mindupload.app
+   */
+  startVoiceInterview(params = {}) {
+    return this.request("start_voice_interview", params);
+  }
+  /** Turn one recorded spoken answer into text for the user to check before it is accepted.
+   *
+   * Response fields: success, error_message, recognized_text.
+   * @see https://docs.mindupload.app
+   */
+  transcribeVoiceInterviewAnswer(params = {}) {
+    return this.request("transcribe_voice_interview_answer", params);
+  }
   /** Poll owner consent at the server-advised cadence until exchange succeeds. */
   async waitForExternalAuthorization(params) {
     const deadline = Date.now() + (params.timeoutMs ?? 6e5);

package/dist/index.d.cts

@@ -47,6 +47,7 @@ interface CreateCloneParams {
     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;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
     codename?: string;
     nickname?: string;
     gender?: string;
@@ -69,6 +70,7 @@ interface UpdateCloneParams {
     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;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
     codename?: string;
     nickname?: string;
     gender?: string;
@@ -96,6 +98,8 @@ interface LoginParams {
     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;
+    /** Optional. A stable identifier for the device or app install signing in. Send the same value every time from one install: a new sign-in then replaces only the earlier session of that install and leaves the other devices of the user signed in. */
+    visitorId?: string;
 }
 interface LogoutParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
@@ -122,6 +126,8 @@ interface RegisterParams {
     phoneNumber?: string;
     avatarId?: string;
     acceptChatroomInvitationByOthers?: boolean;
+    /** Optional. The same device or app install identifier as for login; the first session of the new account is kept under it. */
+    visitorId?: string;
 }
 interface CheckChatroomUpdatesParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
@@ -310,6 +316,7 @@ interface GetChatParams {
     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;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
     codename?: string;
 }
 interface GetChatAroundParams {
@@ -335,6 +342,7 @@ interface RagParams {
     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;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
     codename?: string;
     text?: string;
     /** Chatroom id as returned by chatroom operations. */
@@ -454,7 +462,7 @@ interface UploadExternalMindDataParams {
     /** AI consciousness id as returned by clone operations. */
     cloneId: string;
     text: string;
-    textType?: 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. */
     idempotencyKey?: string;
     sourceLabel?: string;
@@ -466,6 +474,7 @@ interface GetMindClusterParams {
     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;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
     codename?: string;
     nodeId?: string;
     textsOffset?: number;
@@ -621,6 +630,7 @@ interface RequestMultipartUploadParams {
     /** The kind of media: `image`, `video`, or `audio`. */
     mediaType?: string;
     hasThumbnail?: boolean;
+    thumbnailFileSizeBytes?: number;
 }
 interface RequestUploadUrlParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
@@ -635,6 +645,7 @@ interface RequestUploadUrlParams {
     /** The kind of media: `image`, `video`, or `audio`. */
     mediaType?: string;
     hasThumbnail?: boolean;
+    thumbnailFileSizeBytes?: number;
 }
 interface SignUploadPartParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
@@ -685,12 +696,13 @@ interface CreateTextParams {
     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;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
     codename?: string;
     /** AI consciousness id as returned by clone operations. */
     cloneId?: string;
     /** The mind data itself. At most 50000 characters, counted in Unicode code points; longer text is rejected with 400 and nothing is stored. */
     text?: string;
-    type?: string;
+    type?: "memory" | "persona" | "conscious";
 }
 interface GetTextsParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
@@ -710,8 +722,9 @@ interface GetTextsParams {
     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;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
     codename?: string;
-    type?: string;
+    type?: "memory" | "persona" | "conscious";
 }
 interface GetTransactionHistoryParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
@@ -748,7 +761,9 @@ interface UpdateUserParams {
     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;
+    /** A new email address for the account. Over the Partner API it is saved unverified, and the Partner API never uses it to reset the password. */
     email?: string;
+    /** Only a code the MindUpload app emailed to the new address for this account is accepted. The Partner API cannot send one, so leave this out; a wrong code fails the whole update. */
     emailVerificationCode?: string;
     firstName?: string;
     lastName?: string;
@@ -759,6 +774,66 @@ interface UpdateUserParams {
     avatarId?: string;
     acceptChatroomInvitationByOthers?: boolean;
 }
+interface AdvanceVoiceInterviewParams {
+    /** 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;
+    /** Identifies one interview. Returned by start_voice_interview and required by every later call. */
+    interviewSessionId?: string;
+    /** Which question this call is about. Send back the one you were last given; it makes the call safe to retry. */
+    turnIndex?: number;
+    /** What the user did with the question: `confirm` accepts the transcript unchanged, `edit` accepts text they corrected, `skip` moves on without an answer, `re_answer` discards the recording and re-serves the same question, and `abort` ends the interview and discards it. `skip`, `re_answer` and `abort` must not carry `confirmed_text`. */
+    action?: "confirm" | "edit" | "skip" | "re_answer" | "abort";
+    /** The answer text the user accepted, after any correction they made. */
+    confirmedText?: string;
+}
+interface GenerateVoiceInterviewReportParams {
+    /** 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;
+    /** Identifies one interview. Returned by start_voice_interview and required by every later call. */
+    interviewSessionId?: string;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
+    codename?: string;
+    /** The owner's answer to whether other people may read this consciousness's description. True publishes the description already written for it; false withdraws it and erases the text. A newly written description is never readable by anybody else until this says so, so the person can read what is being said about them first. */
+    shareDescription?: boolean;
+    /** Which voice to write in. `first_person` reads as the user themselves and is what a mind-data upload wants; `second_person` addresses them; `third_person` describes them for a reader who was not present and leaves out anything they would not want quoted. */
+    person?: "first_person" | "second_person" | "third_person";
+}
+interface StartVoiceInterviewParams {
+    /** 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;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
+    codename?: string;
+    /** AI consciousness id as returned by clone operations. */
+    cloneId?: string;
+    /** Which question set to run. `mind_upload_first_time` is a long first-run interview whose write-up is meant for a mind-data upload; `memory_refresh` and `personality_refresh` are short repeatable ones that ask something different each time; `matchmaking` surfaces what someone values; `guided_reflection` gives them somewhere to think out loud, and is not counseling. */
+    templateKey?: "mind_upload_first_time" | "memory_refresh" | "personality_refresh" | "matchmaking" | "guided_reflection";
+}
+interface TranscribeVoiceInterviewAnswerParams {
+    /** 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;
+    /** Identifies one interview. Returned by start_voice_interview and required by every later call. */
+    interviewSessionId?: string;
+    /** The user's recorded answer, base64-encoded. Discarded after transcription; never stored. */
+    answerAudioBase64?: string;
+    /** Container of the recording being sent. */
+    answerAudioContentType?: string;
+}
 /**
  * Client for the Mind Upload partner API. Create one with your partner key,
  * then call any operation. Every method resolves to a {@link Result} and
@@ -1077,6 +1152,30 @@ declare class MindUpload extends MindUploadBase {
      * @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.
+     * @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.
+     * @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.
+     * @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.
+     * @see https://docs.mindupload.app
+     */
+    transcribeVoiceInterviewAnswer(params?: TranscribeVoiceInterviewAnswerParams): Promise<Result>;
     /** Poll owner consent at the server-advised cadence until exchange succeeds. */
     waitForExternalAuthorization(params: WaitForExternalAuthorizationParams): Promise<Result>;
     /** Invoke a clone and wait out slow generation via idempotent retries.
@@ -1127,6 +1226,6 @@ declare class MindUploadConnectionError extends MindUploadError {
     constructor(message: string, options?: ErrorOptions);
 }
 
-declare const VERSION = "1.13.1";
+declare const VERSION = "1.15.0";
 
-export { type AbortMultipartUploadParams, 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 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 TranslateChatroomMessageParams, type TriggerSocialParams, type UpdateCloneParams, type UpdateUserParams, type UploadExternalMindDataParams, VERSION, type WaitForExternalAuthorizationParams, type WaitForExternalCloneInvocationParams };
+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 };

package/dist/index.d.ts

@@ -47,6 +47,7 @@ interface CreateCloneParams {
     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;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
     codename?: string;
     nickname?: string;
     gender?: string;
@@ -69,6 +70,7 @@ interface UpdateCloneParams {
     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;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
     codename?: string;
     nickname?: string;
     gender?: string;
@@ -96,6 +98,8 @@ interface LoginParams {
     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;
+    /** Optional. A stable identifier for the device or app install signing in. Send the same value every time from one install: a new sign-in then replaces only the earlier session of that install and leaves the other devices of the user signed in. */
+    visitorId?: string;
 }
 interface LogoutParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
@@ -122,6 +126,8 @@ interface RegisterParams {
     phoneNumber?: string;
     avatarId?: string;
     acceptChatroomInvitationByOthers?: boolean;
+    /** Optional. The same device or app install identifier as for login; the first session of the new account is kept under it. */
+    visitorId?: string;
 }
 interface CheckChatroomUpdatesParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
@@ -310,6 +316,7 @@ interface GetChatParams {
     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;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
     codename?: string;
 }
 interface GetChatAroundParams {
@@ -335,6 +342,7 @@ interface RagParams {
     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;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
     codename?: string;
     text?: string;
     /** Chatroom id as returned by chatroom operations. */
@@ -454,7 +462,7 @@ interface UploadExternalMindDataParams {
     /** AI consciousness id as returned by clone operations. */
     cloneId: string;
     text: string;
-    textType?: 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. */
     idempotencyKey?: string;
     sourceLabel?: string;
@@ -466,6 +474,7 @@ interface GetMindClusterParams {
     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;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
     codename?: string;
     nodeId?: string;
     textsOffset?: number;
@@ -621,6 +630,7 @@ interface RequestMultipartUploadParams {
     /** The kind of media: `image`, `video`, or `audio`. */
     mediaType?: string;
     hasThumbnail?: boolean;
+    thumbnailFileSizeBytes?: number;
 }
 interface RequestUploadUrlParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
@@ -635,6 +645,7 @@ interface RequestUploadUrlParams {
     /** The kind of media: `image`, `video`, or `audio`. */
     mediaType?: string;
     hasThumbnail?: boolean;
+    thumbnailFileSizeBytes?: number;
 }
 interface SignUploadPartParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
@@ -685,12 +696,13 @@ interface CreateTextParams {
     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;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
     codename?: string;
     /** AI consciousness id as returned by clone operations. */
     cloneId?: string;
     /** The mind data itself. At most 50000 characters, counted in Unicode code points; longer text is rejected with 400 and nothing is stored. */
     text?: string;
-    type?: string;
+    type?: "memory" | "persona" | "conscious";
 }
 interface GetTextsParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
@@ -710,8 +722,9 @@ interface GetTextsParams {
     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;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
     codename?: string;
-    type?: string;
+    type?: "memory" | "persona" | "conscious";
 }
 interface GetTransactionHistoryParams {
     /** BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages. */
@@ -748,7 +761,9 @@ interface UpdateUserParams {
     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;
+    /** A new email address for the account. Over the Partner API it is saved unverified, and the Partner API never uses it to reset the password. */
     email?: string;
+    /** Only a code the MindUpload app emailed to the new address for this account is accepted. The Partner API cannot send one, so leave this out; a wrong code fails the whole update. */
     emailVerificationCode?: string;
     firstName?: string;
     lastName?: string;
@@ -759,6 +774,66 @@ interface UpdateUserParams {
     avatarId?: string;
     acceptChatroomInvitationByOthers?: boolean;
 }
+interface AdvanceVoiceInterviewParams {
+    /** 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;
+    /** Identifies one interview. Returned by start_voice_interview and required by every later call. */
+    interviewSessionId?: string;
+    /** Which question this call is about. Send back the one you were last given; it makes the call safe to retry. */
+    turnIndex?: number;
+    /** What the user did with the question: `confirm` accepts the transcript unchanged, `edit` accepts text they corrected, `skip` moves on without an answer, `re_answer` discards the recording and re-serves the same question, and `abort` ends the interview and discards it. `skip`, `re_answer` and `abort` must not carry `confirmed_text`. */
+    action?: "confirm" | "edit" | "skip" | "re_answer" | "abort";
+    /** The answer text the user accepted, after any correction they made. */
+    confirmedText?: string;
+}
+interface GenerateVoiceInterviewReportParams {
+    /** 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;
+    /** Identifies one interview. Returned by start_voice_interview and required by every later call. */
+    interviewSessionId?: string;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
+    codename?: string;
+    /** The owner's answer to whether other people may read this consciousness's description. True publishes the description already written for it; false withdraws it and erases the text. A newly written description is never readable by anybody else until this says so, so the person can read what is being said about them first. */
+    shareDescription?: boolean;
+    /** Which voice to write in. `first_person` reads as the user themselves and is what a mind-data upload wants; `second_person` addresses them; `third_person` describes them for a reader who was not present and leaves out anything they would not want quoted. */
+    person?: "first_person" | "second_person" | "third_person";
+}
+interface StartVoiceInterviewParams {
+    /** 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;
+    /** Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone. */
+    codename?: string;
+    /** AI consciousness id as returned by clone operations. */
+    cloneId?: string;
+    /** Which question set to run. `mind_upload_first_time` is a long first-run interview whose write-up is meant for a mind-data upload; `memory_refresh` and `personality_refresh` are short repeatable ones that ask something different each time; `matchmaking` surfaces what someone values; `guided_reflection` gives them somewhere to think out loud, and is not counseling. */
+    templateKey?: "mind_upload_first_time" | "memory_refresh" | "personality_refresh" | "matchmaking" | "guided_reflection";
+}
+interface TranscribeVoiceInterviewAnswerParams {
+    /** 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;
+    /** Identifies one interview. Returned by start_voice_interview and required by every later call. */
+    interviewSessionId?: string;
+    /** The user's recorded answer, base64-encoded. Discarded after transcription; never stored. */
+    answerAudioBase64?: string;
+    /** Container of the recording being sent. */
+    answerAudioContentType?: string;
+}
 /**
  * Client for the Mind Upload partner API. Create one with your partner key,
  * then call any operation. Every method resolves to a {@link Result} and
@@ -1077,6 +1152,30 @@ declare class MindUpload extends MindUploadBase {
      * @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.
+     * @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.
+     * @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.
+     * @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.
+     * @see https://docs.mindupload.app
+     */
+    transcribeVoiceInterviewAnswer(params?: TranscribeVoiceInterviewAnswerParams): Promise<Result>;
     /** Poll owner consent at the server-advised cadence until exchange succeeds. */
     waitForExternalAuthorization(params: WaitForExternalAuthorizationParams): Promise<Result>;
     /** Invoke a clone and wait out slow generation via idempotent retries.
@@ -1127,6 +1226,6 @@ declare class MindUploadConnectionError extends MindUploadError {
     constructor(message: string, options?: ErrorOptions);
 }
 
-declare const VERSION = "1.13.1";
+declare const VERSION = "1.15.0";
 
-export { type AbortMultipartUploadParams, 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 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 TranslateChatroomMessageParams, type TriggerSocialParams, type UpdateCloneParams, type UpdateUserParams, type UploadExternalMindDataParams, VERSION, type WaitForExternalAuthorizationParams, type WaitForExternalCloneInvocationParams };
+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 };

package/dist/index.js

@@ -41,7 +41,7 @@ var MindUploadConnectionError = class extends MindUploadError {
 };
 
 // src/version.ts
-var VERSION = "1.13.1";
+var VERSION = "1.15.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://partner.mindupload.app";
@@ -600,6 +600,39 @@ var MindUpload = class extends MindUploadBase {
   updateUser(params = {}) {
     return this.request("update_user", params);
   }
+  // --- Voice Interviews ---
+  /** 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.
+   * @see https://docs.mindupload.app
+   */
+  advanceVoiceInterview(params = {}) {
+    return this.request("advance_voice_interview", params);
+  }
+  /** 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.
+   * @see https://docs.mindupload.app
+   */
+  generateVoiceInterviewReport(params = {}) {
+    return this.request("generate_voice_interview_report", params);
+  }
+  /** 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.
+   * @see https://docs.mindupload.app
+   */
+  startVoiceInterview(params = {}) {
+    return this.request("start_voice_interview", params);
+  }
+  /** Turn one recorded spoken answer into text for the user to check before it is accepted.
+   *
+   * Response fields: success, error_message, recognized_text.
+   * @see https://docs.mindupload.app
+   */
+  transcribeVoiceInterviewAnswer(params = {}) {
+    return this.request("transcribe_voice_interview_answer", params);
+  }
   /** Poll owner consent at the server-advised cadence until exchange succeeds. */
   async waitForExternalAuthorization(params) {
     const deadline = Date.now() + (params.timeoutMs ?? 6e5);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindupload",
-  "version": "1.13.1",
+  "version": "1.15.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",