@mistralai/mistralai 1.9.18 → 1.10.0

package/src/models/components/outputcontentchunks.ts

@@ -44,12 +44,12 @@ import {
 } from "./toolreferencechunk.js";
 
 export type OutputContentChunks =
+  | ToolFileChunk
+  | ToolReferenceChunk
   | TextChunk
   | ImageURLChunk
   | DocumentURLChunk
-  | ThinkChunk
-  | ToolFileChunk
-  | ToolReferenceChunk;
+  | ThinkChunk;
 
 /** @internal */
 export const OutputContentChunks$inboundSchema: z.ZodType<
@@ -57,22 +57,22 @@ export const OutputContentChunks$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.union([
+  ToolFileChunk$inboundSchema,
+  ToolReferenceChunk$inboundSchema,
   TextChunk$inboundSchema,
   ImageURLChunk$inboundSchema,
   DocumentURLChunk$inboundSchema,
   ThinkChunk$inboundSchema,
-  ToolFileChunk$inboundSchema,
-  ToolReferenceChunk$inboundSchema,
 ]);
 
 /** @internal */
 export type OutputContentChunks$Outbound =
+  | ToolFileChunk$Outbound
+  | ToolReferenceChunk$Outbound
   | TextChunk$Outbound
   | ImageURLChunk$Outbound
   | DocumentURLChunk$Outbound
-  | ThinkChunk$Outbound
-  | ToolFileChunk$Outbound
-  | ToolReferenceChunk$Outbound;
+  | ThinkChunk$Outbound;
 
 /** @internal */
 export const OutputContentChunks$outboundSchema: z.ZodType<
@@ -80,12 +80,12 @@ export const OutputContentChunks$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   OutputContentChunks
 > = z.union([
+  ToolFileChunk$outboundSchema,
+  ToolReferenceChunk$outboundSchema,
   TextChunk$outboundSchema,
   ImageURLChunk$outboundSchema,
   DocumentURLChunk$outboundSchema,
   ThinkChunk$outboundSchema,
-  ToolFileChunk$outboundSchema,
-  ToolReferenceChunk$outboundSchema,
 ]);
 
 /**

package/src/models/components/systemmessage.ts

@@ -8,13 +8,13 @@ import { ClosedEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 import {
-  TextChunk,
-  TextChunk$inboundSchema,
-  TextChunk$Outbound,
-  TextChunk$outboundSchema,
-} from "./textchunk.js";
+  SystemMessageContentChunks,
+  SystemMessageContentChunks$inboundSchema,
+  SystemMessageContentChunks$Outbound,
+  SystemMessageContentChunks$outboundSchema,
+} from "./systemmessagecontentchunks.js";
 
-export type SystemMessageContent = string | Array<TextChunk>;
+export type SystemMessageContent = string | Array<SystemMessageContentChunks>;
 
 export const Role = {
   System: "system",
@@ -22,7 +22,7 @@ export const Role = {
 export type Role = ClosedEnum<typeof Role>;
 
 export type SystemMessage = {
-  content: string | Array<TextChunk>;
+  content: string | Array<SystemMessageContentChunks>;
   role?: Role | undefined;
 };
 
@@ -31,17 +31,19 @@ export const SystemMessageContent$inboundSchema: z.ZodType<
   SystemMessageContent,
   z.ZodTypeDef,
   unknown
-> = z.union([z.string(), z.array(TextChunk$inboundSchema)]);
+> = z.union([z.string(), z.array(SystemMessageContentChunks$inboundSchema)]);
 
 /** @internal */
-export type SystemMessageContent$Outbound = string | Array<TextChunk$Outbound>;
+export type SystemMessageContent$Outbound =
+  | string
+  | Array<SystemMessageContentChunks$Outbound>;
 
 /** @internal */
 export const SystemMessageContent$outboundSchema: z.ZodType<
   SystemMessageContent$Outbound,
   z.ZodTypeDef,
   SystemMessageContent
-> = z.union([z.string(), z.array(TextChunk$outboundSchema)]);
+> = z.union([z.string(), z.array(SystemMessageContentChunks$outboundSchema)]);
 
 /**
  * @internal
@@ -100,13 +102,16 @@ export const SystemMessage$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  content: z.union([z.string(), z.array(TextChunk$inboundSchema)]),
+  content: z.union([
+    z.string(),
+    z.array(SystemMessageContentChunks$inboundSchema),
+  ]),
   role: Role$inboundSchema.default("system"),
 });
 
 /** @internal */
 export type SystemMessage$Outbound = {
-  content: string | Array<TextChunk$Outbound>;
+  content: string | Array<SystemMessageContentChunks$Outbound>;
   role: string;
 };
 
@@ -116,7 +121,10 @@ export const SystemMessage$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   SystemMessage
 > = z.object({
-  content: z.union([z.string(), z.array(TextChunk$outboundSchema)]),
+  content: z.union([
+    z.string(),
+    z.array(SystemMessageContentChunks$outboundSchema),
+  ]),
   role: Role$outboundSchema.default("system"),
 });
 

package/src/models/components/systemmessagecontentchunks.ts

@@ -0,0 +1,92 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  TextChunk,
+  TextChunk$inboundSchema,
+  TextChunk$Outbound,
+  TextChunk$outboundSchema,
+} from "./textchunk.js";
+import {
+  ThinkChunk,
+  ThinkChunk$inboundSchema,
+  ThinkChunk$Outbound,
+  ThinkChunk$outboundSchema,
+} from "./thinkchunk.js";
+
+export type SystemMessageContentChunks =
+  | (TextChunk & { type: "text" })
+  | (ThinkChunk & { type: "thinking" });
+
+/** @internal */
+export const SystemMessageContentChunks$inboundSchema: z.ZodType<
+  SystemMessageContentChunks,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  TextChunk$inboundSchema.and(
+    z.object({ type: z.literal("text") }).transform((v) => ({ type: v.type })),
+  ),
+  ThinkChunk$inboundSchema.and(
+    z.object({ type: z.literal("thinking") }).transform((v) => ({
+      type: v.type,
+    })),
+  ),
+]);
+
+/** @internal */
+export type SystemMessageContentChunks$Outbound =
+  | (TextChunk$Outbound & { type: "text" })
+  | (ThinkChunk$Outbound & { type: "thinking" });
+
+/** @internal */
+export const SystemMessageContentChunks$outboundSchema: z.ZodType<
+  SystemMessageContentChunks$Outbound,
+  z.ZodTypeDef,
+  SystemMessageContentChunks
+> = z.union([
+  TextChunk$outboundSchema.and(
+    z.object({ type: z.literal("text") }).transform((v) => ({ type: v.type })),
+  ),
+  ThinkChunk$outboundSchema.and(
+    z.object({ type: z.literal("thinking") }).transform((v) => ({
+      type: v.type,
+    })),
+  ),
+]);
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace SystemMessageContentChunks$ {
+  /** @deprecated use `SystemMessageContentChunks$inboundSchema` instead. */
+  export const inboundSchema = SystemMessageContentChunks$inboundSchema;
+  /** @deprecated use `SystemMessageContentChunks$outboundSchema` instead. */
+  export const outboundSchema = SystemMessageContentChunks$outboundSchema;
+  /** @deprecated use `SystemMessageContentChunks$Outbound` instead. */
+  export type Outbound = SystemMessageContentChunks$Outbound;
+}
+
+export function systemMessageContentChunksToJSON(
+  systemMessageContentChunks: SystemMessageContentChunks,
+): string {
+  return JSON.stringify(
+    SystemMessageContentChunks$outboundSchema.parse(systemMessageContentChunks),
+  );
+}
+
+export function systemMessageContentChunksFromJSON(
+  jsonString: string,
+): SafeParseResult<SystemMessageContentChunks, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SystemMessageContentChunks$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SystemMessageContentChunks' from JSON`,
+  );
+}

package/src/models/components/transcriptionstreamevents.ts

@@ -37,18 +37,18 @@ import {
 } from "./transcriptionstreamtextdelta.js";
 
 export type TranscriptionStreamEventsData =
-  | (TranscriptionStreamLanguage & { type: "transcription.language" })
-  | (TranscriptionStreamTextDelta & { type: "transcription.text.delta" })
+  | (TranscriptionStreamDone & { type: "transcription.done" })
   | (TranscriptionStreamSegmentDelta & { type: "transcription.segment" })
-  | (TranscriptionStreamDone & { type: "transcription.done" });
+  | (TranscriptionStreamLanguage & { type: "transcription.language" })
+  | (TranscriptionStreamTextDelta & { type: "transcription.text.delta" });
 
 export type TranscriptionStreamEvents = {
   event: TranscriptionStreamEventTypes;
   data:
-    | (TranscriptionStreamLanguage & { type: "transcription.language" })
-    | (TranscriptionStreamTextDelta & { type: "transcription.text.delta" })
+    | (TranscriptionStreamDone & { type: "transcription.done" })
     | (TranscriptionStreamSegmentDelta & { type: "transcription.segment" })
-    | (TranscriptionStreamDone & { type: "transcription.done" });
+    | (TranscriptionStreamLanguage & { type: "transcription.language" })
+    | (TranscriptionStreamTextDelta & { type: "transcription.text.delta" });
 };
 
 /** @internal */
@@ -57,38 +57,38 @@ export const TranscriptionStreamEventsData$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.union([
-  TranscriptionStreamLanguage$inboundSchema.and(
-    z.object({ type: z.literal("transcription.language") }).transform((v) => ({
+  TranscriptionStreamDone$inboundSchema.and(
+    z.object({ type: z.literal("transcription.done") }).transform((v) => ({
       type: v.type,
     })),
   ),
-  TranscriptionStreamTextDelta$inboundSchema.and(
-    z.object({ type: z.literal("transcription.text.delta") }).transform((
-      v,
-    ) => ({ type: v.type })),
-  ),
   TranscriptionStreamSegmentDelta$inboundSchema.and(
     z.object({ type: z.literal("transcription.segment") }).transform((v) => ({
       type: v.type,
     })),
   ),
-  TranscriptionStreamDone$inboundSchema.and(
-    z.object({ type: z.literal("transcription.done") }).transform((v) => ({
+  TranscriptionStreamLanguage$inboundSchema.and(
+    z.object({ type: z.literal("transcription.language") }).transform((v) => ({
       type: v.type,
     })),
   ),
+  TranscriptionStreamTextDelta$inboundSchema.and(
+    z.object({ type: z.literal("transcription.text.delta") }).transform((
+      v,
+    ) => ({ type: v.type })),
+  ),
 ]);
 
 /** @internal */
 export type TranscriptionStreamEventsData$Outbound =
-  | (TranscriptionStreamLanguage$Outbound & { type: "transcription.language" })
-  | (TranscriptionStreamTextDelta$Outbound & {
-    type: "transcription.text.delta";
-  })
+  | (TranscriptionStreamDone$Outbound & { type: "transcription.done" })
   | (TranscriptionStreamSegmentDelta$Outbound & {
     type: "transcription.segment";
   })
-  | (TranscriptionStreamDone$Outbound & { type: "transcription.done" });
+  | (TranscriptionStreamLanguage$Outbound & { type: "transcription.language" })
+  | (TranscriptionStreamTextDelta$Outbound & {
+    type: "transcription.text.delta";
+  });
 
 /** @internal */
 export const TranscriptionStreamEventsData$outboundSchema: z.ZodType<
@@ -96,26 +96,26 @@ export const TranscriptionStreamEventsData$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   TranscriptionStreamEventsData
 > = z.union([
-  TranscriptionStreamLanguage$outboundSchema.and(
-    z.object({ type: z.literal("transcription.language") }).transform((v) => ({
+  TranscriptionStreamDone$outboundSchema.and(
+    z.object({ type: z.literal("transcription.done") }).transform((v) => ({
       type: v.type,
     })),
   ),
-  TranscriptionStreamTextDelta$outboundSchema.and(
-    z.object({ type: z.literal("transcription.text.delta") }).transform((
-      v,
-    ) => ({ type: v.type })),
-  ),
   TranscriptionStreamSegmentDelta$outboundSchema.and(
     z.object({ type: z.literal("transcription.segment") }).transform((v) => ({
       type: v.type,
     })),
   ),
-  TranscriptionStreamDone$outboundSchema.and(
-    z.object({ type: z.literal("transcription.done") }).transform((v) => ({
+  TranscriptionStreamLanguage$outboundSchema.and(
+    z.object({ type: z.literal("transcription.language") }).transform((v) => ({
       type: v.type,
     })),
   ),
+  TranscriptionStreamTextDelta$outboundSchema.and(
+    z.object({ type: z.literal("transcription.text.delta") }).transform((
+      v,
+    ) => ({ type: v.type })),
+  ),
 ]);
 
 /**
@@ -170,6 +170,16 @@ export const TranscriptionStreamEvents$inboundSchema: z.ZodType<
     }
   }).pipe(
     z.union([
+      TranscriptionStreamDone$inboundSchema.and(
+        z.object({ type: z.literal("transcription.done") }).transform((v) => ({
+          type: v.type,
+        })),
+      ),
+      TranscriptionStreamSegmentDelta$inboundSchema.and(
+        z.object({ type: z.literal("transcription.segment") }).transform((
+          v,
+        ) => ({ type: v.type })),
+      ),
       TranscriptionStreamLanguage$inboundSchema.and(
         z.object({ type: z.literal("transcription.language") }).transform((
           v,
@@ -180,16 +190,6 @@ export const TranscriptionStreamEvents$inboundSchema: z.ZodType<
           v,
         ) => ({ type: v.type })),
       ),
-      TranscriptionStreamSegmentDelta$inboundSchema.and(
-        z.object({ type: z.literal("transcription.segment") }).transform((
-          v,
-        ) => ({ type: v.type })),
-      ),
-      TranscriptionStreamDone$inboundSchema.and(
-        z.object({ type: z.literal("transcription.done") }).transform((v) => ({
-          type: v.type,
-        })),
-      ),
     ]),
   ),
 });
@@ -198,16 +198,16 @@ export const TranscriptionStreamEvents$inboundSchema: z.ZodType<
 export type TranscriptionStreamEvents$Outbound = {
   event: string;
   data:
+    | (TranscriptionStreamDone$Outbound & { type: "transcription.done" })
+    | (TranscriptionStreamSegmentDelta$Outbound & {
+      type: "transcription.segment";
+    })
     | (TranscriptionStreamLanguage$Outbound & {
       type: "transcription.language";
     })
     | (TranscriptionStreamTextDelta$Outbound & {
       type: "transcription.text.delta";
-    })
-    | (TranscriptionStreamSegmentDelta$Outbound & {
-      type: "transcription.segment";
-    })
-    | (TranscriptionStreamDone$Outbound & { type: "transcription.done" });
+    });
 };
 
 /** @internal */
@@ -218,6 +218,16 @@ export const TranscriptionStreamEvents$outboundSchema: z.ZodType<
 > = z.object({
   event: TranscriptionStreamEventTypes$outboundSchema,
   data: z.union([
+    TranscriptionStreamDone$outboundSchema.and(
+      z.object({ type: z.literal("transcription.done") }).transform((v) => ({
+        type: v.type,
+      })),
+    ),
+    TranscriptionStreamSegmentDelta$outboundSchema.and(
+      z.object({ type: z.literal("transcription.segment") }).transform((v) => ({
+        type: v.type,
+      })),
+    ),
     TranscriptionStreamLanguage$outboundSchema.and(
       z.object({ type: z.literal("transcription.language") }).transform((
         v,
@@ -228,16 +238,6 @@ export const TranscriptionStreamEvents$outboundSchema: z.ZodType<
         v,
       ) => ({ type: v.type })),
     ),
-    TranscriptionStreamSegmentDelta$outboundSchema.and(
-      z.object({ type: z.literal("transcription.segment") }).transform((v) => ({
-        type: v.type,
-      })),
-    ),
-    TranscriptionStreamDone$outboundSchema.and(
-      z.object({ type: z.literal("transcription.done") }).transform((v) => ({
-        type: v.type,
-      })),
-    ),
   ]),
 });
 

package/src/models/errors/httpvalidationerror.ts

@@ -4,24 +4,27 @@
 
 import * as z from "zod";
 import * as components from "../components/index.js";
+import { MistralError } from "./mistralerror.js";
 
 export type HTTPValidationErrorData = {
   detail?: Array<components.ValidationError> | undefined;
 };
 
-export class HTTPValidationError extends Error {
+export class HTTPValidationError extends MistralError {
   detail?: Array<components.ValidationError> | undefined;
 
   /** The original data that was passed to this error instance. */
   data$: HTTPValidationErrorData;
 
-  constructor(err: HTTPValidationErrorData) {
+  constructor(
+    err: HTTPValidationErrorData,
+    httpMeta: { response: Response; request: Request; body: string },
+  ) {
     const message = "message" in err && typeof err.message === "string"
       ? err.message
       : `API error occurred: ${JSON.stringify(err)}`;
-    super(message);
+    super(message, httpMeta);
     this.data$ = err;
-
     if (err.detail != null) this.detail = err.detail;
 
     this.name = "HTTPValidationError";
@@ -35,9 +38,16 @@ export const HTTPValidationError$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   detail: z.array(components.ValidationError$inboundSchema).optional(),
+  request$: z.instanceof(Request),
+  response$: z.instanceof(Response),
+  body$: z.string(),
 })
   .transform((v) => {
-    return new HTTPValidationError(v);
+    return new HTTPValidationError(v, {
+      request: v.request$,
+      response: v.response$,
+      body: v.body$,
+    });
   });
 
 /** @internal */

package/src/models/errors/index.ts

@@ -4,5 +4,6 @@
 
 export * from "./httpclienterrors.js";
 export * from "./httpvalidationerror.js";
+export * from "./responsevalidationerror.js";
 export * from "./sdkerror.js";
 export * from "./sdkvalidationerror.js";

package/src/models/errors/mistralerror.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+/** The base class for all HTTP error responses */
+export class MistralError extends Error {
+  /** HTTP status code */
+  public readonly statusCode: number;
+  /** HTTP body */
+  public readonly body: string;
+  /** HTTP headers */
+  public readonly headers: Headers;
+  /** HTTP content type */
+  public readonly contentType: string;
+  /** Raw response */
+  public readonly rawResponse: Response;
+
+  constructor(
+    message: string,
+    httpMeta: {
+      response: Response;
+      request: Request;
+      body: string;
+    },
+  ) {
+    super(message);
+    this.statusCode = httpMeta.response.status;
+    this.body = httpMeta.body;
+    this.headers = httpMeta.response.headers;
+    this.contentType = httpMeta.response.headers.get("content-type") || "";
+    this.rawResponse = httpMeta.response;
+
+    this.name = "MistralError";
+  }
+}

package/src/models/errors/responsevalidationerror.ts

@@ -0,0 +1,50 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { MistralError } from "./mistralerror.js";
+import { formatZodError } from "./sdkvalidationerror.js";
+
+export class ResponseValidationError extends MistralError {
+  /**
+   * The raw value that failed validation.
+   */
+  public readonly rawValue: unknown;
+
+  /**
+   * The raw message that failed validation.
+   */
+  public readonly rawMessage: unknown;
+
+  constructor(
+    message: string,
+    extra: {
+      response: Response;
+      request: Request;
+      body: string;
+      cause: unknown;
+      rawValue: unknown;
+      rawMessage: unknown;
+    },
+  ) {
+    super(message, extra);
+    this.name = "ResponseValidationError";
+    this.cause = extra.cause;
+    this.rawValue = extra.rawValue;
+    this.rawMessage = extra.rawMessage;
+  }
+
+  /**
+   * Return a pretty-formatted error message if the underlying validation error
+   * is a ZodError or some other recognized error type, otherwise return the
+   * default error message.
+   */
+  public pretty(): string {
+    if (this.cause instanceof z.ZodError) {
+      return `${this.rawMessage}\n${formatZodError(this.cause)}`;
+    } else {
+      return this.toString();
+    }
+  }
+}

package/src/models/errors/sdkerror.ts

@@ -2,26 +2,39 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
-export class SDKError extends Error {
-  public readonly statusCode: number;
-  public readonly contentType: string;
+import { MistralError } from "./mistralerror.js";
 
+/** The fallback error class if no more specific error class is matched */
+export class SDKError extends MistralError {
   constructor(
     message: string,
-    public readonly rawResponse: Response,
-    public readonly body: string = "",
+    httpMeta: {
+      response: Response;
+      request: Request;
+      body: string;
+    },
   ) {
-    const statusCode = rawResponse.status;
-    const contentType = rawResponse.headers.get("content-type") || "";
-    const bodyString = body.length > 0 ? `\n${body}` : "";
-
-    super(
-      `${message}: Status ${statusCode} Content-Type ${contentType} Body ${bodyString}`,
-    );
-
-    this.statusCode = statusCode;
-    this.contentType = contentType;
-
+    if (message) {
+      message += `: `;
+    }
+    message += `Status ${httpMeta.response.status}`;
+    const contentType = httpMeta.response.headers.get("content-type") || `""`;
+    if (contentType !== "application/json") {
+      message += ` Content-Type ${
+        contentType.includes(" ") ? `"${contentType}"` : contentType
+      }`;
+    }
+    const body = httpMeta.body || `""`;
+    message += body.length > 100 ? "\n" : ". ";
+    let bodyDisplay = body;
+    if (body.length > 10000) {
+      const truncated = body.substring(0, 10000);
+      const remaining = body.length - 10000;
+      bodyDisplay = `${truncated}...and ${remaining} more chars`;
+    }
+    message += `Body: ${bodyDisplay}`;
+    message = message.trim();
+    super(message, httpMeta);
     this.name = "SDKError";
   }
 }

package/src/models/errors/sdkvalidationerror.ts

@@ -15,6 +15,18 @@ export class SDKValidationError extends Error {
    */
   public readonly rawMessage: unknown;
 
+  // Allows for backwards compatibility for `instanceof` checks of `ResponseValidationError`
+  static override [Symbol.hasInstance](
+    instance: unknown,
+  ): instance is SDKValidationError {
+    if (!(instance instanceof Error)) return false;
+    if (!("rawValue" in instance)) return false;
+    if (!("rawMessage" in instance)) return false;
+    if (!("pretty" in instance)) return false;
+    if (typeof instance.pretty !== "function") return false;
+    return true;
+  }
+
   constructor(message: string, cause: unknown, rawValue: unknown) {
     super(`${message}: ${cause}`);
     this.name = "SDKValidationError";