@raconte/node-sdk 0.1.0

package/dist/generated/zod.gen.js

@@ -0,0 +1,589 @@
+// This file is auto-generated by @hey-api/openapi-ts
+import { z } from "zod";
+/**
+ * VoiceTestAudioUrlSchema
+ *
+ * Short-lived presigned URL for the voice preview audio. Generated on first request if missing.
+ */
+export const zVoiceTestAudioUrlSchema = z.object({
+    url: z.url(),
+    expiresAt: z.string(),
+    mimeType: z.string(),
+});
+/**
+ * VoiceSchema
+ *
+ * A voice available for interview narration. Provider-specific identifiers are not exposed publicly.
+ */
+export const zVoiceSchema = z.object({
+    id: z
+        .uuid()
+        .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    name: z.string(),
+    language: z.string(),
+    gender: z.enum(["M", "F"]),
+    provider: z.enum(["gradium", "elevenlabs"]),
+});
+/**
+ * VoiceListSchema
+ *
+ * List of voices matching the requested language filter.
+ */
+export const zVoiceListSchema = z.array(zVoiceSchema);
+/**
+ * InterviewMessageAudioUrlSchema
+ *
+ * Short-lived presigned URL for the audio attached to an interview message.
+ */
+export const zInterviewMessageAudioUrlSchema = z.object({
+    url: z.url(),
+    expiresAt: z.string(),
+    mimeType: z.string(),
+});
+/**
+ * InterviewLogSchema
+ *
+ * Schema for a single interview log entry. target is the email or phone for send events, null for status transitions. invitationId points to the specific invitation that the event concerns; null for legacy rows that predate the invitation split.
+ */
+export const zInterviewLogSchema = z.object({
+    id: z
+        .uuid()
+        .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    type: z.enum([
+        "email_sent",
+        "sms_sent",
+        "started",
+        "completed",
+        "cancelled",
+        "reactivated",
+        "archived",
+        "restored",
+    ]),
+    target: z.union([z.string(), z.null()]),
+    invitationId: z.union([
+        z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+        z.null(),
+    ]),
+    createdAt: z.string(),
+});
+/**
+ * InterviewLogListSchema
+ *
+ * Chronological history of events on an interview, most recent first.
+ */
+export const zInterviewLogListSchema = z.array(zInterviewLogSchema);
+/**
+ * InterviewMessageSchema
+ *
+ * Schema for an interview message. audioAssetId is null when no audio was recorded for that message (legacy messages, deleted audio, etc.). audioPeaks is a base64-encoded uint8 waveform summary of the attached audio (128 amplitude bins, 0-255), null when no audio is attached or when peaks have not been computed yet for a legacy asset. sentiment is populated only on user-role messages once async insights generation has completed.
+ */
+export const zInterviewMessageSchema = z.object({
+    id: z
+        .uuid()
+        .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    role: z.enum(["user", "assistant", "system"]),
+    content: z.string(),
+    audioAssetId: z.union([
+        z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+        z.null(),
+    ]),
+    audioDurationMs: z.union([z.int().gte(0).lte(9007199254740991), z.null()]),
+    audioPeaks: z.union([z.string(), z.null()]),
+    sentiment: z.union([z.enum(["positive", "neutral", "negative"]), z.null()]),
+    createdAt: z.string(),
+});
+/**
+ * InterviewInvitationStatus
+ *
+ * Lifecycle state of an invitation (the unit that gets sent and produces a transcript).
+ */
+export const zInterviewInvitationStatus = z.enum([
+    "ready",
+    "in_progress",
+    "completed",
+    "cancelled",
+]);
+/**
+ * InterviewInvitationSchema
+ *
+ * Full interview invitation payload including transcript messages. summary and per-message sentiments are populated asynchronously once the invitation reaches the completed state.
+ */
+export const zInterviewInvitationSchema = z.object({
+    id: z
+        .uuid()
+        .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    interviewId: z
+        .uuid()
+        .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    slug: z.string(),
+    status: zInterviewInvitationStatus,
+    name: z.union([z.string(), z.null()]),
+    recipientEmail: z.union([z.string(), z.null()]),
+    recipientPhone: z.union([z.string(), z.null()]),
+    summary: z.union([z.string(), z.null()]),
+    archivedAt: z.union([z.string(), z.null()]),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    messages: z.optional(z.array(zInterviewMessageSchema)),
+});
+/**
+ * InterviewInvitationListSchema
+ *
+ * List of interview invitations belonging to an interview.
+ */
+export const zInterviewInvitationListSchema = z.array(zInterviewInvitationSchema);
+/**
+ * RestoreInterviewResponse
+ *
+ * Response for restoring an archived interview
+ */
+export const zRestoreInterviewResponse = z.object({
+    success: z.boolean(),
+});
+/**
+ * ArchiveInterviewResponse
+ *
+ * Response for archiving an interview
+ */
+export const zArchiveInterviewResponse = z.object({
+    success: z.boolean(),
+});
+/**
+ * InterviewInvitationSummarySchema
+ *
+ * Lightweight invitation row used in lists. summaryAvailable is true once async insights have produced a summary for this invitation. hasMessages is true as soon as the invitation has at least one transcript message persisted.
+ */
+export const zInterviewInvitationSummarySchema = z.object({
+    id: z
+        .uuid()
+        .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    slug: z.string(),
+    status: z.enum(["ready", "in_progress", "completed", "cancelled"]),
+    name: z.union([z.string(), z.null()]),
+    recipientEmail: z.union([z.string(), z.null()]),
+    recipientPhone: z.union([z.string(), z.null()]),
+    archivedAt: z.union([z.string(), z.null()]),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    hasMessages: z.boolean(),
+    summaryAvailable: z.boolean(),
+});
+/**
+ * InterviewStatusCounts
+ *
+ * Number of invitations in each status for a given interview, archived invitations excluded.
+ */
+export const zInterviewStatusCounts = z.object({
+    ready: z.int().gte(0).lte(9007199254740991),
+    in_progress: z.int().gte(0).lte(9007199254740991),
+    completed: z.int().gte(0).lte(9007199254740991),
+    cancelled: z.int().gte(0).lte(9007199254740991),
+});
+/**
+ * InterviewSchema
+ *
+ * Schema for an interview definition. invitations is the list of recipients this interview has been (or will be) sent to. When invitationsCount == 1, the interview is in "single" mode; when > 1, it is a bulk send.
+ */
+export const zInterviewSchema = z.object({
+    id: z
+        .uuid()
+        .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    title: z.union([z.string(), z.null()]),
+    prompt: z.string(),
+    intro: z.union([z.string(), z.null()]),
+    firstMessage: z.union([z.string(), z.null()]),
+    locale: z.union([z.string(), z.null()]),
+    voiceId: z
+        .uuid()
+        .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    maxMinutes: z.int().gt(0).lte(9007199254740991),
+    maxResponses: z.int().gt(0).lte(9007199254740991),
+    disableOrgSystemPrompt: z.boolean(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    archivedAt: z.union([z.string(), z.null()]),
+    invitationsCount: z.int().gte(0).lte(9007199254740991),
+    invitationsByStatus: zInterviewStatusCounts,
+    invitationsArchivedCount: z.int().gte(0).lte(9007199254740991),
+    invitations: z.array(zInterviewInvitationSummarySchema),
+});
+/**
+ * InterviewListSchema
+ *
+ * Schema for a list of interviews
+ */
+export const zInterviewListSchema = z.array(zInterviewSchema);
+/**
+ * CreatedInterviewSchema
+ *
+ * Schema for a newly created interview, including the slug of its initial invitation.
+ */
+export const zCreatedInterviewSchema = z.object({
+    id: z
+        .uuid()
+        .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    invitationId: z
+        .uuid()
+        .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    slug: z.string(),
+    status: z.enum(["ready", "in_progress", "completed", "cancelled"]),
+});
+/**
+ * CreatedInterviewsResponse
+ *
+ * Response for interview creation
+ */
+export const zCreatedInterviewsResponse = z.array(zCreatedInterviewSchema);
+export const zInterviewsControllerListData = z.object({
+    body: z.optional(z.never()),
+    path: z.optional(z.never()),
+    query: z.optional(z.object({
+        archived: z.optional(z.boolean()),
+    })),
+});
+/**
+ * Schema for a list of interviews
+ */
+export const zInterviewsControllerListResponse = zInterviewListSchema;
+export const zInterviewsControllerCreateData = z.object({
+    body: z.object({
+        prompt: z.string().min(10),
+        title: z.optional(z.string()),
+        intro: z.optional(z.string()),
+        firstMessage: z.optional(z.string()),
+        email: z.optional(z
+            .email()
+            .regex(/^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$/)),
+        phone: z.optional(z.string()),
+        invitees: z.optional(z.array(z.object({
+            name: z.optional(z.string()),
+            email: z.optional(z
+                .email()
+                .regex(/^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$/)),
+            phone: z.optional(z.string()),
+        }))),
+        locale: z.optional(z.string()),
+        voiceId: z.optional(z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/)),
+    }),
+    path: z.optional(z.never()),
+    query: z.optional(z.never()),
+});
+/**
+ * Response for interview creation
+ */
+export const zInterviewsControllerCreateResponse = zCreatedInterviewsResponse;
+export const zInterviewsControllerGetOneData = z.object({
+    body: z.optional(z.never()),
+    path: z.object({
+        id: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Schema for an interview definition. invitations is the list of recipients this interview has been (or will be) sent to. When invitationsCount == 1, the interview is in "single" mode; when > 1, it is a bulk send.
+ */
+export const zInterviewsControllerGetOneResponse = zInterviewSchema;
+export const zInterviewsControllerUpdateData = z.object({
+    body: z.object({
+        title: z.optional(z.string()),
+        prompt: z.optional(z.string().min(10)),
+        intro: z.optional(z.string()),
+        firstMessage: z.optional(z.string()),
+        locale: z.optional(z.string().min(2).max(10)),
+        maxMinutes: z.optional(z.int().gt(0).lte(9007199254740991)),
+        maxResponses: z.optional(z.int().gt(0).lte(9007199254740991)),
+        disableOrgSystemPrompt: z.optional(z.boolean()),
+        voiceId: z.optional(z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/)),
+    }),
+    path: z.object({
+        id: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Schema for an interview definition. invitations is the list of recipients this interview has been (or will be) sent to. When invitationsCount == 1, the interview is in "single" mode; when > 1, it is a bulk send.
+ */
+export const zInterviewsControllerUpdateResponse = zInterviewSchema;
+export const zInterviewsControllerRegenerateIntroData = z.object({
+    body: z.optional(z.never()),
+    path: z.object({
+        id: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Schema for an interview definition. invitations is the list of recipients this interview has been (or will be) sent to. When invitationsCount == 1, the interview is in "single" mode; when > 1, it is a bulk send.
+ */
+export const zInterviewsControllerRegenerateIntroResponse = zInterviewSchema;
+export const zInterviewsControllerRegenerateFirstMessageData = z.object({
+    body: z.optional(z.never()),
+    path: z.object({
+        id: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Schema for an interview definition. invitations is the list of recipients this interview has been (or will be) sent to. When invitationsCount == 1, the interview is in "single" mode; when > 1, it is a bulk send.
+ */
+export const zInterviewsControllerRegenerateFirstMessageResponse = zInterviewSchema;
+export const zInterviewsControllerArchiveData = z.object({
+    body: z.optional(z.never()),
+    path: z.object({
+        id: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Response for archiving an interview
+ */
+export const zInterviewsControllerArchiveResponse = zArchiveInterviewResponse;
+export const zInterviewsControllerRestoreData = z.object({
+    body: z.optional(z.never()),
+    path: z.object({
+        id: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Response for restoring an archived interview
+ */
+export const zInterviewsControllerRestoreResponse = zRestoreInterviewResponse;
+export const zInterviewsControllerGetLogsData = z.object({
+    body: z.optional(z.never()),
+    path: z.object({
+        id: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Chronological history of events on an interview, most recent first.
+ */
+export const zInterviewsControllerGetLogsResponse = zInterviewLogListSchema;
+export const zInterviewInvitationsControllerListData = z.object({
+    body: z.optional(z.never()),
+    path: z.object({
+        id: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * List of interview invitations belonging to an interview.
+ */
+export const zInterviewInvitationsControllerListResponse = zInterviewInvitationListSchema;
+export const zInterviewInvitationsControllerCreateData = z.object({
+    body: z.object({
+        name: z.optional(z.string()),
+        email: z.optional(z
+            .email()
+            .regex(/^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$/)),
+        phone: z.optional(z.string()),
+    }),
+    path: z.object({
+        id: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Full interview invitation payload including transcript messages. summary and per-message sentiments are populated asynchronously once the invitation reaches the completed state.
+ */
+export const zInterviewInvitationsControllerCreateResponse = zInterviewInvitationSchema;
+export const zInterviewInvitationsControllerCreateBulkData = z.object({
+    body: z.object({
+        invitees: z
+            .array(z.object({
+            name: z.optional(z.string()),
+            email: z.optional(z
+                .email()
+                .regex(/^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$/)),
+            phone: z.optional(z.string()),
+        }))
+            .min(1),
+    }),
+    path: z.object({
+        id: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * List of interview invitations belonging to an interview.
+ */
+export const zInterviewInvitationsControllerCreateBulkResponse = zInterviewInvitationListSchema;
+export const zInterviewInvitationsControllerGetOneData = z.object({
+    body: z.optional(z.never()),
+    path: z.object({
+        invitationId: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Full interview invitation payload including transcript messages. summary and per-message sentiments are populated asynchronously once the invitation reaches the completed state.
+ */
+export const zInterviewInvitationsControllerGetOneResponse = zInterviewInvitationSchema;
+export const zInterviewInvitationsControllerUpdateData = z.object({
+    body: z.object({
+        name: z.optional(z.union([z.string(), z.null()])),
+    }),
+    path: z.object({
+        invitationId: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Full interview invitation payload including transcript messages. summary and per-message sentiments are populated asynchronously once the invitation reaches the completed state.
+ */
+export const zInterviewInvitationsControllerUpdateResponse = zInterviewInvitationSchema;
+export const zInterviewInvitationsControllerSendData = z.object({
+    body: z.object({
+        email: z.optional(z
+            .email()
+            .regex(/^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$/)),
+        phone: z.optional(z.string()),
+    }),
+    path: z.object({
+        invitationId: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Full interview invitation payload including transcript messages. summary and per-message sentiments are populated asynchronously once the invitation reaches the completed state.
+ */
+export const zInterviewInvitationsControllerSendResponse = zInterviewInvitationSchema;
+export const zInterviewInvitationsControllerCancelData = z.object({
+    body: z.optional(z.never()),
+    path: z.object({
+        invitationId: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Full interview invitation payload including transcript messages. summary and per-message sentiments are populated asynchronously once the invitation reaches the completed state.
+ */
+export const zInterviewInvitationsControllerCancelResponse = zInterviewInvitationSchema;
+export const zInterviewInvitationsControllerReactivateData = z.object({
+    body: z.optional(z.never()),
+    path: z.object({
+        invitationId: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Full interview invitation payload including transcript messages. summary and per-message sentiments are populated asynchronously once the invitation reaches the completed state.
+ */
+export const zInterviewInvitationsControllerReactivateResponse = zInterviewInvitationSchema;
+export const zInterviewInvitationsControllerArchiveData = z.object({
+    body: z.optional(z.never()),
+    path: z.object({
+        invitationId: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Full interview invitation payload including transcript messages. summary and per-message sentiments are populated asynchronously once the invitation reaches the completed state.
+ */
+export const zInterviewInvitationsControllerArchiveResponse = zInterviewInvitationSchema;
+export const zInterviewInvitationsControllerRestoreData = z.object({
+    body: z.optional(z.never()),
+    path: z.object({
+        invitationId: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Full interview invitation payload including transcript messages. summary and per-message sentiments are populated asynchronously once the invitation reaches the completed state.
+ */
+export const zInterviewInvitationsControllerRestoreResponse = zInterviewInvitationSchema;
+export const zInterviewInvitationsControllerGetLogsData = z.object({
+    body: z.optional(z.never()),
+    path: z.object({
+        invitationId: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Chronological history of events on an interview, most recent first.
+ */
+export const zInterviewInvitationsControllerGetLogsResponse = zInterviewLogListSchema;
+export const zInterviewInvitationsControllerGetMessageAudioUrlData = z.object({
+    body: z.optional(z.never()),
+    path: z.object({
+        messageId: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+        invitationId: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Short-lived presigned URL for the audio attached to an interview message.
+ */
+export const zInterviewInvitationsControllerGetMessageAudioUrlResponse = zInterviewMessageAudioUrlSchema;
+export const zVoicesControllerListData = z.object({
+    body: z.optional(z.never()),
+    path: z.optional(z.never()),
+    query: z.optional(z.object({
+        language: z.optional(z.string().min(2).max(8)),
+    })),
+});
+/**
+ * List of voices matching the requested language filter.
+ */
+export const zVoicesControllerListResponse = zVoiceListSchema;
+export const zVoicesControllerGetTestAudioUrlData = z.object({
+    body: z.optional(z.never()),
+    path: z.object({
+        id: z
+            .uuid()
+            .regex(/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/),
+    }),
+    query: z.optional(z.never()),
+});
+/**
+ * Short-lived presigned URL for the voice preview audio. Generated on first request if missing.
+ */
+export const zVoicesControllerGetTestAudioUrlResponse = zVoiceTestAudioUrlSchema;

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @raconte/node-sdk: typed SDK for the public Raconte API (interviews and invitations).
+ *
+ * The SDK surface mirrors the routes guarded by `ApiKeyOrgGuard` server-side, the same set
+ * exposed by the MCP server and documented at https://raconte.ai. Generated code lives under
+ * `./generated`; this entry adds the authenticated client factory.
+ */
+export { createRaconteClient, RACONTE_API_BASE_URL } from './client';
+export type { RaconteClientOptions } from './client';
+export { createClient, createConfig } from './generated/client';
+export type { Client, Config, Options } from './generated/client';
+export * from './generated/sdk.gen';
+export * from './generated/types.gen';

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * @raconte/node-sdk: typed SDK for the public Raconte API (interviews and invitations).
+ *
+ * The SDK surface mirrors the routes guarded by `ApiKeyOrgGuard` server-side, the same set
+ * exposed by the MCP server and documented at https://raconte.ai. Generated code lives under
+ * `./generated`; this entry adds the authenticated client factory.
+ */
+export { createRaconteClient, RACONTE_API_BASE_URL } from './client';
+export { createClient, createConfig } from './generated/client';
+export * from './generated/sdk.gen';
+export * from './generated/types.gen';

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@raconte/node-sdk",
+  "type": "module",
+  "version": "0.1.0",
+  "description": "Typed TypeScript SDK for the public Raconte API (interviews and invitations). Generated from the public OpenAPI spec.",
+  "license": "MIT",
+  "homepage": "https://raconte.ai",
+  "keywords": [
+    "raconte",
+    "sdk",
+    "interviews",
+    "api",
+    "openapi"
+  ],
+  "exports": {
+    ".": "./src/index.ts",
+    "./zod": "./src/generated/zod.gen.ts"
+  },
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js",
+        "default": "./dist/index.js"
+      },
+      "./zod": {
+        "types": "./dist/generated/zod.gen.d.ts",
+        "import": "./dist/generated/zod.gen.js",
+        "default": "./dist/generated/zod.gen.js"
+      }
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  },
+  "scripts": {
+    "generate": "openapi-ts -f ./openapi-ts.config.ts",
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@hey-api/openapi-ts": "^0.90.3",
+    "@types/node": "^24.10.7",
+    "typescript": "^5.9.3"
+  }
+}