@mastra/voice-google 0.14.2-alpha.0 → 0.14.2-alpha.1

package/README.md

@@ -1,8 +1,6 @@
 # @mastra/voice-google
 
-Google Cloud Voice integration for Mastra, providing both Text-to-Speech (TTS) and Speech-to-Text capabilities.
-
-> Note: This package replaces the deprecated @mastra/speech-google package, combining both speech synthesis and recognition capabilities.
+Add Google Cloud text-to-speech and speech-to-text to Mastra with configurable voices, languages, audio encoding, streaming, and authentication.
 
 ## Installation
 
@@ -10,48 +8,6 @@ Google Cloud Voice integration for Mastra, providing both Text-to-Speech (TTS) a
 npm install @mastra/voice-google
 ```
 
-## Configuration
-
-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
-```
-
-### 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
@@ -84,167 +40,14 @@ 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
-- Speech-to-Text recognition
-- Multiple voice options across different languages
-- 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:**
+## Documentation
 
-- `https://www.googleapis.com/auth/cloud-platform` - Full access to Google Cloud Platform services
+- [Google](https://mastra.ai/integrations/voice/google)
 
-**For long-audio Text-to-Speech operations:**
+## Changelog
 
-- `locations.longAudioSynthesize` - Create long-audio synthesis operations
-- `operations.get` - Get operation status
-- `operations.list` - List operations
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/voice/google/CHANGELOG.md) for version history and release notes.
 
-## Voice Options
+## Support
 
-View the complete list using the `getSpeakers()` method or [Google Cloud's documentation](https://cloud.google.com/text-to-speech/docs/voices).
+We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-voice-google
 description: Documentation for @mastra/voice-google. Use when working with @mastra/voice-google APIs, configuration, or implementation.
 metadata:
   package: "@mastra/voice-google"
-  version: "0.14.2-alpha.0"
+  version: "0.14.2-alpha.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.14.2-alpha.0",
+  "version": "0.14.2-alpha.1",
   "package": "@mastra/voice-google",
   "exports": {},
   "modules": {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/voice-google",
-  "version": "0.14.2-alpha.0",
+  "version": "0.14.2-alpha.1",
   "description": "Mastra Google voice integration",
   "type": "module",
   "files": [
@@ -35,8 +35,8 @@
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
     "vitest": "4.1.10",
-    "@internal/types-builder": "0.0.104",
     "@internal/lint": "0.0.129",
+    "@internal/types-builder": "0.0.104",
     "@internal/voice": "0.0.27"
   },
   "peerDependencies": {