@mastra/voice-google 0.12.0-beta.0 → 0.12.0-beta.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @mastra/voice-google
 
+## 0.12.0-beta.1
+
+### Minor Changes
+
+- Add Vertex AI support to GoogleVoice provider ([#10661](https://github.com/mastra-ai/mastra/pull/10661))
+  - Add `vertexAI`, `project`, and `location` configuration options
+  - Support Vertex AI authentication via project ID and service accounts
+  - Add helper methods: `isUsingVertexAI()`, `getProject()`, `getLocation()`
+  - Support `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` environment variables
+  - Update README with Vertex AI usage examples
+
+  This makes `@mastra/voice-google` consistent with `@mastra/voice-google-gemini-live` and enables enterprise deployments using Google Cloud project-based authentication instead of API keys.
+
+### Patch Changes
+
+- Updated dependencies [[`ac0d2f4`](https://github.com/mastra-ai/mastra/commit/ac0d2f4ff8831f72c1c66c2be809706d17f65789), [`1a0d3fc`](https://github.com/mastra-ai/mastra/commit/1a0d3fc811482c9c376cdf79ee615c23bae9b2d6), [`85a628b`](https://github.com/mastra-ai/mastra/commit/85a628b1224a8f64cd82ea7f033774bf22df7a7e), [`c237233`](https://github.com/mastra-ai/mastra/commit/c23723399ccedf7f5744b3f40997b79246bfbe64), [`15f9e21`](https://github.com/mastra-ai/mastra/commit/15f9e216177201ea6e3f6d0bfb063fcc0953444f), [`ff94dea`](https://github.com/mastra-ai/mastra/commit/ff94dea935f4e34545c63bcb6c29804732698809), [`5b2ff46`](https://github.com/mastra-ai/mastra/commit/5b2ff4651df70c146523a7fca773f8eb0a2272f8), [`db41688`](https://github.com/mastra-ai/mastra/commit/db4168806d007417e2e60b4f68656dca4e5f40c9), [`5ca599d`](https://github.com/mastra-ai/mastra/commit/5ca599d0bb59a1595f19f58473fcd67cc71cef58), [`bff1145`](https://github.com/mastra-ai/mastra/commit/bff114556b3cbadad9b2768488708f8ad0e91475), [`5c8ca24`](https://github.com/mastra-ai/mastra/commit/5c8ca247094e0cc2cdbd7137822fb47241f86e77), [`e191844`](https://github.com/mastra-ai/mastra/commit/e1918444ca3f80e82feef1dad506cd4ec6e2875f), [`22553f1`](https://github.com/mastra-ai/mastra/commit/22553f11c63ee5e966a9c034a349822249584691), [`7237163`](https://github.com/mastra-ai/mastra/commit/72371635dbf96a87df4b073cc48fc655afbdce3d), [`2500740`](https://github.com/mastra-ai/mastra/commit/2500740ea23da067d6e50ec71c625ab3ce275e64), [`873ecbb`](https://github.com/mastra-ai/mastra/commit/873ecbb517586aa17d2f1e99283755b3ebb2863f), [`4f9bbe5`](https://github.com/mastra-ai/mastra/commit/4f9bbe5968f42c86f4930b8193de3c3c17e5bd36), [`02e51fe`](https://github.com/mastra-ai/mastra/commit/02e51feddb3d4155cfbcc42624fd0d0970d032c0), [`8f3fa3a`](https://github.com/mastra-ai/mastra/commit/8f3fa3a652bb77da092f913ec51ae46e3a7e27dc), [`cd29ad2`](https://github.com/mastra-ai/mastra/commit/cd29ad23a255534e8191f249593849ed29160886), [`bdf4d8c`](https://github.com/mastra-ai/mastra/commit/bdf4d8cdc656d8a2c21d81834bfa3bfa70f56c16), [`854e3da`](https://github.com/mastra-ai/mastra/commit/854e3dad5daac17a91a20986399d3a51f54bf68b), [`ce18d38`](https://github.com/mastra-ai/mastra/commit/ce18d38678c65870350d123955014a8432075fd9), [`cccf9c8`](https://github.com/mastra-ai/mastra/commit/cccf9c8b2d2dfc1a5e63919395b83d78c89682a0), [`61a5705`](https://github.com/mastra-ai/mastra/commit/61a570551278b6743e64243b3ce7d73de915ca8a), [`db70a48`](https://github.com/mastra-ai/mastra/commit/db70a48aeeeeb8e5f92007e8ede52c364ce15287), [`f0fdc14`](https://github.com/mastra-ai/mastra/commit/f0fdc14ee233d619266b3d2bbdeea7d25cfc6d13), [`db18bc9`](https://github.com/mastra-ai/mastra/commit/db18bc9c3825e2c1a0ad9a183cc9935f6691bfa1), [`9b37b56`](https://github.com/mastra-ai/mastra/commit/9b37b565e1f2a76c24f728945cc740c2b09be9da), [`41a23c3`](https://github.com/mastra-ai/mastra/commit/41a23c32f9877d71810f37e24930515df2ff7a0f), [`5d171ad`](https://github.com/mastra-ai/mastra/commit/5d171ad9ef340387276b77c2bb3e83e83332d729), [`f03ae60`](https://github.com/mastra-ai/mastra/commit/f03ae60500fe350c9d828621006cdafe1975fdd8), [`d1e74a0`](https://github.com/mastra-ai/mastra/commit/d1e74a0a293866dece31022047f5dbab65a304d0), [`39e7869`](https://github.com/mastra-ai/mastra/commit/39e7869bc7d0ee391077ce291474d8a84eedccff), [`5761926`](https://github.com/mastra-ai/mastra/commit/57619260c4a2cdd598763abbacd90de594c6bc76), [`c900fdd`](https://github.com/mastra-ai/mastra/commit/c900fdd504c41348efdffb205cfe80d48c38fa33), [`604a79f`](https://github.com/mastra-ai/mastra/commit/604a79fecf276e26a54a3fe01bb94e65315d2e0e), [`887f0b4`](https://github.com/mastra-ai/mastra/commit/887f0b4746cdbd7cb7d6b17ac9f82aeb58037ea5), [`2562143`](https://github.com/mastra-ai/mastra/commit/256214336b4faa78646c9c1776612393790d8784), [`ef11a61`](https://github.com/mastra-ai/mastra/commit/ef11a61920fa0ed08a5b7ceedd192875af119749)]:
+  - @mastra/core@1.0.0-beta.6
+
 ## 0.12.0-beta.0
 
 ### Minor Changes

package/README.md

@@ -12,16 +12,50 @@ npm install @mastra/voice-google
 
 ## Configuration
 
-You can authenticate in one of the following ways:
+The module supports multiple authentication methods:
+
+### Option 1: API Key (Development)
+
+Use an API key from [Google Cloud Console](https://console.cloud.google.com/apis/credentials):
 
 ```bash
 GOOGLE_API_KEY=your_api_key
-# or provide a service account key picked up by ADC
+```
+
+### Option 2: Service Account (Recommended)
+
+Use a service account key file:
+
+```bash
 GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
 ```
 
+### Option 3: Vertex AI (Recommended for Production)
+
+Use OAuth authentication with Google Cloud Platform for enterprise deployments:
+
+```bash
+# Set project ID
+GOOGLE_CLOUD_PROJECT=your_project_id
+
+# Optional: Set location (defaults to us-central1)
+GOOGLE_CLOUD_LOCATION=us-central1
+
+# Authenticate via gcloud CLI
+gcloud auth application-default login
+```
+
+Or use a service account:
+
+```bash
+GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
+GOOGLE_CLOUD_PROJECT=your_project_id
+```
+
 ## Usage
 
+### Standard Usage
+
 ```typescript
 import { GoogleVoice } from '@mastra/voice-google';
 
@@ -50,6 +84,129 @@ const audioStream = await voice.speak('Hello from Mastra!', {
 const text = await voice.listen(audioStream);
 ```
 
+### Vertex AI Mode
+
+For enterprise deployments, use Vertex AI mode which provides better integration with Google Cloud infrastructure:
+
+```typescript
+import { GoogleVoice } from '@mastra/voice-google';
+
+// Initialize with Vertex AI
+const voice = new GoogleVoice({
+  vertexAI: true,
+  project: 'your-gcp-project',
+  location: 'us-central1', // Optional, defaults to 'us-central1'
+  speaker: 'en-US-Studio-O',
+});
+
+// Works the same as standard mode
+const audioStream = await voice.speak('Hello from Vertex AI!');
+const text = await voice.listen(audioStream);
+
+// Check if using Vertex AI
+console.log(voice.isUsingVertexAI()); // true
+console.log(voice.getProject()); // 'your-gcp-project'
+console.log(voice.getLocation()); // 'us-central1'
+```
+
+### Vertex AI with Service Account
+
+```typescript
+import { GoogleVoice } from '@mastra/voice-google';
+
+const voice = new GoogleVoice({
+  vertexAI: true,
+  project: 'your-gcp-project',
+  location: 'us-central1',
+  speechModel: {
+    keyFilename: '/path/to/service-account.json',
+  },
+  listeningModel: {
+    keyFilename: '/path/to/service-account.json',
+  },
+});
+```
+
+### Vertex AI with In-Memory Credentials
+
+```typescript
+import { GoogleVoice } from '@mastra/voice-google';
+
+const voice = new GoogleVoice({
+  vertexAI: true,
+  project: 'your-gcp-project',
+  speechModel: {
+    credentials: {
+      client_email: 'service-account@project.iam.gserviceaccount.com',
+      private_key: '-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----',
+    },
+  },
+});
+```
+
+## API Reference
+
+### Constructor Options
+
+| Option           | Type                | Description                                      |
+| ---------------- | ------------------- | ------------------------------------------------ |
+| `speechModel`    | `GoogleModelConfig` | Configuration for TTS                            |
+| `listeningModel` | `GoogleModelConfig` | Configuration for STT                            |
+| `speaker`        | `string`            | Default voice ID (default: `'en-US-Casual-K'`)   |
+| `vertexAI`       | `boolean`           | Enable Vertex AI mode (default: `false`)         |
+| `project`        | `string`            | Google Cloud project ID (required for Vertex AI) |
+| `location`       | `string`            | Google Cloud region (default: `'us-central1'`)   |
+
+### GoogleModelConfig
+
+| Option        | Type     | Description                           |
+| ------------- | -------- | ------------------------------------- |
+| `apiKey`      | `string` | Google Cloud API key                  |
+| `keyFilename` | `string` | Path to service account JSON key file |
+| `credentials` | `object` | In-memory service account credentials |
+
+### Methods
+
+#### `speak(input, options?)`
+
+Converts text to speech.
+
+- `input`: `string | NodeJS.ReadableStream` - Text to convert
+- `options.speaker`: Override default voice
+- `options.languageCode`: Language code (e.g., `'en-US'`)
+- `options.audioConfig`: Audio encoding options
+
+Returns: `Promise<NodeJS.ReadableStream>` - Audio stream
+
+#### `listen(audioStream, options?)`
+
+Converts speech to text.
+
+- `audioStream`: `NodeJS.ReadableStream` - Audio to transcribe
+- `options.config`: Recognition configuration
+
+Returns: `Promise<string>` - Transcribed text
+
+#### `getSpeakers(options?)`
+
+Lists available voices.
+
+- `options.languageCode`: Filter by language (default: `'en-US'`)
+
+Returns: `Promise<Array<{ voiceId: string, languageCodes: string[] }>>`
+
+#### `isUsingVertexAI()`
+
+Returns `true` if Vertex AI mode is enabled.
+
+#### `getProject()`
+
+Returns the configured Google Cloud project ID.
+
+#### `getLocation()`
+
+Returns the configured Google Cloud location/region.
+
 ## Features
 
 - Neural Text-to-Speech synthesis
@@ -58,6 +215,35 @@ const text = await voice.listen(audioStream);
 - Streaming support for both speech and transcription
 - High-quality audio processing
 - Natural-sounding voice synthesis
+- **Vertex AI support for enterprise deployments**
+
+## Required Permissions for Vertex AI
+
+When using Vertex AI, ensure your service account or user has the appropriate IAM roles and OAuth scopes:
+
+### IAM Roles
+
+**For Text-to-Speech:**
+
+- `roles/texttospeech.admin` - Text-to-Speech Admin (full access)
+- `roles/texttospeech.editor` - Text-to-Speech Editor (create and manage)
+- `roles/texttospeech.viewer` - Text-to-Speech Viewer (read-only)
+
+**For Speech-to-Text:**
+
+- `roles/speech.client` - Speech-to-Text Client
+
+### OAuth Scopes
+
+**For synchronous Text-to-Speech synthesis:**
+
+- `https://www.googleapis.com/auth/cloud-platform` - Full access to Google Cloud Platform services
+
+**For long-audio Text-to-Speech operations:**
+
+- `locations.longAudioSynthesize` - Create long-audio synthesis operations
+- `operations.get` - Get operation status
+- `operations.list` - List operations
 
 ## Voice Options
 

package/dist/index.cjs

@@ -6,10 +6,16 @@ var textToSpeech = require('@google-cloud/text-to-speech');
 var voice = require('@mastra/core/voice');
 
 // src/index.ts
-var resolveAuthConfig = (modelConfig, fallback) => {
+var resolveAuthConfig = (modelConfig, fallback, vertexConfig) => {
   const resolved = {};
+  if (vertexConfig?.vertexAI) {
+    const projectId = vertexConfig.project || process.env.GOOGLE_CLOUD_PROJECT;
+    if (projectId) {
+      resolved.projectId = projectId;
+    }
+  }
   const apiKey = modelConfig?.apiKey ?? fallback.apiKey;
-  if (apiKey) {
+  if (apiKey && !vertexConfig?.vertexAI) {
     resolved.apiKey = apiKey;
   }
   const keyFilename = modelConfig?.keyFilename ?? fallback.keyFilename;
@@ -22,44 +28,57 @@ var resolveAuthConfig = (modelConfig, fallback) => {
   }
   return resolved;
 };
-var buildAuthOptions = (config) => {
+var buildAuthOptions = (config, vertexConfig) => {
+  const options = {};
   if (config.credentials) {
-    return { credentials: config.credentials };
+    options.credentials = config.credentials;
   }
   if (config.keyFilename) {
-    return { keyFilename: config.keyFilename };
+    options.keyFilename = config.keyFilename;
   }
-  if (config.apiKey) {
-    return { apiKey: config.apiKey };
+  if (config.apiKey && !vertexConfig?.vertexAI) {
+    options.apiKey = config.apiKey;
   }
-  return {};
+  if (config.projectId) {
+    options.projectId = config.projectId;
+  }
+  return options;
 };
 var DEFAULT_VOICE = "en-US-Casual-K";
 var GoogleVoice = class extends voice.MastraVoice {
   ttsClient;
   speechClient;
+  vertexAI;
+  project;
+  location;
   /**
    * Creates an instance of GoogleVoice
-   * @param {Object} config - Configuration options
+   * @param {GoogleVoiceConfig} config - Configuration options
    * @param {GoogleModelConfig} [config.speechModel] - Configuration for speech synthesis
    * @param {GoogleModelConfig} [config.listeningModel] - Configuration for speech recognition
    * @param {string} [config.speaker] - Default voice ID to use for speech synthesis
+   * @param {boolean} [config.vertexAI] - Enable Vertex AI mode
+   * @param {string} [config.project] - Google Cloud project ID (required for Vertex AI)
+   * @param {string} [config.location] - Google Cloud region (default: 'us-central1')
    */
-  constructor({
-    listeningModel,
-    speechModel,
-    speaker
-  } = {}) {
+  constructor({ listeningModel, speechModel, speaker, vertexAI = false, project, location } = {}) {
     const defaultApiKey = process.env.GOOGLE_API_KEY;
     const defaultKeyFilename = process.env.GOOGLE_APPLICATION_CREDENTIALS;
     const defaultSpeaker = DEFAULT_VOICE;
+    const resolvedProject = project || process.env.GOOGLE_CLOUD_PROJECT;
+    const resolvedLocation = location || process.env.GOOGLE_CLOUD_LOCATION || "us-central1";
+    if (vertexAI && !resolvedProject) {
+      throw new Error(
+        "Google Cloud project ID is required when using Vertex AI. Set GOOGLE_CLOUD_PROJECT environment variable or pass project to constructor."
+      );
+    }
+    const vertexConfig = { vertexAI, project: resolvedProject };
     const sharedFallback = {
       apiKey: defaultApiKey ?? speechModel?.apiKey ?? listeningModel?.apiKey,
       keyFilename: defaultKeyFilename ?? speechModel?.keyFilename ?? listeningModel?.keyFilename,
-      credentials: speechModel?.credentials ?? listeningModel?.credentials
-    };
-    const speechAuthConfig = resolveAuthConfig(speechModel, sharedFallback);
-    const listeningAuthConfig = resolveAuthConfig(listeningModel, sharedFallback);
+      credentials: speechModel?.credentials ?? listeningModel?.credentials};
+    const speechAuthConfig = resolveAuthConfig(speechModel, sharedFallback, vertexConfig);
+    const listeningAuthConfig = resolveAuthConfig(listeningModel, sharedFallback, vertexConfig);
     super({
       speechModel: {
         name: "",
@@ -71,11 +90,35 @@ var GoogleVoice = class extends voice.MastraVoice {
       },
       speaker: speaker ?? defaultSpeaker
     });
-    const ttsOptions = buildAuthOptions(speechAuthConfig);
-    const speechOptions = buildAuthOptions(listeningAuthConfig);
+    this.vertexAI = vertexAI;
+    this.project = resolvedProject;
+    this.location = resolvedLocation;
+    const ttsOptions = buildAuthOptions(speechAuthConfig, { vertexAI});
+    const speechOptions = buildAuthOptions(listeningAuthConfig, { vertexAI});
     this.ttsClient = new textToSpeech.TextToSpeechClient(ttsOptions);
     this.speechClient = new speech.SpeechClient(speechOptions);
   }
+  /**
+   * Check if Vertex AI mode is enabled
+   * @returns {boolean} True if using Vertex AI
+   */
+  isUsingVertexAI() {
+    return this.vertexAI;
+  }
+  /**
+   * Get the configured Google Cloud project ID
+   * @returns {string | undefined} The project ID or undefined if not set
+   */
+  getProject() {
+    return this.project;
+  }
+  /**
+   * Get the configured Google Cloud location/region
+   * @returns {string} The location (default: 'us-central1')
+   */
+  getLocation() {
+    return this.location;
+  }
   /**
    * Gets a list of available voices
    * @returns {Promise<Array<{voiceId: string, languageCodes: string[]}>>} List of available voices and their supported languages. Default language is en-US.

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["MastraVoice","TextToSpeechClient","SpeechClient","stream","PassThrough"],"mappings":"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","file":"index.cjs","sourcesContent":["import { PassThrough } from 'stream';\n\nimport { SpeechClient } from '@google-cloud/speech';\nimport type { google as SpeechTypes } from '@google-cloud/speech/build/protos/protos';\nimport { TextToSpeechClient } from '@google-cloud/text-to-speech';\nimport type { google as TextToSpeechTypes } from '@google-cloud/text-to-speech/build/protos/protos';\nimport { MastraVoice } from '@mastra/core/voice';\n\n/**\n * Configuration for Google Cloud Voice models\n * @interface GoogleModelConfig\n * @property {string} [apiKey] - Optional Google Cloud API key. If not provided, will use GOOGLE_API_KEY environment variable\n * @property {string} [keyFilename] - Optional path to a service account key file. If not provided, will use GOOGLE_APPLICATION_CREDENTIALS environment variable\n * @property {{ client_email?: string; private_key?: string }} [credentials] - Optional in-memory service account credentials\n */\nexport interface GoogleModelConfig {\n  apiKey?: string;\n  keyFilename?: string;\n  credentials?: {\n    client_email?: string;\n    private_key?: string;\n    [key: string]: unknown;\n  };\n}\n\ntype AuthConfig = Pick<GoogleModelConfig, 'apiKey' | 'keyFilename' | 'credentials'>;\n\ntype GoogleClientOptions = AuthConfig;\n\nconst resolveAuthConfig = (modelConfig: GoogleModelConfig | undefined, fallback: AuthConfig): AuthConfig => {\n  const resolved: AuthConfig = {};\n\n  const apiKey = modelConfig?.apiKey ?? fallback.apiKey;\n  if (apiKey) {\n    resolved.apiKey = apiKey;\n  }\n\n  const keyFilename = modelConfig?.keyFilename ?? fallback.keyFilename;\n  if (keyFilename) {\n    resolved.keyFilename = keyFilename;\n  }\n\n  const credentials = modelConfig?.credentials ?? fallback.credentials;\n  if (credentials) {\n    resolved.credentials = credentials;\n  }\n\n  return resolved;\n};\n\nconst buildAuthOptions = (config: AuthConfig): GoogleClientOptions => {\n  if (config.credentials) {\n    return { credentials: config.credentials };\n  }\n\n  if (config.keyFilename) {\n    return { keyFilename: config.keyFilename };\n  }\n\n  if (config.apiKey) {\n    return { apiKey: config.apiKey };\n  }\n\n  return {};\n};\n\nconst DEFAULT_VOICE = 'en-US-Casual-K';\n\n/**\n * GoogleVoice class provides Text-to-Speech and Speech-to-Text capabilities using Google Cloud services\n * @class GoogleVoice\n * @extends MastraVoice\n */\nexport class GoogleVoice extends MastraVoice {\n  private ttsClient: TextToSpeechClient;\n  private speechClient: SpeechClient;\n\n  /**\n   * Creates an instance of GoogleVoice\n   * @param {Object} config - Configuration options\n   * @param {GoogleModelConfig} [config.speechModel] - Configuration for speech synthesis\n   * @param {GoogleModelConfig} [config.listeningModel] - Configuration for speech recognition\n   * @param {string} [config.speaker] - Default voice ID to use for speech synthesis\n   */\n  constructor({\n    listeningModel,\n    speechModel,\n    speaker,\n  }: {\n    listeningModel?: GoogleModelConfig;\n    speechModel?: GoogleModelConfig;\n    speaker?: string;\n  } = {}) {\n    const defaultApiKey = process.env.GOOGLE_API_KEY;\n    const defaultKeyFilename = process.env.GOOGLE_APPLICATION_CREDENTIALS;\n    const defaultSpeaker = DEFAULT_VOICE;\n\n    const sharedFallback: AuthConfig = {\n      apiKey: defaultApiKey ?? speechModel?.apiKey ?? listeningModel?.apiKey,\n      keyFilename: defaultKeyFilename ?? speechModel?.keyFilename ?? listeningModel?.keyFilename,\n      credentials: speechModel?.credentials ?? listeningModel?.credentials,\n    };\n\n    const speechAuthConfig = resolveAuthConfig(speechModel, sharedFallback);\n    const listeningAuthConfig = resolveAuthConfig(listeningModel, sharedFallback);\n\n    super({\n      speechModel: {\n        name: '',\n        apiKey: speechAuthConfig.apiKey ?? defaultApiKey,\n      },\n      listeningModel: {\n        name: '',\n        apiKey: listeningAuthConfig.apiKey ?? defaultApiKey,\n      },\n      speaker: speaker ?? defaultSpeaker,\n    });\n\n    const ttsOptions = buildAuthOptions(speechAuthConfig);\n    const speechOptions = buildAuthOptions(listeningAuthConfig);\n\n    this.ttsClient = new TextToSpeechClient(ttsOptions);\n\n    this.speechClient = new SpeechClient(speechOptions);\n  }\n\n  /**\n   * Gets a list of available voices\n   * @returns {Promise<Array<{voiceId: string, languageCodes: string[]}>>} List of available voices and their supported languages. Default language is en-US.\n   */\n  async getSpeakers({ languageCode = 'en-US' }: { languageCode?: string } = {}) {\n    const [response] = await this.ttsClient.listVoices({ languageCode: languageCode });\n    return (response?.voices || [])\n      .filter(voice => voice.name && voice.languageCodes)\n      .map(voice => ({\n        voiceId: voice.name!,\n        languageCodes: voice.languageCodes!,\n      }));\n  }\n\n  private async streamToString(stream: NodeJS.ReadableStream): Promise<string> {\n    const chunks: Buffer[] = [];\n    for await (const chunk of stream) {\n      if (typeof chunk === 'string') {\n        chunks.push(Buffer.from(chunk));\n      } else {\n        chunks.push(chunk);\n      }\n    }\n    return Buffer.concat(chunks).toString('utf-8');\n  }\n\n  /**\n   * Converts text to speech\n   * @param {string | NodeJS.ReadableStream} input - Text or stream to convert to speech\n   * @param {Object} [options] - Speech synthesis options\n   * @param {string} [options.speaker] - Voice ID to use\n   * @param {string} [options.languageCode] - Language code for the voice\n   * @param {TextToSpeechTypes.cloud.texttospeech.v1.ISynthesizeSpeechRequest['audioConfig']} [options.audioConfig] - Audio configuration options\n   * @returns {Promise<NodeJS.ReadableStream>} Stream of synthesized audio. Default encoding is LINEAR16.\n   */\n  async speak(\n    input: string | NodeJS.ReadableStream,\n    options?: {\n      speaker?: string;\n      languageCode?: string;\n      audioConfig?: TextToSpeechTypes.cloud.texttospeech.v1.ISynthesizeSpeechRequest['audioConfig'];\n    },\n  ): Promise<NodeJS.ReadableStream> {\n    const text = typeof input === 'string' ? input : await this.streamToString(input);\n\n    const request: TextToSpeechTypes.cloud.texttospeech.v1.ISynthesizeSpeechRequest = {\n      input: { text },\n      voice: {\n        name: options?.speaker || this.speaker,\n        languageCode: options?.languageCode || options?.speaker?.split('-').slice(0, 2).join('-') || 'en-US',\n      },\n      audioConfig: options?.audioConfig || { audioEncoding: 'LINEAR16' },\n    };\n\n    const [response] = await this.ttsClient.synthesizeSpeech(request);\n\n    if (!response.audioContent) {\n      throw new Error('No audio content returned.');\n    }\n\n    if (typeof response.audioContent === 'string') {\n      throw new Error('Audio content is a string.');\n    }\n\n    const stream = new PassThrough();\n    stream.end(Buffer.from(response.audioContent));\n    return stream;\n  }\n\n  /**\n   * Checks if listening capabilities are enabled.\n   *\n   * @returns {Promise<{ enabled: boolean }>}\n   */\n  async getListener() {\n    return { enabled: true };\n  }\n\n  /**\n   * Converts speech to text\n   * @param {NodeJS.ReadableStream} audioStream - Audio stream to transcribe. Default encoding is LINEAR16.\n   * @param {Object} [options] - Recognition options\n   * @param {SpeechTypes.cloud.speech.v1.IRecognitionConfig} [options.config] - Recognition configuration\n   * @returns {Promise<string>} Transcribed text\n   */\n  async listen(\n    audioStream: NodeJS.ReadableStream,\n    options?: { stream?: boolean; config?: SpeechTypes.cloud.speech.v1.IRecognitionConfig },\n  ): Promise<string> {\n    const chunks: Buffer[] = [];\n    for await (const chunk of audioStream) {\n      if (typeof chunk === 'string') {\n        chunks.push(Buffer.from(chunk));\n      } else {\n        chunks.push(chunk);\n      }\n    }\n    const buffer = Buffer.concat(chunks);\n\n    let request = {\n      config: {\n        encoding: 'LINEAR16',\n        languageCode: 'en-US',\n        ...options?.config,\n      },\n      audio: {\n        content: buffer.toString('base64'),\n      },\n    };\n    const [response] = await this.speechClient.recognize(request as SpeechTypes.cloud.speech.v1.IRecognizeRequest);\n\n    if (!response.results || response.results.length === 0) {\n      throw new Error('No transcription results returned');\n    }\n\n    const transcription = response.results\n      .map((result: any) => {\n        if (!result.alternatives || result.alternatives.length === 0) {\n          return '';\n        }\n        return result.alternatives[0].transcript || '';\n      })\n      .filter((text: string) => text.length > 0)\n      .join(' ');\n\n    if (!transcription) {\n      throw new Error('No valid transcription found in results');\n    }\n\n    return transcription;\n  }\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["MastraVoice","TextToSpeechClient","SpeechClient","stream","PassThrough"],"mappings":"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","file":"index.cjs","sourcesContent":["import { PassThrough } from 'node:stream';\n\nimport { SpeechClient } from '@google-cloud/speech';\nimport type { google as SpeechTypes } from '@google-cloud/speech/build/protos/protos';\nimport { TextToSpeechClient } from '@google-cloud/text-to-speech';\nimport type { google as TextToSpeechTypes } from '@google-cloud/text-to-speech/build/protos/protos';\nimport { MastraVoice } from '@mastra/core/voice';\n\n/**\n * Configuration for Google Cloud Voice models\n * @interface GoogleModelConfig\n * @property {string} [apiKey] - Optional Google Cloud API key. If not provided, will use GOOGLE_API_KEY environment variable\n * @property {string} [keyFilename] - Optional path to a service account key file. If not provided, will use GOOGLE_APPLICATION_CREDENTIALS environment variable\n * @property {{ client_email?: string; private_key?: string }} [credentials] - Optional in-memory service account credentials\n */\nexport interface GoogleModelConfig {\n  apiKey?: string;\n  keyFilename?: string;\n  credentials?: {\n    client_email?: string;\n    private_key?: string;\n    [key: string]: unknown;\n  };\n}\n\n/**\n * Configuration options for GoogleVoice\n * @interface GoogleVoiceConfig\n */\nexport interface GoogleVoiceConfig {\n  /** Configuration for speech synthesis (TTS) */\n  speechModel?: GoogleModelConfig;\n  /** Configuration for speech recognition (STT) */\n  listeningModel?: GoogleModelConfig;\n  /** Default voice ID to use for speech synthesis */\n  speaker?: string;\n  /**\n   * Enable Vertex AI mode for enterprise deployments.\n   * When true, uses Google Cloud project-based authentication instead of API keys.\n   * Requires `project` to be set or GOOGLE_CLOUD_PROJECT environment variable.\n   */\n  vertexAI?: boolean;\n  /**\n   * Google Cloud project ID (required when vertexAI is true).\n   * Falls back to GOOGLE_CLOUD_PROJECT environment variable.\n   */\n  project?: string;\n  /**\n   * Google Cloud region for Vertex AI endpoints.\n   * Falls back to GOOGLE_CLOUD_LOCATION environment variable.\n   * @default 'us-central1'\n   */\n  location?: string;\n}\n\ntype AuthConfig = Pick<GoogleModelConfig, 'apiKey' | 'keyFilename' | 'credentials'> & {\n  projectId?: string;\n};\n\ntype GoogleClientOptions = AuthConfig;\n\nconst resolveAuthConfig = (\n  modelConfig: GoogleModelConfig | undefined,\n  fallback: AuthConfig,\n  vertexConfig?: { vertexAI?: boolean; project?: string },\n): AuthConfig => {\n  const resolved: AuthConfig = {};\n\n  // For Vertex AI, prioritize project-based auth over API keys\n  if (vertexConfig?.vertexAI) {\n    const projectId = vertexConfig.project || process.env.GOOGLE_CLOUD_PROJECT;\n    if (projectId) {\n      resolved.projectId = projectId;\n    }\n  }\n\n  const apiKey = modelConfig?.apiKey ?? fallback.apiKey;\n  // Only use API key if not in Vertex AI mode\n  if (apiKey && !vertexConfig?.vertexAI) {\n    resolved.apiKey = apiKey;\n  }\n\n  const keyFilename = modelConfig?.keyFilename ?? fallback.keyFilename;\n  if (keyFilename) {\n    resolved.keyFilename = keyFilename;\n  }\n\n  const credentials = modelConfig?.credentials ?? fallback.credentials;\n  if (credentials) {\n    resolved.credentials = credentials;\n  }\n\n  return resolved;\n};\n\nconst buildAuthOptions = (\n  config: AuthConfig,\n  vertexConfig?: { vertexAI?: boolean; location?: string },\n): GoogleClientOptions => {\n  const options: GoogleClientOptions = {};\n\n  if (config.credentials) {\n    options.credentials = config.credentials;\n  }\n\n  if (config.keyFilename) {\n    options.keyFilename = config.keyFilename;\n  }\n\n  // Only use API key if not using Vertex AI\n  if (config.apiKey && !vertexConfig?.vertexAI) {\n    options.apiKey = config.apiKey;\n  }\n\n  // For Vertex AI, set the project ID\n  if (config.projectId) {\n    options.projectId = config.projectId;\n  }\n\n  return options;\n};\n\nconst DEFAULT_VOICE = 'en-US-Casual-K';\n\n/**\n * GoogleVoice class provides Text-to-Speech and Speech-to-Text capabilities using Google Cloud services.\n * Supports both standard Google Cloud API authentication and Vertex AI mode for enterprise deployments.\n *\n * @class GoogleVoice\n * @extends MastraVoice\n *\n * @example Standard usage with API key\n * ```typescript\n * const voice = new GoogleVoice({\n *   speechModel: { apiKey: 'your-api-key' },\n *   speaker: 'en-US-Studio-O',\n * });\n * ```\n *\n * @example Vertex AI mode (recommended for production)\n * ```typescript\n * const voice = new GoogleVoice({\n *   vertexAI: true,\n *   project: 'your-gcp-project',\n *   location: 'us-central1',\n *   speaker: 'en-US-Studio-O',\n * });\n * ```\n *\n * @example Vertex AI with service account\n * ```typescript\n * const voice = new GoogleVoice({\n *   vertexAI: true,\n *   project: 'your-gcp-project',\n *   speechModel: {\n *     keyFilename: '/path/to/service-account.json',\n *   },\n * });\n * ```\n */\nexport class GoogleVoice extends MastraVoice {\n  private ttsClient: TextToSpeechClient;\n  private speechClient: SpeechClient;\n  private readonly vertexAI: boolean;\n  private readonly project?: string;\n  private readonly location: string;\n\n  /**\n   * Creates an instance of GoogleVoice\n   * @param {GoogleVoiceConfig} config - Configuration options\n   * @param {GoogleModelConfig} [config.speechModel] - Configuration for speech synthesis\n   * @param {GoogleModelConfig} [config.listeningModel] - Configuration for speech recognition\n   * @param {string} [config.speaker] - Default voice ID to use for speech synthesis\n   * @param {boolean} [config.vertexAI] - Enable Vertex AI mode\n   * @param {string} [config.project] - Google Cloud project ID (required for Vertex AI)\n   * @param {string} [config.location] - Google Cloud region (default: 'us-central1')\n   */\n  constructor({ listeningModel, speechModel, speaker, vertexAI = false, project, location }: GoogleVoiceConfig = {}) {\n    const defaultApiKey = process.env.GOOGLE_API_KEY;\n    const defaultKeyFilename = process.env.GOOGLE_APPLICATION_CREDENTIALS;\n    const defaultSpeaker = DEFAULT_VOICE;\n\n    // Resolve Vertex AI configuration\n    const resolvedProject = project || process.env.GOOGLE_CLOUD_PROJECT;\n    const resolvedLocation = location || process.env.GOOGLE_CLOUD_LOCATION || 'us-central1';\n\n    // Validate Vertex AI configuration\n    if (vertexAI && !resolvedProject) {\n      throw new Error(\n        'Google Cloud project ID is required when using Vertex AI. ' +\n          'Set GOOGLE_CLOUD_PROJECT environment variable or pass project to constructor.',\n      );\n    }\n\n    const vertexConfig = { vertexAI, project: resolvedProject };\n\n    const sharedFallback: AuthConfig = {\n      apiKey: defaultApiKey ?? speechModel?.apiKey ?? listeningModel?.apiKey,\n      keyFilename: defaultKeyFilename ?? speechModel?.keyFilename ?? listeningModel?.keyFilename,\n      credentials: speechModel?.credentials ?? listeningModel?.credentials,\n      projectId: resolvedProject,\n    };\n\n    const speechAuthConfig = resolveAuthConfig(speechModel, sharedFallback, vertexConfig);\n    const listeningAuthConfig = resolveAuthConfig(listeningModel, sharedFallback, vertexConfig);\n\n    super({\n      speechModel: {\n        name: '',\n        apiKey: speechAuthConfig.apiKey ?? defaultApiKey,\n      },\n      listeningModel: {\n        name: '',\n        apiKey: listeningAuthConfig.apiKey ?? defaultApiKey,\n      },\n      speaker: speaker ?? defaultSpeaker,\n    });\n\n    this.vertexAI = vertexAI;\n    this.project = resolvedProject;\n    this.location = resolvedLocation;\n\n    const ttsOptions = buildAuthOptions(speechAuthConfig, { vertexAI, location: resolvedLocation });\n    const speechOptions = buildAuthOptions(listeningAuthConfig, { vertexAI, location: resolvedLocation });\n\n    this.ttsClient = new TextToSpeechClient(ttsOptions);\n    this.speechClient = new SpeechClient(speechOptions);\n  }\n\n  /**\n   * Check if Vertex AI mode is enabled\n   * @returns {boolean} True if using Vertex AI\n   */\n  isUsingVertexAI(): boolean {\n    return this.vertexAI;\n  }\n\n  /**\n   * Get the configured Google Cloud project ID\n   * @returns {string | undefined} The project ID or undefined if not set\n   */\n  getProject(): string | undefined {\n    return this.project;\n  }\n\n  /**\n   * Get the configured Google Cloud location/region\n   * @returns {string} The location (default: 'us-central1')\n   */\n  getLocation(): string {\n    return this.location;\n  }\n\n  /**\n   * Gets a list of available voices\n   * @returns {Promise<Array<{voiceId: string, languageCodes: string[]}>>} List of available voices and their supported languages. Default language is en-US.\n   */\n  async getSpeakers({ languageCode = 'en-US' }: { languageCode?: string } = {}) {\n    const [response] = await this.ttsClient.listVoices({ languageCode: languageCode });\n    return (response?.voices || [])\n      .filter(voice => voice.name && voice.languageCodes)\n      .map(voice => ({\n        voiceId: voice.name!,\n        languageCodes: voice.languageCodes!,\n      }));\n  }\n\n  private async streamToString(stream: NodeJS.ReadableStream): Promise<string> {\n    const chunks: Buffer[] = [];\n    for await (const chunk of stream) {\n      if (typeof chunk === 'string') {\n        chunks.push(Buffer.from(chunk));\n      } else {\n        chunks.push(chunk);\n      }\n    }\n    return Buffer.concat(chunks).toString('utf-8');\n  }\n\n  /**\n   * Converts text to speech\n   * @param {string | NodeJS.ReadableStream} input - Text or stream to convert to speech\n   * @param {Object} [options] - Speech synthesis options\n   * @param {string} [options.speaker] - Voice ID to use\n   * @param {string} [options.languageCode] - Language code for the voice\n   * @param {TextToSpeechTypes.cloud.texttospeech.v1.ISynthesizeSpeechRequest['audioConfig']} [options.audioConfig] - Audio configuration options\n   * @returns {Promise<NodeJS.ReadableStream>} Stream of synthesized audio. Default encoding is LINEAR16.\n   */\n  async speak(\n    input: string | NodeJS.ReadableStream,\n    options?: {\n      speaker?: string;\n      languageCode?: string;\n      audioConfig?: TextToSpeechTypes.cloud.texttospeech.v1.ISynthesizeSpeechRequest['audioConfig'];\n    },\n  ): Promise<NodeJS.ReadableStream> {\n    const text = typeof input === 'string' ? input : await this.streamToString(input);\n\n    const request: TextToSpeechTypes.cloud.texttospeech.v1.ISynthesizeSpeechRequest = {\n      input: { text },\n      voice: {\n        name: options?.speaker || this.speaker,\n        languageCode: options?.languageCode || options?.speaker?.split('-').slice(0, 2).join('-') || 'en-US',\n      },\n      audioConfig: options?.audioConfig || { audioEncoding: 'LINEAR16' },\n    };\n\n    const [response] = await this.ttsClient.synthesizeSpeech(request);\n\n    if (!response.audioContent) {\n      throw new Error('No audio content returned.');\n    }\n\n    if (typeof response.audioContent === 'string') {\n      throw new Error('Audio content is a string.');\n    }\n\n    const stream = new PassThrough();\n    stream.end(Buffer.from(response.audioContent));\n    return stream;\n  }\n\n  /**\n   * Checks if listening capabilities are enabled.\n   *\n   * @returns {Promise<{ enabled: boolean }>}\n   */\n  async getListener() {\n    return { enabled: true };\n  }\n\n  /**\n   * Converts speech to text\n   * @param {NodeJS.ReadableStream} audioStream - Audio stream to transcribe. Default encoding is LINEAR16.\n   * @param {Object} [options] - Recognition options\n   * @param {SpeechTypes.cloud.speech.v1.IRecognitionConfig} [options.config] - Recognition configuration\n   * @returns {Promise<string>} Transcribed text\n   */\n  async listen(\n    audioStream: NodeJS.ReadableStream,\n    options?: { stream?: boolean; config?: SpeechTypes.cloud.speech.v1.IRecognitionConfig },\n  ): Promise<string> {\n    const chunks: Buffer[] = [];\n    for await (const chunk of audioStream) {\n      if (typeof chunk === 'string') {\n        chunks.push(Buffer.from(chunk));\n      } else {\n        chunks.push(chunk);\n      }\n    }\n    const buffer = Buffer.concat(chunks);\n\n    let request = {\n      config: {\n        encoding: 'LINEAR16',\n        languageCode: 'en-US',\n        ...options?.config,\n      },\n      audio: {\n        content: buffer.toString('base64'),\n      },\n    };\n    const [response] = await this.speechClient.recognize(request as SpeechTypes.cloud.speech.v1.IRecognizeRequest);\n\n    if (!response.results || response.results.length === 0) {\n      throw new Error('No transcription results returned');\n    }\n\n    const transcription = response.results\n      .map((result: any) => {\n        if (!result.alternatives || result.alternatives.length === 0) {\n          return '';\n        }\n        return result.alternatives[0].transcript || '';\n      })\n      .filter((text: string) => text.length > 0)\n      .join(' ');\n\n    if (!transcription) {\n      throw new Error('No valid transcription found in results');\n    }\n\n    return transcription;\n  }\n}\n"]}

package/dist/index.d.ts

@@ -18,25 +18,102 @@ export interface GoogleModelConfig {
     };
 }
 /**
- * GoogleVoice class provides Text-to-Speech and Speech-to-Text capabilities using Google Cloud services
+ * Configuration options for GoogleVoice
+ * @interface GoogleVoiceConfig
+ */
+export interface GoogleVoiceConfig {
+    /** Configuration for speech synthesis (TTS) */
+    speechModel?: GoogleModelConfig;
+    /** Configuration for speech recognition (STT) */
+    listeningModel?: GoogleModelConfig;
+    /** Default voice ID to use for speech synthesis */
+    speaker?: string;
+    /**
+     * Enable Vertex AI mode for enterprise deployments.
+     * When true, uses Google Cloud project-based authentication instead of API keys.
+     * Requires `project` to be set or GOOGLE_CLOUD_PROJECT environment variable.
+     */
+    vertexAI?: boolean;
+    /**
+     * Google Cloud project ID (required when vertexAI is true).
+     * Falls back to GOOGLE_CLOUD_PROJECT environment variable.
+     */
+    project?: string;
+    /**
+     * Google Cloud region for Vertex AI endpoints.
+     * Falls back to GOOGLE_CLOUD_LOCATION environment variable.
+     * @default 'us-central1'
+     */
+    location?: string;
+}
+/**
+ * GoogleVoice class provides Text-to-Speech and Speech-to-Text capabilities using Google Cloud services.
+ * Supports both standard Google Cloud API authentication and Vertex AI mode for enterprise deployments.
+ *
  * @class GoogleVoice
  * @extends MastraVoice
+ *
+ * @example Standard usage with API key
+ * ```typescript
+ * const voice = new GoogleVoice({
+ *   speechModel: { apiKey: 'your-api-key' },
+ *   speaker: 'en-US-Studio-O',
+ * });
+ * ```
+ *
+ * @example Vertex AI mode (recommended for production)
+ * ```typescript
+ * const voice = new GoogleVoice({
+ *   vertexAI: true,
+ *   project: 'your-gcp-project',
+ *   location: 'us-central1',
+ *   speaker: 'en-US-Studio-O',
+ * });
+ * ```
+ *
+ * @example Vertex AI with service account
+ * ```typescript
+ * const voice = new GoogleVoice({
+ *   vertexAI: true,
+ *   project: 'your-gcp-project',
+ *   speechModel: {
+ *     keyFilename: '/path/to/service-account.json',
+ *   },
+ * });
+ * ```
  */
 export declare class GoogleVoice extends MastraVoice {
     private ttsClient;
     private speechClient;
+    private readonly vertexAI;
+    private readonly project?;
+    private readonly location;
     /**
      * Creates an instance of GoogleVoice
-     * @param {Object} config - Configuration options
+     * @param {GoogleVoiceConfig} config - Configuration options
      * @param {GoogleModelConfig} [config.speechModel] - Configuration for speech synthesis
      * @param {GoogleModelConfig} [config.listeningModel] - Configuration for speech recognition
      * @param {string} [config.speaker] - Default voice ID to use for speech synthesis
+     * @param {boolean} [config.vertexAI] - Enable Vertex AI mode
+     * @param {string} [config.project] - Google Cloud project ID (required for Vertex AI)
+     * @param {string} [config.location] - Google Cloud region (default: 'us-central1')
      */
-    constructor({ listeningModel, speechModel, speaker, }?: {
-        listeningModel?: GoogleModelConfig;
-        speechModel?: GoogleModelConfig;
-        speaker?: string;
-    });
+    constructor({ listeningModel, speechModel, speaker, vertexAI, project, location }?: GoogleVoiceConfig);
+    /**
+     * Check if Vertex AI mode is enabled
+     * @returns {boolean} True if using Vertex AI
+     */
+    isUsingVertexAI(): boolean;
+    /**
+     * Get the configured Google Cloud project ID
+     * @returns {string | undefined} The project ID or undefined if not set
+     */
+    getProject(): string | undefined;
+    /**
+     * Get the configured Google Cloud location/region
+     * @returns {string} The location (default: 'us-central1')
+     */
+    getLocation(): string;
     /**
      * Gets a list of available voices
      * @returns {Promise<Array<{voiceId: string, languageCodes: string[]}>>} List of available voices and their supported languages. Default language is en-US.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAEtF,OAAO,KAAK,EAAE,MAAM,IAAI,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACpG,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE;QACZ,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AA6CD;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,YAAY,CAAe;IAEnC;;;;;;OAMG;gBACS,EACV,cAAc,EACd,WAAW,EACX,OAAO,GACR,GAAE;QACD,cAAc,CAAC,EAAE,iBAAiB,CAAC;QACnC,WAAW,CAAC,EAAE,iBAAiB,CAAC;QAChC,OAAO,CAAC,EAAE,MAAM,CAAC;KACb;IAkCN;;;OAGG;IACG,WAAW,CAAC,EAAE,YAAsB,EAAE,GAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAO;;;;YAU9D,cAAc;IAY5B;;;;;;;;OAQG;IACG,KAAK,CACT,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,EACrC,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,iBAAiB,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,wBAAwB,CAAC,aAAa,CAAC,CAAC;KAC/F,GACA,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;IA2BjC;;;;OAIG;IACG,WAAW;;;IAIjB;;;;;;OAMG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,CAAC,cAAc,EAClC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,kBAAkB,CAAA;KAAE,GACtF,OAAO,CAAC,MAAM,CAAC;CA2CnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAEtF,OAAO,KAAK,EAAE,MAAM,IAAI,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACpG,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE;QACZ,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,iDAAiD;IACjD,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAuED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC;;;;;;;;;OASG;gBACS,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE,QAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAE,iBAAsB;IAoDjH;;;OAGG;IACH,eAAe,IAAI,OAAO;IAI1B;;;OAGG;IACH,UAAU,IAAI,MAAM,GAAG,SAAS;IAIhC;;;OAGG;IACH,WAAW,IAAI,MAAM;IAIrB;;;OAGG;IACG,WAAW,CAAC,EAAE,YAAsB,EAAE,GAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAO;;;;YAU9D,cAAc;IAY5B;;;;;;;;OAQG;IACG,KAAK,CACT,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,EACrC,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,iBAAiB,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,wBAAwB,CAAC,aAAa,CAAC,CAAC;KAC/F,GACA,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;IA2BjC;;;;OAIG;IACG,WAAW;;;IAIjB;;;;;;OAMG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,CAAC,cAAc,EAClC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,kBAAkB,CAAA;KAAE,GACtF,OAAO,CAAC,MAAM,CAAC;CA2CnB"}

package/dist/index.js

@@ -4,10 +4,16 @@ import { TextToSpeechClient } from '@google-cloud/text-to-speech';
 import { MastraVoice } from '@mastra/core/voice';
 
 // src/index.ts
-var resolveAuthConfig = (modelConfig, fallback) => {
+var resolveAuthConfig = (modelConfig, fallback, vertexConfig) => {
   const resolved = {};
+  if (vertexConfig?.vertexAI) {
+    const projectId = vertexConfig.project || process.env.GOOGLE_CLOUD_PROJECT;
+    if (projectId) {
+      resolved.projectId = projectId;
+    }
+  }
   const apiKey = modelConfig?.apiKey ?? fallback.apiKey;
-  if (apiKey) {
+  if (apiKey && !vertexConfig?.vertexAI) {
     resolved.apiKey = apiKey;
   }
   const keyFilename = modelConfig?.keyFilename ?? fallback.keyFilename;
@@ -20,44 +26,57 @@ var resolveAuthConfig = (modelConfig, fallback) => {
   }
   return resolved;
 };
-var buildAuthOptions = (config) => {
+var buildAuthOptions = (config, vertexConfig) => {
+  const options = {};
   if (config.credentials) {
-    return { credentials: config.credentials };
+    options.credentials = config.credentials;
   }
   if (config.keyFilename) {
-    return { keyFilename: config.keyFilename };
+    options.keyFilename = config.keyFilename;
   }
-  if (config.apiKey) {
-    return { apiKey: config.apiKey };
+  if (config.apiKey && !vertexConfig?.vertexAI) {
+    options.apiKey = config.apiKey;
   }
-  return {};
+  if (config.projectId) {
+    options.projectId = config.projectId;
+  }
+  return options;
 };
 var DEFAULT_VOICE = "en-US-Casual-K";
 var GoogleVoice = class extends MastraVoice {
   ttsClient;
   speechClient;
+  vertexAI;
+  project;
+  location;
   /**
    * Creates an instance of GoogleVoice
-   * @param {Object} config - Configuration options
+   * @param {GoogleVoiceConfig} config - Configuration options
    * @param {GoogleModelConfig} [config.speechModel] - Configuration for speech synthesis
    * @param {GoogleModelConfig} [config.listeningModel] - Configuration for speech recognition
    * @param {string} [config.speaker] - Default voice ID to use for speech synthesis
+   * @param {boolean} [config.vertexAI] - Enable Vertex AI mode
+   * @param {string} [config.project] - Google Cloud project ID (required for Vertex AI)
+   * @param {string} [config.location] - Google Cloud region (default: 'us-central1')
    */
-  constructor({
-    listeningModel,
-    speechModel,
-    speaker
-  } = {}) {
+  constructor({ listeningModel, speechModel, speaker, vertexAI = false, project, location } = {}) {
     const defaultApiKey = process.env.GOOGLE_API_KEY;
     const defaultKeyFilename = process.env.GOOGLE_APPLICATION_CREDENTIALS;
     const defaultSpeaker = DEFAULT_VOICE;
+    const resolvedProject = project || process.env.GOOGLE_CLOUD_PROJECT;
+    const resolvedLocation = location || process.env.GOOGLE_CLOUD_LOCATION || "us-central1";
+    if (vertexAI && !resolvedProject) {
+      throw new Error(
+        "Google Cloud project ID is required when using Vertex AI. Set GOOGLE_CLOUD_PROJECT environment variable or pass project to constructor."
+      );
+    }
+    const vertexConfig = { vertexAI, project: resolvedProject };
     const sharedFallback = {
       apiKey: defaultApiKey ?? speechModel?.apiKey ?? listeningModel?.apiKey,
       keyFilename: defaultKeyFilename ?? speechModel?.keyFilename ?? listeningModel?.keyFilename,
-      credentials: speechModel?.credentials ?? listeningModel?.credentials
-    };
-    const speechAuthConfig = resolveAuthConfig(speechModel, sharedFallback);
-    const listeningAuthConfig = resolveAuthConfig(listeningModel, sharedFallback);
+      credentials: speechModel?.credentials ?? listeningModel?.credentials};
+    const speechAuthConfig = resolveAuthConfig(speechModel, sharedFallback, vertexConfig);
+    const listeningAuthConfig = resolveAuthConfig(listeningModel, sharedFallback, vertexConfig);
     super({
       speechModel: {
         name: "",
@@ -69,11 +88,35 @@ var GoogleVoice = class extends MastraVoice {
       },
       speaker: speaker ?? defaultSpeaker
     });
-    const ttsOptions = buildAuthOptions(speechAuthConfig);
-    const speechOptions = buildAuthOptions(listeningAuthConfig);
+    this.vertexAI = vertexAI;
+    this.project = resolvedProject;
+    this.location = resolvedLocation;
+    const ttsOptions = buildAuthOptions(speechAuthConfig, { vertexAI});
+    const speechOptions = buildAuthOptions(listeningAuthConfig, { vertexAI});
     this.ttsClient = new TextToSpeechClient(ttsOptions);
     this.speechClient = new SpeechClient(speechOptions);
   }
+  /**
+   * Check if Vertex AI mode is enabled
+   * @returns {boolean} True if using Vertex AI
+   */
+  isUsingVertexAI() {
+    return this.vertexAI;
+  }
+  /**
+   * Get the configured Google Cloud project ID
+   * @returns {string | undefined} The project ID or undefined if not set
+   */
+  getProject() {
+    return this.project;
+  }
+  /**
+   * Get the configured Google Cloud location/region
+   * @returns {string} The location (default: 'us-central1')
+   */
+  getLocation() {
+    return this.location;
+  }
   /**
    * Gets a list of available voices
    * @returns {Promise<Array<{voiceId: string, languageCodes: string[]}>>} List of available voices and their supported languages. Default language is en-US.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AA6BA,IAAM,iBAAA,GAAoB,CAAC,WAAA,EAA4C,QAAA,KAAqC;AAC1G,EAAA,MAAM,WAAuB,EAAC;AAE9B,EAAA,MAAM,MAAA,GAAS,WAAA,EAAa,MAAA,IAAU,QAAA,CAAS,MAAA;AAC/C,EAAA,IAAI,MAAA,EAAQ;AACV,IAAA,QAAA,CAAS,MAAA,GAAS,MAAA;AAAA,EACpB;AAEA,EAAA,MAAM,WAAA,GAAc,WAAA,EAAa,WAAA,IAAe,QAAA,CAAS,WAAA;AACzD,EAAA,IAAI,WAAA,EAAa;AACf,IAAA,QAAA,CAAS,WAAA,GAAc,WAAA;AAAA,EACzB;AAEA,EAAA,MAAM,WAAA,GAAc,WAAA,EAAa,WAAA,IAAe,QAAA,CAAS,WAAA;AACzD,EAAA,IAAI,WAAA,EAAa;AACf,IAAA,QAAA,CAAS,WAAA,GAAc,WAAA;AAAA,EACzB;AAEA,EAAA,OAAO,QAAA;AACT,CAAA;AAEA,IAAM,gBAAA,GAAmB,CAAC,MAAA,KAA4C;AACpE,EAAA,IAAI,OAAO,WAAA,EAAa;AACtB,IAAA,OAAO,EAAE,WAAA,EAAa,MAAA,CAAO,WAAA,EAAY;AAAA,EAC3C;AAEA,EAAA,IAAI,OAAO,WAAA,EAAa;AACtB,IAAA,OAAO,EAAE,WAAA,EAAa,MAAA,CAAO,WAAA,EAAY;AAAA,EAC3C;AAEA,EAAA,IAAI,OAAO,MAAA,EAAQ;AACjB,IAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,CAAO,MAAA,EAAO;AAAA,EACjC;AAEA,EAAA,OAAO,EAAC;AACV,CAAA;AAEA,IAAM,aAAA,GAAgB,gBAAA;AAOf,IAAM,WAAA,GAAN,cAA0B,WAAA,CAAY;AAAA,EACnC,SAAA;AAAA,EACA,YAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASR,WAAA,CAAY;AAAA,IACV,cAAA;AAAA,IACA,WAAA;AAAA,IACA;AAAA,GACF,GAII,EAAC,EAAG;AACN,IAAA,MAAM,aAAA,GAAgB,QAAQ,GAAA,CAAI,cAAA;AAClC,IAAA,MAAM,kBAAA,GAAqB,QAAQ,GAAA,CAAI,8BAAA;AACvC,IAAA,MAAM,cAAA,GAAiB,aAAA;AAEvB,IAAA,MAAM,cAAA,GAA6B;AAAA,MACjC,MAAA,EAAQ,aAAA,IAAiB,WAAA,EAAa,MAAA,IAAU,cAAA,EAAgB,MAAA;AAAA,MAChE,WAAA,EAAa,kBAAA,IAAsB,WAAA,EAAa,WAAA,IAAe,cAAA,EAAgB,WAAA;AAAA,MAC/E,WAAA,EAAa,WAAA,EAAa,WAAA,IAAe,cAAA,EAAgB;AAAA,KAC3D;AAEA,IAAA,MAAM,gBAAA,GAAmB,iBAAA,CAAkB,WAAA,EAAa,cAAc,CAAA;AACtE,IAAA,MAAM,mBAAA,GAAsB,iBAAA,CAAkB,cAAA,EAAgB,cAAc,CAAA;AAE5E,IAAA,KAAA,CAAM;AAAA,MACJ,WAAA,EAAa;AAAA,QACX,IAAA,EAAM,EAAA;AAAA,QACN,MAAA,EAAQ,iBAAiB,MAAA,IAAU;AAAA,OACrC;AAAA,MACA,cAAA,EAAgB;AAAA,QACd,IAAA,EAAM,EAAA;AAAA,QACN,MAAA,EAAQ,oBAAoB,MAAA,IAAU;AAAA,OACxC;AAAA,MACA,SAAS,OAAA,IAAW;AAAA,KACrB,CAAA;AAED,IAAA,MAAM,UAAA,GAAa,iBAAiB,gBAAgB,CAAA;AACpD,IAAA,MAAM,aAAA,GAAgB,iBAAiB,mBAAmB,CAAA;AAE1D,IAAA,IAAA,CAAK,SAAA,GAAY,IAAI,kBAAA,CAAmB,UAAU,CAAA;AAElD,IAAA,IAAA,CAAK,YAAA,GAAe,IAAI,YAAA,CAAa,aAAa,CAAA;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,WAAA,CAAY,EAAE,eAAe,OAAA,EAAQ,GAA+B,EAAC,EAAG;AAC5E,IAAA,MAAM,CAAC,QAAQ,CAAA,GAAI,MAAM,KAAK,SAAA,CAAU,UAAA,CAAW,EAAE,YAAA,EAA4B,CAAA;AACjF,IAAA,OAAA,CAAQ,QAAA,EAAU,MAAA,IAAU,EAAC,EAC1B,MAAA,CAAO,CAAA,KAAA,KAAS,KAAA,CAAM,IAAA,IAAQ,KAAA,CAAM,aAAa,CAAA,CACjD,GAAA,CAAI,CAAA,KAAA,MAAU;AAAA,MACb,SAAS,KAAA,CAAM,IAAA;AAAA,MACf,eAAe,KAAA,CAAM;AAAA,KACvB,CAAE,CAAA;AAAA,EACN;AAAA,EAEA,MAAc,eAAe,MAAA,EAAgD;AAC3E,IAAA,MAAM,SAAmB,EAAC;AAC1B,IAAA,WAAA,MAAiB,SAAS,MAAA,EAAQ;AAChC,MAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,QAAA,MAAA,CAAO,IAAA,CAAK,MAAA,CAAO,IAAA,CAAK,KAAK,CAAC,CAAA;AAAA,MAChC,CAAA,MAAO;AACL,QAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AAAA,MACnB;AAAA,IACF;AACA,IAAA,OAAO,MAAA,CAAO,MAAA,CAAO,MAAM,CAAA,CAAE,SAAS,OAAO,CAAA;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,KAAA,CACJ,KAAA,EACA,OAAA,EAKgC;AAChC,IAAA,MAAM,IAAA,GAAO,OAAO,KAAA,KAAU,QAAA,GAAW,QAAQ,MAAM,IAAA,CAAK,eAAe,KAAK,CAAA;AAEhF,IAAA,MAAM,OAAA,GAA4E;AAAA,MAChF,KAAA,EAAO,EAAE,IAAA,EAAK;AAAA,MACd,KAAA,EAAO;AAAA,QACL,IAAA,EAAM,OAAA,EAAS,OAAA,IAAW,IAAA,CAAK,OAAA;AAAA,QAC/B,YAAA,EAAc,OAAA,EAAS,YAAA,IAAgB,OAAA,EAAS,SAAS,KAAA,CAAM,GAAG,CAAA,CAAE,KAAA,CAAM,CAAA,EAAG,CAAC,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA,IAAK;AAAA,OAC/F;AAAA,MACA,WAAA,EAAa,OAAA,EAAS,WAAA,IAAe,EAAE,eAAe,UAAA;AAAW,KACnE;AAEA,IAAA,MAAM,CAAC,QAAQ,CAAA,GAAI,MAAM,IAAA,CAAK,SAAA,CAAU,iBAAiB,OAAO,CAAA;AAEhE,IAAA,IAAI,CAAC,SAAS,YAAA,EAAc;AAC1B,MAAA,MAAM,IAAI,MAAM,4BAA4B,CAAA;AAAA,IAC9C;AAEA,IAAA,IAAI,OAAO,QAAA,CAAS,YAAA,KAAiB,QAAA,EAAU;AAC7C,MAAA,MAAM,IAAI,MAAM,4BAA4B,CAAA;AAAA,IAC9C;AAEA,IAAA,MAAM,MAAA,GAAS,IAAI,WAAA,EAAY;AAC/B,IAAA,MAAA,CAAO,GAAA,CAAI,MAAA,CAAO,IAAA,CAAK,QAAA,CAAS,YAAY,CAAC,CAAA;AAC7C,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,WAAA,GAAc;AAClB,IAAA,OAAO,EAAE,SAAS,IAAA,EAAK;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,MAAA,CACJ,WAAA,EACA,OAAA,EACiB;AACjB,IAAA,MAAM,SAAmB,EAAC;AAC1B,IAAA,WAAA,MAAiB,SAAS,WAAA,EAAa;AACrC,MAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,QAAA,MAAA,CAAO,IAAA,CAAK,MAAA,CAAO,IAAA,CAAK,KAAK,CAAC,CAAA;AAAA,MAChC,CAAA,MAAO;AACL,QAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AAAA,MACnB;AAAA,IACF;AACA,IAAA,MAAM,MAAA,GAAS,MAAA,CAAO,MAAA,CAAO,MAAM,CAAA;AAEnC,IAAA,IAAI,OAAA,GAAU;AAAA,MACZ,MAAA,EAAQ;AAAA,QACN,QAAA,EAAU,UAAA;AAAA,QACV,YAAA,EAAc,OAAA;AAAA,QACd,GAAG,OAAA,EAAS;AAAA,OACd;AAAA,MACA,KAAA,EAAO;AAAA,QACL,OAAA,EAAS,MAAA,CAAO,QAAA,CAAS,QAAQ;AAAA;AACnC,KACF;AACA,IAAA,MAAM,CAAC,QAAQ,CAAA,GAAI,MAAM,IAAA,CAAK,YAAA,CAAa,UAAU,OAAwD,CAAA;AAE7G,IAAA,IAAI,CAAC,QAAA,CAAS,OAAA,IAAW,QAAA,CAAS,OAAA,CAAQ,WAAW,CAAA,EAAG;AACtD,MAAA,MAAM,IAAI,MAAM,mCAAmC,CAAA;AAAA,IACrD;AAEA,IAAA,MAAM,aAAA,GAAgB,QAAA,CAAS,OAAA,CAC5B,GAAA,CAAI,CAAC,MAAA,KAAgB;AACpB,MAAA,IAAI,CAAC,MAAA,CAAO,YAAA,IAAgB,MAAA,CAAO,YAAA,CAAa,WAAW,CAAA,EAAG;AAC5D,QAAA,OAAO,EAAA;AAAA,MACT;AACA,MAAA,OAAO,MAAA,CAAO,YAAA,CAAa,CAAC,CAAA,CAAE,UAAA,IAAc,EAAA;AAAA,IAC9C,CAAC,CAAA,CACA,MAAA,CAAO,CAAC,IAAA,KAAiB,KAAK,MAAA,GAAS,CAAC,CAAA,CACxC,IAAA,CAAK,GAAG,CAAA;AAEX,IAAA,IAAI,CAAC,aAAA,EAAe;AAClB,MAAA,MAAM,IAAI,MAAM,yCAAyC,CAAA;AAAA,IAC3D;AAEA,IAAA,OAAO,aAAA;AAAA,EACT;AACF","file":"index.js","sourcesContent":["import { PassThrough } from 'stream';\n\nimport { SpeechClient } from '@google-cloud/speech';\nimport type { google as SpeechTypes } from '@google-cloud/speech/build/protos/protos';\nimport { TextToSpeechClient } from '@google-cloud/text-to-speech';\nimport type { google as TextToSpeechTypes } from '@google-cloud/text-to-speech/build/protos/protos';\nimport { MastraVoice } from '@mastra/core/voice';\n\n/**\n * Configuration for Google Cloud Voice models\n * @interface GoogleModelConfig\n * @property {string} [apiKey] - Optional Google Cloud API key. If not provided, will use GOOGLE_API_KEY environment variable\n * @property {string} [keyFilename] - Optional path to a service account key file. If not provided, will use GOOGLE_APPLICATION_CREDENTIALS environment variable\n * @property {{ client_email?: string; private_key?: string }} [credentials] - Optional in-memory service account credentials\n */\nexport interface GoogleModelConfig {\n  apiKey?: string;\n  keyFilename?: string;\n  credentials?: {\n    client_email?: string;\n    private_key?: string;\n    [key: string]: unknown;\n  };\n}\n\ntype AuthConfig = Pick<GoogleModelConfig, 'apiKey' | 'keyFilename' | 'credentials'>;\n\ntype GoogleClientOptions = AuthConfig;\n\nconst resolveAuthConfig = (modelConfig: GoogleModelConfig | undefined, fallback: AuthConfig): AuthConfig => {\n  const resolved: AuthConfig = {};\n\n  const apiKey = modelConfig?.apiKey ?? fallback.apiKey;\n  if (apiKey) {\n    resolved.apiKey = apiKey;\n  }\n\n  const keyFilename = modelConfig?.keyFilename ?? fallback.keyFilename;\n  if (keyFilename) {\n    resolved.keyFilename = keyFilename;\n  }\n\n  const credentials = modelConfig?.credentials ?? fallback.credentials;\n  if (credentials) {\n    resolved.credentials = credentials;\n  }\n\n  return resolved;\n};\n\nconst buildAuthOptions = (config: AuthConfig): GoogleClientOptions => {\n  if (config.credentials) {\n    return { credentials: config.credentials };\n  }\n\n  if (config.keyFilename) {\n    return { keyFilename: config.keyFilename };\n  }\n\n  if (config.apiKey) {\n    return { apiKey: config.apiKey };\n  }\n\n  return {};\n};\n\nconst DEFAULT_VOICE = 'en-US-Casual-K';\n\n/**\n * GoogleVoice class provides Text-to-Speech and Speech-to-Text capabilities using Google Cloud services\n * @class GoogleVoice\n * @extends MastraVoice\n */\nexport class GoogleVoice extends MastraVoice {\n  private ttsClient: TextToSpeechClient;\n  private speechClient: SpeechClient;\n\n  /**\n   * Creates an instance of GoogleVoice\n   * @param {Object} config - Configuration options\n   * @param {GoogleModelConfig} [config.speechModel] - Configuration for speech synthesis\n   * @param {GoogleModelConfig} [config.listeningModel] - Configuration for speech recognition\n   * @param {string} [config.speaker] - Default voice ID to use for speech synthesis\n   */\n  constructor({\n    listeningModel,\n    speechModel,\n    speaker,\n  }: {\n    listeningModel?: GoogleModelConfig;\n    speechModel?: GoogleModelConfig;\n    speaker?: string;\n  } = {}) {\n    const defaultApiKey = process.env.GOOGLE_API_KEY;\n    const defaultKeyFilename = process.env.GOOGLE_APPLICATION_CREDENTIALS;\n    const defaultSpeaker = DEFAULT_VOICE;\n\n    const sharedFallback: AuthConfig = {\n      apiKey: defaultApiKey ?? speechModel?.apiKey ?? listeningModel?.apiKey,\n      keyFilename: defaultKeyFilename ?? speechModel?.keyFilename ?? listeningModel?.keyFilename,\n      credentials: speechModel?.credentials ?? listeningModel?.credentials,\n    };\n\n    const speechAuthConfig = resolveAuthConfig(speechModel, sharedFallback);\n    const listeningAuthConfig = resolveAuthConfig(listeningModel, sharedFallback);\n\n    super({\n      speechModel: {\n        name: '',\n        apiKey: speechAuthConfig.apiKey ?? defaultApiKey,\n      },\n      listeningModel: {\n        name: '',\n        apiKey: listeningAuthConfig.apiKey ?? defaultApiKey,\n      },\n      speaker: speaker ?? defaultSpeaker,\n    });\n\n    const ttsOptions = buildAuthOptions(speechAuthConfig);\n    const speechOptions = buildAuthOptions(listeningAuthConfig);\n\n    this.ttsClient = new TextToSpeechClient(ttsOptions);\n\n    this.speechClient = new SpeechClient(speechOptions);\n  }\n\n  /**\n   * Gets a list of available voices\n   * @returns {Promise<Array<{voiceId: string, languageCodes: string[]}>>} List of available voices and their supported languages. Default language is en-US.\n   */\n  async getSpeakers({ languageCode = 'en-US' }: { languageCode?: string } = {}) {\n    const [response] = await this.ttsClient.listVoices({ languageCode: languageCode });\n    return (response?.voices || [])\n      .filter(voice => voice.name && voice.languageCodes)\n      .map(voice => ({\n        voiceId: voice.name!,\n        languageCodes: voice.languageCodes!,\n      }));\n  }\n\n  private async streamToString(stream: NodeJS.ReadableStream): Promise<string> {\n    const chunks: Buffer[] = [];\n    for await (const chunk of stream) {\n      if (typeof chunk === 'string') {\n        chunks.push(Buffer.from(chunk));\n      } else {\n        chunks.push(chunk);\n      }\n    }\n    return Buffer.concat(chunks).toString('utf-8');\n  }\n\n  /**\n   * Converts text to speech\n   * @param {string | NodeJS.ReadableStream} input - Text or stream to convert to speech\n   * @param {Object} [options] - Speech synthesis options\n   * @param {string} [options.speaker] - Voice ID to use\n   * @param {string} [options.languageCode] - Language code for the voice\n   * @param {TextToSpeechTypes.cloud.texttospeech.v1.ISynthesizeSpeechRequest['audioConfig']} [options.audioConfig] - Audio configuration options\n   * @returns {Promise<NodeJS.ReadableStream>} Stream of synthesized audio. Default encoding is LINEAR16.\n   */\n  async speak(\n    input: string | NodeJS.ReadableStream,\n    options?: {\n      speaker?: string;\n      languageCode?: string;\n      audioConfig?: TextToSpeechTypes.cloud.texttospeech.v1.ISynthesizeSpeechRequest['audioConfig'];\n    },\n  ): Promise<NodeJS.ReadableStream> {\n    const text = typeof input === 'string' ? input : await this.streamToString(input);\n\n    const request: TextToSpeechTypes.cloud.texttospeech.v1.ISynthesizeSpeechRequest = {\n      input: { text },\n      voice: {\n        name: options?.speaker || this.speaker,\n        languageCode: options?.languageCode || options?.speaker?.split('-').slice(0, 2).join('-') || 'en-US',\n      },\n      audioConfig: options?.audioConfig || { audioEncoding: 'LINEAR16' },\n    };\n\n    const [response] = await this.ttsClient.synthesizeSpeech(request);\n\n    if (!response.audioContent) {\n      throw new Error('No audio content returned.');\n    }\n\n    if (typeof response.audioContent === 'string') {\n      throw new Error('Audio content is a string.');\n    }\n\n    const stream = new PassThrough();\n    stream.end(Buffer.from(response.audioContent));\n    return stream;\n  }\n\n  /**\n   * Checks if listening capabilities are enabled.\n   *\n   * @returns {Promise<{ enabled: boolean }>}\n   */\n  async getListener() {\n    return { enabled: true };\n  }\n\n  /**\n   * Converts speech to text\n   * @param {NodeJS.ReadableStream} audioStream - Audio stream to transcribe. Default encoding is LINEAR16.\n   * @param {Object} [options] - Recognition options\n   * @param {SpeechTypes.cloud.speech.v1.IRecognitionConfig} [options.config] - Recognition configuration\n   * @returns {Promise<string>} Transcribed text\n   */\n  async listen(\n    audioStream: NodeJS.ReadableStream,\n    options?: { stream?: boolean; config?: SpeechTypes.cloud.speech.v1.IRecognitionConfig },\n  ): Promise<string> {\n    const chunks: Buffer[] = [];\n    for await (const chunk of audioStream) {\n      if (typeof chunk === 'string') {\n        chunks.push(Buffer.from(chunk));\n      } else {\n        chunks.push(chunk);\n      }\n    }\n    const buffer = Buffer.concat(chunks);\n\n    let request = {\n      config: {\n        encoding: 'LINEAR16',\n        languageCode: 'en-US',\n        ...options?.config,\n      },\n      audio: {\n        content: buffer.toString('base64'),\n      },\n    };\n    const [response] = await this.speechClient.recognize(request as SpeechTypes.cloud.speech.v1.IRecognizeRequest);\n\n    if (!response.results || response.results.length === 0) {\n      throw new Error('No transcription results returned');\n    }\n\n    const transcription = response.results\n      .map((result: any) => {\n        if (!result.alternatives || result.alternatives.length === 0) {\n          return '';\n        }\n        return result.alternatives[0].transcript || '';\n      })\n      .filter((text: string) => text.length > 0)\n      .join(' ');\n\n    if (!transcription) {\n      throw new Error('No valid transcription found in results');\n    }\n\n    return transcription;\n  }\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { PassThrough } from 'node:stream';\n\nimport { SpeechClient } from '@google-cloud/speech';\nimport type { google as SpeechTypes } from '@google-cloud/speech/build/protos/protos';\nimport { TextToSpeechClient } from '@google-cloud/text-to-speech';\nimport type { google as TextToSpeechTypes } from '@google-cloud/text-to-speech/build/protos/protos';\nimport { MastraVoice } from '@mastra/core/voice';\n\n/**\n * Configuration for Google Cloud Voice models\n * @interface GoogleModelConfig\n * @property {string} [apiKey] - Optional Google Cloud API key. If not provided, will use GOOGLE_API_KEY environment variable\n * @property {string} [keyFilename] - Optional path to a service account key file. If not provided, will use GOOGLE_APPLICATION_CREDENTIALS environment variable\n * @property {{ client_email?: string; private_key?: string }} [credentials] - Optional in-memory service account credentials\n */\nexport interface GoogleModelConfig {\n  apiKey?: string;\n  keyFilename?: string;\n  credentials?: {\n    client_email?: string;\n    private_key?: string;\n    [key: string]: unknown;\n  };\n}\n\n/**\n * Configuration options for GoogleVoice\n * @interface GoogleVoiceConfig\n */\nexport interface GoogleVoiceConfig {\n  /** Configuration for speech synthesis (TTS) */\n  speechModel?: GoogleModelConfig;\n  /** Configuration for speech recognition (STT) */\n  listeningModel?: GoogleModelConfig;\n  /** Default voice ID to use for speech synthesis */\n  speaker?: string;\n  /**\n   * Enable Vertex AI mode for enterprise deployments.\n   * When true, uses Google Cloud project-based authentication instead of API keys.\n   * Requires `project` to be set or GOOGLE_CLOUD_PROJECT environment variable.\n   */\n  vertexAI?: boolean;\n  /**\n   * Google Cloud project ID (required when vertexAI is true).\n   * Falls back to GOOGLE_CLOUD_PROJECT environment variable.\n   */\n  project?: string;\n  /**\n   * Google Cloud region for Vertex AI endpoints.\n   * Falls back to GOOGLE_CLOUD_LOCATION environment variable.\n   * @default 'us-central1'\n   */\n  location?: string;\n}\n\ntype AuthConfig = Pick<GoogleModelConfig, 'apiKey' | 'keyFilename' | 'credentials'> & {\n  projectId?: string;\n};\n\ntype GoogleClientOptions = AuthConfig;\n\nconst resolveAuthConfig = (\n  modelConfig: GoogleModelConfig | undefined,\n  fallback: AuthConfig,\n  vertexConfig?: { vertexAI?: boolean; project?: string },\n): AuthConfig => {\n  const resolved: AuthConfig = {};\n\n  // For Vertex AI, prioritize project-based auth over API keys\n  if (vertexConfig?.vertexAI) {\n    const projectId = vertexConfig.project || process.env.GOOGLE_CLOUD_PROJECT;\n    if (projectId) {\n      resolved.projectId = projectId;\n    }\n  }\n\n  const apiKey = modelConfig?.apiKey ?? fallback.apiKey;\n  // Only use API key if not in Vertex AI mode\n  if (apiKey && !vertexConfig?.vertexAI) {\n    resolved.apiKey = apiKey;\n  }\n\n  const keyFilename = modelConfig?.keyFilename ?? fallback.keyFilename;\n  if (keyFilename) {\n    resolved.keyFilename = keyFilename;\n  }\n\n  const credentials = modelConfig?.credentials ?? fallback.credentials;\n  if (credentials) {\n    resolved.credentials = credentials;\n  }\n\n  return resolved;\n};\n\nconst buildAuthOptions = (\n  config: AuthConfig,\n  vertexConfig?: { vertexAI?: boolean; location?: string },\n): GoogleClientOptions => {\n  const options: GoogleClientOptions = {};\n\n  if (config.credentials) {\n    options.credentials = config.credentials;\n  }\n\n  if (config.keyFilename) {\n    options.keyFilename = config.keyFilename;\n  }\n\n  // Only use API key if not using Vertex AI\n  if (config.apiKey && !vertexConfig?.vertexAI) {\n    options.apiKey = config.apiKey;\n  }\n\n  // For Vertex AI, set the project ID\n  if (config.projectId) {\n    options.projectId = config.projectId;\n  }\n\n  return options;\n};\n\nconst DEFAULT_VOICE = 'en-US-Casual-K';\n\n/**\n * GoogleVoice class provides Text-to-Speech and Speech-to-Text capabilities using Google Cloud services.\n * Supports both standard Google Cloud API authentication and Vertex AI mode for enterprise deployments.\n *\n * @class GoogleVoice\n * @extends MastraVoice\n *\n * @example Standard usage with API key\n * ```typescript\n * const voice = new GoogleVoice({\n *   speechModel: { apiKey: 'your-api-key' },\n *   speaker: 'en-US-Studio-O',\n * });\n * ```\n *\n * @example Vertex AI mode (recommended for production)\n * ```typescript\n * const voice = new GoogleVoice({\n *   vertexAI: true,\n *   project: 'your-gcp-project',\n *   location: 'us-central1',\n *   speaker: 'en-US-Studio-O',\n * });\n * ```\n *\n * @example Vertex AI with service account\n * ```typescript\n * const voice = new GoogleVoice({\n *   vertexAI: true,\n *   project: 'your-gcp-project',\n *   speechModel: {\n *     keyFilename: '/path/to/service-account.json',\n *   },\n * });\n * ```\n */\nexport class GoogleVoice extends MastraVoice {\n  private ttsClient: TextToSpeechClient;\n  private speechClient: SpeechClient;\n  private readonly vertexAI: boolean;\n  private readonly project?: string;\n  private readonly location: string;\n\n  /**\n   * Creates an instance of GoogleVoice\n   * @param {GoogleVoiceConfig} config - Configuration options\n   * @param {GoogleModelConfig} [config.speechModel] - Configuration for speech synthesis\n   * @param {GoogleModelConfig} [config.listeningModel] - Configuration for speech recognition\n   * @param {string} [config.speaker] - Default voice ID to use for speech synthesis\n   * @param {boolean} [config.vertexAI] - Enable Vertex AI mode\n   * @param {string} [config.project] - Google Cloud project ID (required for Vertex AI)\n   * @param {string} [config.location] - Google Cloud region (default: 'us-central1')\n   */\n  constructor({ listeningModel, speechModel, speaker, vertexAI = false, project, location }: GoogleVoiceConfig = {}) {\n    const defaultApiKey = process.env.GOOGLE_API_KEY;\n    const defaultKeyFilename = process.env.GOOGLE_APPLICATION_CREDENTIALS;\n    const defaultSpeaker = DEFAULT_VOICE;\n\n    // Resolve Vertex AI configuration\n    const resolvedProject = project || process.env.GOOGLE_CLOUD_PROJECT;\n    const resolvedLocation = location || process.env.GOOGLE_CLOUD_LOCATION || 'us-central1';\n\n    // Validate Vertex AI configuration\n    if (vertexAI && !resolvedProject) {\n      throw new Error(\n        'Google Cloud project ID is required when using Vertex AI. ' +\n          'Set GOOGLE_CLOUD_PROJECT environment variable or pass project to constructor.',\n      );\n    }\n\n    const vertexConfig = { vertexAI, project: resolvedProject };\n\n    const sharedFallback: AuthConfig = {\n      apiKey: defaultApiKey ?? speechModel?.apiKey ?? listeningModel?.apiKey,\n      keyFilename: defaultKeyFilename ?? speechModel?.keyFilename ?? listeningModel?.keyFilename,\n      credentials: speechModel?.credentials ?? listeningModel?.credentials,\n      projectId: resolvedProject,\n    };\n\n    const speechAuthConfig = resolveAuthConfig(speechModel, sharedFallback, vertexConfig);\n    const listeningAuthConfig = resolveAuthConfig(listeningModel, sharedFallback, vertexConfig);\n\n    super({\n      speechModel: {\n        name: '',\n        apiKey: speechAuthConfig.apiKey ?? defaultApiKey,\n      },\n      listeningModel: {\n        name: '',\n        apiKey: listeningAuthConfig.apiKey ?? defaultApiKey,\n      },\n      speaker: speaker ?? defaultSpeaker,\n    });\n\n    this.vertexAI = vertexAI;\n    this.project = resolvedProject;\n    this.location = resolvedLocation;\n\n    const ttsOptions = buildAuthOptions(speechAuthConfig, { vertexAI, location: resolvedLocation });\n    const speechOptions = buildAuthOptions(listeningAuthConfig, { vertexAI, location: resolvedLocation });\n\n    this.ttsClient = new TextToSpeechClient(ttsOptions);\n    this.speechClient = new SpeechClient(speechOptions);\n  }\n\n  /**\n   * Check if Vertex AI mode is enabled\n   * @returns {boolean} True if using Vertex AI\n   */\n  isUsingVertexAI(): boolean {\n    return this.vertexAI;\n  }\n\n  /**\n   * Get the configured Google Cloud project ID\n   * @returns {string | undefined} The project ID or undefined if not set\n   */\n  getProject(): string | undefined {\n    return this.project;\n  }\n\n  /**\n   * Get the configured Google Cloud location/region\n   * @returns {string} The location (default: 'us-central1')\n   */\n  getLocation(): string {\n    return this.location;\n  }\n\n  /**\n   * Gets a list of available voices\n   * @returns {Promise<Array<{voiceId: string, languageCodes: string[]}>>} List of available voices and their supported languages. Default language is en-US.\n   */\n  async getSpeakers({ languageCode = 'en-US' }: { languageCode?: string } = {}) {\n    const [response] = await this.ttsClient.listVoices({ languageCode: languageCode });\n    return (response?.voices || [])\n      .filter(voice => voice.name && voice.languageCodes)\n      .map(voice => ({\n        voiceId: voice.name!,\n        languageCodes: voice.languageCodes!,\n      }));\n  }\n\n  private async streamToString(stream: NodeJS.ReadableStream): Promise<string> {\n    const chunks: Buffer[] = [];\n    for await (const chunk of stream) {\n      if (typeof chunk === 'string') {\n        chunks.push(Buffer.from(chunk));\n      } else {\n        chunks.push(chunk);\n      }\n    }\n    return Buffer.concat(chunks).toString('utf-8');\n  }\n\n  /**\n   * Converts text to speech\n   * @param {string | NodeJS.ReadableStream} input - Text or stream to convert to speech\n   * @param {Object} [options] - Speech synthesis options\n   * @param {string} [options.speaker] - Voice ID to use\n   * @param {string} [options.languageCode] - Language code for the voice\n   * @param {TextToSpeechTypes.cloud.texttospeech.v1.ISynthesizeSpeechRequest['audioConfig']} [options.audioConfig] - Audio configuration options\n   * @returns {Promise<NodeJS.ReadableStream>} Stream of synthesized audio. Default encoding is LINEAR16.\n   */\n  async speak(\n    input: string | NodeJS.ReadableStream,\n    options?: {\n      speaker?: string;\n      languageCode?: string;\n      audioConfig?: TextToSpeechTypes.cloud.texttospeech.v1.ISynthesizeSpeechRequest['audioConfig'];\n    },\n  ): Promise<NodeJS.ReadableStream> {\n    const text = typeof input === 'string' ? input : await this.streamToString(input);\n\n    const request: TextToSpeechTypes.cloud.texttospeech.v1.ISynthesizeSpeechRequest = {\n      input: { text },\n      voice: {\n        name: options?.speaker || this.speaker,\n        languageCode: options?.languageCode || options?.speaker?.split('-').slice(0, 2).join('-') || 'en-US',\n      },\n      audioConfig: options?.audioConfig || { audioEncoding: 'LINEAR16' },\n    };\n\n    const [response] = await this.ttsClient.synthesizeSpeech(request);\n\n    if (!response.audioContent) {\n      throw new Error('No audio content returned.');\n    }\n\n    if (typeof response.audioContent === 'string') {\n      throw new Error('Audio content is a string.');\n    }\n\n    const stream = new PassThrough();\n    stream.end(Buffer.from(response.audioContent));\n    return stream;\n  }\n\n  /**\n   * Checks if listening capabilities are enabled.\n   *\n   * @returns {Promise<{ enabled: boolean }>}\n   */\n  async getListener() {\n    return { enabled: true };\n  }\n\n  /**\n   * Converts speech to text\n   * @param {NodeJS.ReadableStream} audioStream - Audio stream to transcribe. Default encoding is LINEAR16.\n   * @param {Object} [options] - Recognition options\n   * @param {SpeechTypes.cloud.speech.v1.IRecognitionConfig} [options.config] - Recognition configuration\n   * @returns {Promise<string>} Transcribed text\n   */\n  async listen(\n    audioStream: NodeJS.ReadableStream,\n    options?: { stream?: boolean; config?: SpeechTypes.cloud.speech.v1.IRecognitionConfig },\n  ): Promise<string> {\n    const chunks: Buffer[] = [];\n    for await (const chunk of audioStream) {\n      if (typeof chunk === 'string') {\n        chunks.push(Buffer.from(chunk));\n      } else {\n        chunks.push(chunk);\n      }\n    }\n    const buffer = Buffer.concat(chunks);\n\n    let request = {\n      config: {\n        encoding: 'LINEAR16',\n        languageCode: 'en-US',\n        ...options?.config,\n      },\n      audio: {\n        content: buffer.toString('base64'),\n      },\n    };\n    const [response] = await this.speechClient.recognize(request as SpeechTypes.cloud.speech.v1.IRecognizeRequest);\n\n    if (!response.results || response.results.length === 0) {\n      throw new Error('No transcription results returned');\n    }\n\n    const transcription = response.results\n      .map((result: any) => {\n        if (!result.alternatives || result.alternatives.length === 0) {\n          return '';\n        }\n        return result.alternatives[0].transcript || '';\n      })\n      .filter((text: string) => text.length > 0)\n      .join(' ');\n\n    if (!transcription) {\n      throw new Error('No valid transcription found in results');\n    }\n\n    return transcription;\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/voice-google",
-  "version": "0.12.0-beta.0",
+  "version": "0.12.0-beta.1",
   "description": "Mastra Google voice integration",
   "type": "module",
   "files": [
@@ -28,14 +28,16 @@
     "@google-cloud/text-to-speech": "^6.3.1"
   },
   "devDependencies": {
-    "@types/node": "^20.19.0",
+    "@types/node": "22.13.17",
+    "@vitest/coverage-v8": "4.0.12",
+    "@vitest/ui": "4.0.12",
     "eslint": "^9.37.0",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.4",
+    "vitest": "4.0.12",
     "@internal/lint": "0.0.53",
-    "@mastra/core": "1.0.0-beta.0",
-    "@internal/types-builder": "0.0.28"
+    "@internal/types-builder": "0.0.28",
+    "@mastra/core": "1.0.0-beta.6"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.0.0-0 <2.0.0-0",