@mistralai/mistralai 1.12.0 → 1.14.0

package/README.md

@@ -57,10 +57,7 @@ bun add @mistralai/mistralai
 ### Yarn
 
 ```bash
-yarn add @mistralai/mistralai zod
-
-# Note that Yarn does not install peer dependencies automatically. You will need
-# to install zod as shown above.
+yarn add @mistralai/mistralai
 ```
 <!-- End SDK Installation [installation] -->
 
@@ -216,33 +213,24 @@ We have dedicated SDKs for the following providers:
 <details open>
 <summary>Available methods</summary>
 
-### [agents](docs/sdks/agents/README.md)
+### [Agents](docs/sdks/agents/README.md)
 
 * [complete](docs/sdks/agents/README.md#complete) - Agents Completion
 * [stream](docs/sdks/agents/README.md#stream) - Stream Agents completion
 
-### [audio](docs/sdks/audio/README.md)
-
-
-#### [audio.transcriptions](docs/sdks/transcriptions/README.md)
+### [Audio.Transcriptions](docs/sdks/transcriptions/README.md)
 
 * [complete](docs/sdks/transcriptions/README.md#complete) - Create Transcription
 * [stream](docs/sdks/transcriptions/README.md#stream) - Create Streaming Transcription (SSE)
 
-### [batch](docs/sdks/batch/README.md)
-
-
-#### [batch.jobs](docs/sdks/mistraljobs/README.md)
+### [Batch.Jobs](docs/sdks/mistraljobs/README.md)
 
 * [list](docs/sdks/mistraljobs/README.md#list) - Get Batch Jobs
 * [create](docs/sdks/mistraljobs/README.md#create) - Create Batch Job
 * [get](docs/sdks/mistraljobs/README.md#get) - Get Batch Job
 * [cancel](docs/sdks/mistraljobs/README.md#cancel) - Cancel Batch Job
 
-### [beta](docs/sdks/beta/README.md)
-
-
-#### [beta.agents](docs/sdks/mistralagents/README.md)
+### [Beta.Agents](docs/sdks/mistralagents/README.md)
 
 * [create](docs/sdks/mistralagents/README.md#create) - Create a agent that can be used within a conversation.
 * [list](docs/sdks/mistralagents/README.md#list) - List agent entities.
@@ -250,8 +238,12 @@ We have dedicated SDKs for the following providers:
 * [update](docs/sdks/mistralagents/README.md#update) - Update an agent entity.
 * [delete](docs/sdks/mistralagents/README.md#delete) - Delete an agent entity.
 * [updateVersion](docs/sdks/mistralagents/README.md#updateversion) - Update an agent version.
+* [listVersions](docs/sdks/mistralagents/README.md#listversions) - List all versions of an agent.
+* [getVersion](docs/sdks/mistralagents/README.md#getversion) - Retrieve a specific version of an agent.
+* [createVersionAlias](docs/sdks/mistralagents/README.md#createversionalias) - Create or update an agent version alias.
+* [listVersionAliases](docs/sdks/mistralagents/README.md#listversionaliases) - List all aliases for an agent.
 
-#### [beta.conversations](docs/sdks/conversations/README.md)
+### [Beta.Conversations](docs/sdks/conversations/README.md)
 
 * [start](docs/sdks/conversations/README.md#start) - Create a conversation and append entries to it.
 * [list](docs/sdks/conversations/README.md#list) - List all created conversations.
@@ -265,7 +257,7 @@ We have dedicated SDKs for the following providers:
 * [appendStream](docs/sdks/conversations/README.md#appendstream) - Append new entries to an existing conversation.
 * [restartStream](docs/sdks/conversations/README.md#restartstream) - Restart a conversation starting from a given entry.
 
-#### [beta.libraries](docs/sdks/libraries/README.md)
+### [Beta.Libraries](docs/sdks/libraries/README.md)
 
 * [list](docs/sdks/libraries/README.md#list) - List all libraries you have access to.
 * [create](docs/sdks/libraries/README.md#create) - Create a new Library.
@@ -273,13 +265,13 @@ We have dedicated SDKs for the following providers:
 * [delete](docs/sdks/libraries/README.md#delete) - Delete a library and all of it's document.
 * [update](docs/sdks/libraries/README.md#update) - Update a library.
 
-#### [beta.libraries.accesses](docs/sdks/accesses/README.md)
+#### [Beta.Libraries.Accesses](docs/sdks/accesses/README.md)
 
 * [list](docs/sdks/accesses/README.md#list) - List all of the access to this library.
 * [updateOrCreate](docs/sdks/accesses/README.md#updateorcreate) - Create or update an access level.
 * [delete](docs/sdks/accesses/README.md#delete) - Delete an access level.
 
-#### [beta.libraries.documents](docs/sdks/documents/README.md)
+#### [Beta.Libraries.Documents](docs/sdks/documents/README.md)
 
 * [list](docs/sdks/documents/README.md#list) - List documents in a given library.
 * [upload](docs/sdks/documents/README.md#upload) - Upload a new document.
@@ -292,23 +284,23 @@ We have dedicated SDKs for the following providers:
 * [extractedTextSignedUrl](docs/sdks/documents/README.md#extractedtextsignedurl) - Retrieve the signed URL of text extracted from a given document.
 * [reprocess](docs/sdks/documents/README.md#reprocess) - Reprocess a document.
 
-### [chat](docs/sdks/chat/README.md)
+### [Chat](docs/sdks/chat/README.md)
 
 * [complete](docs/sdks/chat/README.md#complete) - Chat Completion
 * [stream](docs/sdks/chat/README.md#stream) - Stream chat completion
 
-### [classifiers](docs/sdks/classifiers/README.md)
+### [Classifiers](docs/sdks/classifiers/README.md)
 
 * [moderate](docs/sdks/classifiers/README.md#moderate) - Moderations
 * [moderateChat](docs/sdks/classifiers/README.md#moderatechat) - Chat Moderations
 * [classify](docs/sdks/classifiers/README.md#classify) - Classifications
 * [classifyChat](docs/sdks/classifiers/README.md#classifychat) - Chat Classifications
 
-### [embeddings](docs/sdks/embeddings/README.md)
+### [Embeddings](docs/sdks/embeddings/README.md)
 
 * [create](docs/sdks/embeddings/README.md#create) - Embeddings
 
-### [files](docs/sdks/files/README.md)
+### [Files](docs/sdks/files/README.md)
 
 * [upload](docs/sdks/files/README.md#upload) - Upload File
 * [list](docs/sdks/files/README.md#list) - List Files
@@ -317,15 +309,12 @@ We have dedicated SDKs for the following providers:
 * [download](docs/sdks/files/README.md#download) - Download File
 * [getSignedUrl](docs/sdks/files/README.md#getsignedurl) - Get Signed Url
 
-### [fim](docs/sdks/fim/README.md)
+### [Fim](docs/sdks/fim/README.md)
 
 * [complete](docs/sdks/fim/README.md#complete) - Fim Completion
 * [stream](docs/sdks/fim/README.md#stream) - Stream fim completion
 
-### [fineTuning](docs/sdks/finetuning/README.md)
-
-
-#### [fineTuning.jobs](docs/sdks/jobs/README.md)
+### [FineTuning.Jobs](docs/sdks/jobs/README.md)
 
 * [list](docs/sdks/jobs/README.md#list) - Get Fine Tuning Jobs
 * [create](docs/sdks/jobs/README.md#create) - Create Fine Tuning Job
@@ -333,8 +322,7 @@ We have dedicated SDKs for the following providers:
 * [cancel](docs/sdks/jobs/README.md#cancel) - Cancel Fine Tuning Job
 * [start](docs/sdks/jobs/README.md#start) - Start Fine Tuning Job
 
-
-### [models](docs/sdks/models/README.md)
+### [Models](docs/sdks/models/README.md)
 
 * [list](docs/sdks/models/README.md#list) - List Models
 * [retrieve](docs/sdks/models/README.md#retrieve) - Retrieve Model
@@ -343,7 +331,7 @@ We have dedicated SDKs for the following providers:
 * [archive](docs/sdks/models/README.md#archive) - Archive Fine Tuned Model
 * [unarchive](docs/sdks/models/README.md#unarchive) - Unarchive Fine Tuned Model
 
-### [ocr](docs/sdks/ocr/README.md)
+### [Ocr](docs/sdks/ocr/README.md)
 
 * [process](docs/sdks/ocr/README.md#process) - OCR
 
@@ -386,7 +374,6 @@ async function run() {
   });
 
   for await (const event of result) {
-    // Handle the event
     console.log(event);
   }
 }
@@ -567,7 +554,7 @@ run();
 
 
 **Inherit from [`MistralError`](./src/models/errors/mistralerror.ts)**:
-* [`HTTPValidationError`](./src/models/errors/httpvalidationerror.ts): Validation Error. Status code `422`. Applicable to 48 of 70 methods.*
+* [`HTTPValidationError`](./src/models/errors/httpvalidationerror.ts): Validation Error. Status code `422`. Applicable to 52 of 74 methods.*
 * [`ResponseValidationError`](./src/models/errors/responsevalidationerror.ts): Type mismatch between the data returned from the server and the structure expected by the SDK. See `error.rawValue` for the raw value and `error.pretty()` for a nicely formatted multi-line string.
 
 </details>
@@ -673,7 +660,7 @@ httpClient.addHook("requestError", (error, request) => {
   console.groupEnd();
 });
 
-const sdk = new Mistral({ httpClient });
+const sdk = new Mistral({ httpClient: httpClient });
 ```
 <!-- End Custom HTTP Client [http-client] -->
 
@@ -738,9 +725,13 @@ To read more about standalone functions, check [FUNCTIONS.md](./FUNCTIONS.md).
 - [`batchJobsGet`](docs/sdks/mistraljobs/README.md#get) - Get Batch Job
 - [`batchJobsList`](docs/sdks/mistraljobs/README.md#list) - Get Batch Jobs
 - [`betaAgentsCreate`](docs/sdks/mistralagents/README.md#create) - Create a agent that can be used within a conversation.
+- [`betaAgentsCreateVersionAlias`](docs/sdks/mistralagents/README.md#createversionalias) - Create or update an agent version alias.
 - [`betaAgentsDelete`](docs/sdks/mistralagents/README.md#delete) - Delete an agent entity.
 - [`betaAgentsGet`](docs/sdks/mistralagents/README.md#get) - Retrieve an agent entity.
+- [`betaAgentsGetVersion`](docs/sdks/mistralagents/README.md#getversion) - Retrieve a specific version of an agent.
 - [`betaAgentsList`](docs/sdks/mistralagents/README.md#list) - List agent entities.
+- [`betaAgentsListVersionAliases`](docs/sdks/mistralagents/README.md#listversionaliases) - List all aliases for an agent.
+- [`betaAgentsListVersions`](docs/sdks/mistralagents/README.md#listversions) - List all versions of an agent.
 - [`betaAgentsUpdate`](docs/sdks/mistralagents/README.md#update) - Update an agent entity.
 - [`betaAgentsUpdateVersion`](docs/sdks/mistralagents/README.md#updateversion) - Update an agent version.
 - [`betaConversationsAppend`](docs/sdks/conversations/README.md#append) - Append new entries to an existing conversation.

package/RUNTIMES.md

@@ -2,9 +2,9 @@
 
 This SDK is intended to be used in JavaScript runtimes that support ECMAScript 2020 or newer. The SDK uses the following features:
 
-* [Web Fetch API][web-fetch]
-* [Web Streams API][web-streams] and in particular `ReadableStream`
-* [Async iterables][async-iter] using `Symbol.asyncIterator`
+- [Web Fetch API][web-fetch]
+- [Web Streams API][web-streams] and in particular `ReadableStream`
+- [Async iterables][async-iter] using `Symbol.asyncIterator`
 
 [web-fetch]: https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API
 [web-streams]: https://developer.mozilla.org/en-US/docs/Web/API/Streams_API
@@ -25,7 +25,7 @@ Runtime environments that are explicitly supported are:
 
 The following `tsconfig.json` options are recommended for projects using this
 SDK in order to get static type support for features like async iterables,
-streams and `fetch`-related APIs ([`for await...of`][for-await-of], 
+streams and `fetch`-related APIs ([`for await...of`][for-await-of],
 [`AbortSignal`][abort-signal], [`Request`][request], [`Response`][response] and
 so on):
 
@@ -38,11 +38,11 @@ so on):
 {
   "compilerOptions": {
     "target": "es2020", // or higher
-    "lib": ["es2020", "dom", "dom.iterable"],
+    "lib": ["es2020", "dom", "dom.iterable"]
   }
 }
 ```
 
 While `target` can be set to older ECMAScript versions, it may result in extra,
 unnecessary compatibility code being generated if you are not targeting old
-runtimes.
+runtimes.

package/examples/src/async_audio_transcription_diarize.ts

@@ -0,0 +1,17 @@
+import { Mistral } from "@mistralai/mistralai";
+
+const apiKey = process.env["MISTRAL_API_KEY"];
+if (!apiKey) {
+  throw new Error("missing MISTRAL_API_KEY environment variable");
+}
+
+const mistral = new Mistral({ apiKey: apiKey });
+
+const response = await mistral.audio.transcriptions.complete({
+  model: "voxtral-mini-2602",
+  fileUrl: "https://docs.mistral.ai/audio/bcn_weather.mp3",
+  diarize: true,
+  timestampGranularities: ["segment"],
+});
+
+process.stdout.write(JSON.stringify(response));

package/examples/src/async_batch_jobs.ts

@@ -0,0 +1,60 @@
+import { Mistral } from "@mistralai/mistralai";
+
+const apiKey = process.env["MISTRAL_API_KEY"];
+if (!apiKey) {
+  throw new Error("missing MISTRAL_API_KEY environment variable");
+}
+
+const client = new Mistral({ apiKey });
+
+const requests = Array.from({ length: 5 }, (_, i) => ({
+  customId: String(i),
+  body: {
+    model: "mistral-medium-latest",
+    messages: [
+      {
+        role: "user",
+        content: `What's i + ${i}`,
+      },
+    ],
+  },
+}));
+
+let job = await client.batch.jobs.create({
+  requests,
+  model: "mistral-small-latest",
+  endpoint: "/v1/chat/completions",
+  metadata: { job_type: "testing" },
+});
+
+console.log(`Created job with ID: ${job.id}`);
+
+const terminalStatuses = new Set([
+  "SUCCESS",
+  "FAILED",
+  "CANCELLED",
+  "TIMEOUT_EXCEEDED",
+]);
+
+while (!terminalStatuses.has(job.status)) {
+  await new Promise((resolve) => setTimeout(resolve, 1000));
+  job = await client.batch.jobs.get({ jobId: job.id });
+  console.log(`Job status: ${job.status}`);
+}
+
+console.log(`Job is done, status ${job.status}`);
+
+if (job.outputs && job.outputs.length > 0) {
+  for (const output of job.outputs) {
+    const response = output["response"] as { body?: unknown } | undefined;
+    if (response?.body !== undefined) {
+      console.log(response.body);
+    } else {
+      console.log(output);
+    }
+  }
+}
+
+if (job.errorFile) {
+  console.log(`Error file ID: ${job.errorFile}`);
+}

package/examples/src/realtime_microphone.ts

@@ -0,0 +1,163 @@
+import { spawn, type ChildProcess } from "node:child_process";
+import yargs from "yargs/yargs";
+import { hideBin } from "yargs/helpers";
+
+import {
+  AudioEncoding,
+  RealtimeTranscription,
+} from "@mistralai/mistralai/extra/realtime";
+
+type Args = {
+  model: string;
+  encoding: string;
+  sampleRate: number;
+  apiKey?: string;
+  baseUrl: string;
+};
+
+function parseArgs(): Args {
+  const argv = yargs(hideBin(process.argv))
+    .usage("Usage: $0 [options]")
+    .option("model", {
+      type: "string",
+      default: "voxtral-mini-transcribe-realtime-2602",
+      describe: "Model ID",
+    })
+    .option("encoding", {
+      type: "string",
+      default: AudioEncoding.PcmS16le,
+      describe: "Audio encoding",
+    })
+    .option("sample-rate", {
+      type: "number",
+      default: 16000,
+      describe: "Sample rate in Hz",
+    })
+    .option("api-key", {
+      type: "string",
+      default: process.env["MISTRAL_API_KEY"],
+      describe: "Mistral API key",
+    })
+    .option("base-url", {
+      type: "string",
+      default: process.env["MISTRAL_BASE_URL"] ?? "wss://api.mistral.ai",
+      describe: "API base URL",
+    })
+    .help()
+    .parseSync();
+
+  return {
+    model: argv.model,
+    encoding: argv.encoding,
+    sampleRate: argv.sampleRate,
+    apiKey: argv.apiKey,
+    baseUrl: argv.baseUrl,
+  };
+}
+
+async function* captureAudio(
+  sampleRate: number,
+): AsyncGenerator<Uint8Array, void, unknown> {
+  const recorder: ChildProcess = spawn(
+    "rec",
+    [
+      "-q",
+      "-t", "raw",
+      "-b", "16",
+      "-e", "signed-integer",
+      "-r", String(sampleRate),
+      "-c", "1",
+      "-",
+    ],
+    { stdio: ["ignore", "pipe", "ignore"] },
+  );
+
+  recorder.on("error", (err) => {
+    const error = err as NodeJS.ErrnoException;
+    if (error.code === "ENOENT") {
+      console.error(
+        "\nError: 'rec' not found. Install SoX: brew install sox (macOS) or apt install sox (Linux)",
+      );
+      process.exit(1);
+    }
+    throw err;
+  });
+
+  try {
+    if (!recorder.stdout) {
+      throw new Error("Failed to create audio capture stream");
+    }
+    for await (const chunk of recorder.stdout) {
+      yield new Uint8Array(chunk as Buffer);
+    }
+  } finally {
+    if (!recorder.killed) {
+      recorder.kill("SIGTERM");
+    }
+  }
+}
+
+function clearLine(): void {
+  process.stdout.write("\x1b[2K\r");
+}
+
+async function main(): Promise<void> {
+  const args = parseArgs();
+
+  const apiKey = args.apiKey ?? process.env["MISTRAL_API_KEY"];
+  if (!apiKey) {
+    console.error(
+      "Missing MISTRAL_API_KEY. Set the environment variable or pass --api-key.",
+    );
+    process.exit(1);
+  }
+
+  const client = new RealtimeTranscription({
+    apiKey: apiKey,
+    serverURL: args.baseUrl,
+  });
+
+  console.log("Listening... (Ctrl+C to stop)\n");
+
+  const audioStream = captureAudio(args.sampleRate);
+
+  process.on("SIGINT", () => {
+    clearLine();
+    console.log("\nStopped.");
+    process.exit(0);
+  });
+
+  try {
+    for await (const event of client.transcribeStream(
+      audioStream,
+      args.model,
+      {
+        audioFormat: {
+          encoding: args.encoding,
+          sampleRate: args.sampleRate,
+        },
+      },
+    )) {
+      if (event.type === "transcription.text.delta") {
+        process.stdout.write(event.text);
+        continue;
+      }
+      if (event.type === "transcription.done") {
+        process.stdout.write("\n");
+        break;
+      }
+      if (event.type === "error") {
+        const errorMessage = typeof event.error.message === "string"
+          ? event.error.message
+          : JSON.stringify(event.error.message);
+        console.error(`\nTranscription error: ${errorMessage}`);
+        process.exitCode = 1;
+        break;
+      }
+    }
+  } finally {
+    await audioStream.return?.();
+  }
+}
+
+await main();

package/examples/src/realtime_transcription.ts

@@ -0,0 +1,225 @@
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { createReadStream, promises as fs } from "node:fs";
+import { tmpdir } from "node:os";
+import { extname, join, resolve } from "node:path";
+import yargs from "yargs/yargs";
+import { hideBin } from "yargs/helpers";
+
+import {
+  AudioEncoding,
+  RealtimeTranscription,
+} from "@mistralai/mistralai/extra/realtime";
+
+type KnownAudioEncoding = (typeof AudioEncoding)[keyof typeof AudioEncoding];
+
+const DEFAULT_ENCODING: KnownAudioEncoding = AudioEncoding.PcmS16le;
+const DEFAULT_SAMPLE_RATE = 16000;
+
+const FFMPEG_FORMAT_BY_ENCODING: Record<KnownAudioEncoding, string> = {
+  [AudioEncoding.PcmS16le]: "s16le",
+  [AudioEncoding.PcmS32le]: "s32le",
+  [AudioEncoding.PcmF32le]: "f32le",
+  [AudioEncoding.PcmF16le]: "f16le",
+  [AudioEncoding.PcmMulaw]: "mulaw",
+  [AudioEncoding.PcmAlaw]: "alaw",
+};
+
+type Args = {
+  file?: string;
+  model: string;
+  apiKey?: string;
+  baseUrl: string;
+  noConvert: boolean;
+};
+
+function parseArgs(): Args {
+  const argv = yargs(hideBin(process.argv))
+    .usage("Usage: $0 <file> [options]")
+    .option("model", {
+      type: "string",
+      default: "voxtral-mini-transcribe-realtime-2602",
+      describe: "Model ID",
+    })
+    .option("api-key", {
+      type: "string",
+      default: process.env["MISTRAL_API_KEY"],
+      describe: "Mistral API key",
+    })
+    .option("base-url", {
+      type: "string",
+      default: process.env["MISTRAL_BASE_URL"] ?? "https://api.mistral.ai",
+      describe: "API base URL",
+    })
+    .option("no-convert", {
+      type: "boolean",
+      default: false,
+      describe: "Skip ffmpeg conversion (input must be raw PCM)",
+    })
+    .help()
+    .parseSync();
+
+  const fileArg = argv._[0];
+  const file = typeof fileArg === "string" ? fileArg : undefined;
+
+  return {
+    file,
+    model: argv.model,
+    apiKey: argv.apiKey,
+    baseUrl: argv.baseUrl,
+    noConvert: argv.noConvert,
+  };
+}
+
+async function runFfmpeg(args: string[]): Promise<void> {
+  await new Promise<void>((resolve, reject) => {
+    const child = spawn("ffmpeg", args, {
+      stdio: ["ignore", "ignore", "pipe"],
+    });
+
+    let stderr = "";
+    child.stderr.setEncoding("utf8");
+    child.stderr.on("data", (chunk) => {
+      stderr += chunk;
+    });
+
+    child.on("error", (err) => {
+      const error = err as NodeJS.ErrnoException;
+      if (error.code === "ENOENT") {
+        reject(new Error(
+          "ffmpeg not found. Install ffmpeg or use --no-convert with raw PCM input.",
+        ));
+        return;
+      }
+      reject(err);
+    });
+
+    child.on("close", (code) => {
+      if (code === 0) {
+        resolve();
+        return;
+      }
+      const details = stderr.trim();
+      reject(new Error(
+        `ffmpeg conversion failed${details ? `: ${details}` : ""}`,
+      ));
+    });
+  });
+}
+
+async function convertAudioToPcm(
+  inputPath: string,
+  encoding: KnownAudioEncoding,
+  sampleRate: number,
+): Promise<string> {
+  const tempPath = join(
+    tmpdir(),
+    `mistral-realtime-${randomUUID()}.pcm`,
+  );
+
+  const ffmpegFormat = FFMPEG_FORMAT_BY_ENCODING[encoding];
+  const args = [
+    "-y",
+    "-i",
+    inputPath,
+    "-f",
+    ffmpegFormat,
+    "-ar",
+    String(sampleRate),
+    "-ac",
+    "1",
+    tempPath,
+  ];
+
+  try {
+    await runFfmpeg(args);
+  } catch (err) {
+    await fs.unlink(tempPath).catch(() => undefined);
+    throw err;
+  }
+
+  return tempPath;
+}
+
+async function* streamAudioFile(
+  filePath: string,
+  chunkSize: number = 4096,
+): AsyncIterable<Uint8Array> {
+  for await (const chunk of createReadStream(filePath, { highWaterMark: chunkSize })) {
+    yield chunk as Uint8Array;
+  }
+}
+
+async function main(): Promise<void> {
+  const args = parseArgs();
+  if (!args.file) {
+    console.error(
+      "Missing audio file. Provide a file path after the script name.",
+    );
+    return;
+  }
+
+  const apiKey = args.apiKey ?? process.env["MISTRAL_API_KEY"];
+  if (!apiKey) {
+    throw new Error(
+      "Missing MISTRAL_API_KEY. Set the environment variable or pass --api-key.",
+    );
+  }
+
+  const inputPath = resolve(args.file);
+
+  let audioPath = inputPath;
+  let tempPath: string | undefined;
+
+  const extension = extname(inputPath).toLowerCase();
+  const isRawPcm = extension === ".pcm" || extension === ".raw";
+  if (!args.noConvert && !isRawPcm) {
+    tempPath = await convertAudioToPcm(
+      inputPath,
+      DEFAULT_ENCODING,
+      DEFAULT_SAMPLE_RATE,
+    );
+    audioPath = tempPath;
+  }
+
+  const client = new RealtimeTranscription({
+    apiKey: apiKey,
+    serverURL: args.baseUrl,
+  });
+
+  try {
+    for await (const event of client.transcribeStream(
+      streamAudioFile(audioPath),
+      args.model,
+      {
+        audioFormat: {
+          encoding: DEFAULT_ENCODING,
+          sampleRate: DEFAULT_SAMPLE_RATE,
+        },
+      },
+    )) {
+      if (event.type === "transcription.text.delta") {
+        process.stdout.write(event.text);
+        continue;
+      }
+      if (event.type === "transcription.done") {
+        process.stdout.write("\n");
+        break;
+      }
+      if (event.type === "error") {
+        const errorMessage = typeof event.error.message === "string"
+          ? event.error.message
+          : JSON.stringify(event.error.message);
+        console.error(`Transcription error: ${errorMessage}`);
+        process.exitCode = 1;
+        break;
+      }
+    }
+  } finally {
+    if (tempPath) {
+      await fs.unlink(tempPath).catch(() => undefined);
+    }
+  }
+}
+
+await main();