@mastra/voice-openai-realtime 0.2.4 → 0.3.0-alpha.1

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/voice-openai-realtime@0.2.4-alpha.4 build /home/runner/work/mastra/mastra/voice/openai-realtime-api
+> @mastra/voice-openai-realtime@0.3.0-alpha.1 build /home/runner/work/mastra/mastra/voice/openai-realtime-api
 > tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.4.0
 TSC Build start
-TSC ⚡️ Build success in 8246ms
+TSC ⚡️ Build success in 8301ms
 DTS Build start
 CLI Target: es2022
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/voice/openai-realtime-api/dist/_tsup-dts-rollup.d.ts
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/voice/openai-realtime-api/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 10928ms
+DTS ⚡️ Build success in 10933ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs 19.08 KB
-CJS ⚡️ Build success in 1013ms
-ESM dist/index.js 19.03 KB
-ESM ⚡️ Build success in 1014ms
+ESM dist/index.js 19.15 KB
+ESM ⚡️ Build success in 965ms
+CJS dist/index.cjs 19.20 KB
+CJS ⚡️ Build success in 969ms

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # @mastra/voice-openai-realtime
 
+## 0.3.0-alpha.1
+
+### Minor Changes
+
+- 83da932: Move @mastra/core to peerdeps
+
+### Patch Changes
+
+- Updated dependencies [b3a3d63]
+- Updated dependencies [344f453]
+- Updated dependencies [0a3ae6d]
+- Updated dependencies [95911be]
+- Updated dependencies [5eb5a99]
+- Updated dependencies [7e632c5]
+- Updated dependencies [1e9fbfa]
+- Updated dependencies [b2ae5aa]
+- Updated dependencies [a7292b0]
+- Updated dependencies [0dcb9f0]
+  - @mastra/core@0.10.0-alpha.1
+
+## 0.2.5-alpha.0
+
+### Patch Changes
+
+- d3628af: Add realtime context for openai realtime voice
+- Updated dependencies [f53a6ac]
+- Updated dependencies [eabdcd9]
+- Updated dependencies [90be034]
+- Updated dependencies [99f050a]
+- Updated dependencies [d0ee3c6]
+- Updated dependencies [23f258c]
+- Updated dependencies [2672a05]
+  - @mastra/core@0.9.5-alpha.0
+
 ## 0.2.4
 
 ### Patch Changes

package/dist/_tsup-dts-rollup.d.cts

@@ -1,5 +1,6 @@
 import { MastraVoice } from '@mastra/core/voice';
 import type { Realtime } from 'openai-realtime-api';
+import type { RuntimeContext } from '@mastra/core/runtime-context';
 import type { ToolsInput } from '@mastra/core/agent';
 
 /**
@@ -51,6 +52,7 @@ export declare class OpenAIRealtimeVoice extends MastraVoice {
     private debug;
     private queue;
     private transcriber;
+    private runtimeContext?;
     /**
      * Creates a new instance of OpenAIRealtimeVoice.
      *
@@ -216,7 +218,9 @@ export declare class OpenAIRealtimeVoice extends MastraVoice {
      * // Now ready for voice interactions
      * ```
      */
-    connect(): Promise<void>;
+    connect({ runtimeContext }?: {
+        runtimeContext?: RuntimeContext;
+    }): Promise<void>;
     disconnect(): void;
     /**
      * Streams audio data in real-time to the OpenAI service.
@@ -315,16 +319,18 @@ export declare class OpenAIRealtimeVoice extends MastraVoice {
     private sendEvent;
 }
 
-export declare const transformTools: (tools?: TTools_2) => {
-    openaiTool: {
-        type: string;
-        name: string;
-        description: string;
-        parameters: {
-            [key: string]: any;
-        };
+declare type ToolDefinition = {
+    type: 'function';
+    name: string;
+    description: string;
+    parameters: {
+        [key: string]: any;
     };
-    execute: (args: any) => Promise<any>;
+};
+
+export declare const transformTools: (tools?: TTools_2) => {
+    openaiTool: ToolDefinition;
+    execute: OpenAIExecuteFunction;
 }[];
 
 declare type TTools = ToolsInput;

package/dist/_tsup-dts-rollup.d.ts

@@ -1,5 +1,6 @@
 import { MastraVoice } from '@mastra/core/voice';
 import type { Realtime } from 'openai-realtime-api';
+import type { RuntimeContext } from '@mastra/core/runtime-context';
 import type { ToolsInput } from '@mastra/core/agent';
 
 /**
@@ -51,6 +52,7 @@ export declare class OpenAIRealtimeVoice extends MastraVoice {
     private debug;
     private queue;
     private transcriber;
+    private runtimeContext?;
     /**
      * Creates a new instance of OpenAIRealtimeVoice.
      *
@@ -216,7 +218,9 @@ export declare class OpenAIRealtimeVoice extends MastraVoice {
      * // Now ready for voice interactions
      * ```
      */
-    connect(): Promise<void>;
+    connect({ runtimeContext }?: {
+        runtimeContext?: RuntimeContext;
+    }): Promise<void>;
     disconnect(): void;
     /**
      * Streams audio data in real-time to the OpenAI service.
@@ -315,16 +319,18 @@ export declare class OpenAIRealtimeVoice extends MastraVoice {
     private sendEvent;
 }
 
-export declare const transformTools: (tools?: TTools_2) => {
-    openaiTool: {
-        type: string;
-        name: string;
-        description: string;
-        parameters: {
-            [key: string]: any;
-        };
+declare type ToolDefinition = {
+    type: 'function';
+    name: string;
+    description: string;
+    parameters: {
+        [key: string]: any;
     };
-    execute: (args: any) => Promise<any>;
+};
+
+export declare const transformTools: (tools?: TTools_2) => {
+    openaiTool: ToolDefinition;
+    execute: OpenAIExecuteFunction;
 }[];
 
 declare type TTools = ToolsInput;

package/dist/index.cjs

@@ -114,6 +114,7 @@ var OpenAIRealtimeVoice = class extends voice.MastraVoice {
   debug;
   queue = [];
   transcriber;
+  runtimeContext;
   /**
    * Returns a list of available voice speakers.
    *
@@ -310,9 +311,10 @@ var OpenAIRealtimeVoice = class extends voice.MastraVoice {
    * // Now ready for voice interactions
    * ```
    */
-  async connect() {
+  async connect({ runtimeContext } = {}) {
     const url = `${this.options.url || DEFAULT_URL}?model=${this.options.model || DEFAULT_MODEL}`;
     const apiKey = this.options.apiKey || process.env.OPENAI_API_KEY;
+    this.runtimeContext = runtimeContext;
     this.ws = new ws.WebSocket(url, void 0, {
       headers: {
         Authorization: "Bearer " + apiKey,
@@ -555,7 +557,7 @@ var OpenAIRealtimeVoice = class extends voice.MastraVoice {
         });
       }
       const result = await tool?.execute?.(
-        { context },
+        { context, runtimeContext: this.runtimeContext },
         {
           toolCallId: output.call_id,
           messages: []

package/dist/index.js

@@ -112,6 +112,7 @@ var OpenAIRealtimeVoice = class extends MastraVoice {
   debug;
   queue = [];
   transcriber;
+  runtimeContext;
   /**
    * Returns a list of available voice speakers.
    *
@@ -308,9 +309,10 @@ var OpenAIRealtimeVoice = class extends MastraVoice {
    * // Now ready for voice interactions
    * ```
    */
-  async connect() {
+  async connect({ runtimeContext } = {}) {
     const url = `${this.options.url || DEFAULT_URL}?model=${this.options.model || DEFAULT_MODEL}`;
     const apiKey = this.options.apiKey || process.env.OPENAI_API_KEY;
+    this.runtimeContext = runtimeContext;
     this.ws = new WebSocket(url, void 0, {
       headers: {
         Authorization: "Bearer " + apiKey,
@@ -553,7 +555,7 @@ var OpenAIRealtimeVoice = class extends MastraVoice {
         });
       }
       const result = await tool?.execute?.(
-        { context },
+        { context, runtimeContext: this.runtimeContext },
         {
           toolCallId: output.call_id,
           messages: []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/voice-openai-realtime",
-  "version": "0.2.4",
+  "version": "0.3.0-alpha.1",
   "description": "Mastra OpenAI Realtime API integration",
   "type": "module",
   "main": "dist/index.js",
@@ -22,8 +22,7 @@
   "dependencies": {
     "openai-realtime-api": "^1.0.7",
     "ws": "^8.18.1",
-    "zod-to-json-schema": "^3.24.5",
-    "@mastra/core": "^0.9.4"
+    "zod-to-json-schema": "^3.24.5"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.5",
@@ -33,7 +32,13 @@
     "tsup": "^8.4.0",
     "typescript": "^5.8.3",
     "vitest": "^2.1.9",
-    "@internal/lint": "0.0.5"
+    "zod": "^3.24.3",
+    "@internal/lint": "0.0.5",
+    "@mastra/core": "0.10.0-alpha.1"
+  },
+  "peerDependencies": {
+    "@mastra/core": "^0.9.4",
+    "zod": "^3.0.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake",

package/src/index.ts

@@ -1,6 +1,7 @@
 import { EventEmitter } from 'events';
 import { PassThrough } from 'stream';
 import type { ToolsInput } from '@mastra/core/agent';
+import type { RuntimeContext } from '@mastra/core/runtime-context';
 import { MastraVoice } from '@mastra/core/voice';
 import type { Realtime, RealtimeServerEvents } from 'openai-realtime-api';
 import { WebSocket } from 'ws';
@@ -113,7 +114,7 @@ export class OpenAIRealtimeVoice extends MastraVoice {
   private debug: boolean;
   private queue: unknown[] = [];
   private transcriber: Realtime.AudioTranscriptionModel;
-
+  private runtimeContext?: RuntimeContext;
   /**
    * Creates a new instance of OpenAIRealtimeVoice.
    *
@@ -363,9 +364,11 @@ export class OpenAIRealtimeVoice extends MastraVoice {
    * // Now ready for voice interactions
    * ```
    */
-  async connect() {
+  async connect({ runtimeContext }: { runtimeContext?: RuntimeContext } = {}) {
     const url = `${this.options.url || DEFAULT_URL}?model=${this.options.model || DEFAULT_MODEL}`;
     const apiKey = this.options.apiKey || process.env.OPENAI_API_KEY;
+    this.runtimeContext = runtimeContext;
+
     this.ws = new WebSocket(url, undefined, {
       headers: {
         Authorization: 'Bearer ' + apiKey,
@@ -634,7 +637,7 @@ export class OpenAIRealtimeVoice extends MastraVoice {
       }
 
       const result = await tool?.execute?.(
-        { context },
+        { context, runtimeContext: this.runtimeContext },
         {
           toolCallId: output.call_id,
           messages: [],

package/src/utils.test.ts

@@ -0,0 +1,119 @@
+import { createTool } from '@mastra/core/tools';
+import { describe, it, expect } from 'vitest';
+import { z } from 'zod';
+import { transformTools } from './utils';
+
+// Vitest provides these globals automatically, but we can import them explicitly for clarity
+
+describe('transformTools', () => {
+  describe('Basic Tool Transformation', () => {
+    it('should transform a tool with Zod inputSchema to OpenAI format', () => {
+      // Create a test tool with Zod schema
+      const tool = createTool({
+        id: 'zodTool',
+        description: 'A tool with Zod schema',
+        inputSchema: z.object({
+          name: z.string(),
+          age: z.number().optional(),
+        }),
+        outputSchema: z.string(),
+        execute: async ({ context }) => {
+          return `Hello, ${context.name}`;
+        },
+      });
+
+      // Transform the tool
+      const transformedTools = transformTools({
+        zodTool: tool,
+      });
+
+      // Assert the transformation results
+      expect(transformedTools).toHaveLength(1);
+      const { openaiTool } = transformedTools[0];
+
+      expect(openaiTool).toMatchObject({
+        type: 'function',
+        name: 'zodTool',
+        description: 'A tool with Zod schema',
+        parameters: expect.objectContaining({
+          type: 'object',
+          properties: expect.objectContaining({
+            name: expect.objectContaining({ type: 'string' }),
+            age: expect.objectContaining({ type: 'number' }),
+          }),
+          required: ['name'],
+        }),
+      });
+    });
+
+    it('should transform a tool with JSON schema parameters to OpenAI format', () => {
+      // Create a test tool with direct JSON schema
+      const tool = {
+        id: 'jsonTool',
+        description: 'A tool with JSON schema',
+        parameters: {
+          type: 'object',
+          properties: {
+            query: { type: 'string' },
+            limit: { type: 'integer' },
+          },
+          required: ['query'],
+        },
+        execute: async (args: { query: string; limit?: number }) => {
+          return `Searched for: ${args.query}`;
+        },
+      };
+
+      // Transform the tool
+      const transformedTools = transformTools({
+        jsonTool: tool,
+      });
+
+      // Assert the transformation results
+      expect(transformedTools).toHaveLength(1);
+      const { openaiTool } = transformedTools[0];
+
+      expect(openaiTool).toMatchObject({
+        type: 'function',
+        name: 'jsonTool',
+        description: 'A tool with JSON schema',
+        parameters: expect.objectContaining({
+          type: 'object',
+          properties: expect.objectContaining({
+            query: expect.objectContaining({ type: 'string' }),
+            limit: expect.objectContaining({ type: 'integer' }),
+          }),
+          required: ['query'],
+        }),
+      });
+    });
+  });
+
+  describe('Tool Execution Tests', () => {
+    it('should create an adapter function for tool execution', async () => {
+      // Create a tool that expects context
+      const tool = createTool({
+        id: 'messageTool',
+        description: 'A tool that processes a message',
+        inputSchema: z.object({
+          message: z.string(),
+        }),
+        outputSchema: z.string(),
+        execute: async ({ context }) => {
+          return `Processed: ${context.message}`;
+        },
+      });
+
+      // Transform the tool
+      const transformedTools = transformTools({
+        messageTool: tool,
+      });
+
+      // Execute the transformed tool
+      const result = await transformedTools[0].execute({ message: 'Hello' });
+
+      // Verify the adapter correctly passes the context
+      expect(result).toBe('Processed: Hello');
+    });
+  });
+});

package/src/utils.ts

@@ -3,10 +3,18 @@ import type { ToolsInput } from '@mastra/core/agent';
 import { zodToJsonSchema } from 'zod-to-json-schema';
 
 export type OpenAIExecuteFunction = (args: any) => Promise<any>;
+type ToolDefinition = {
+  type: 'function';
+  name: string;
+  description: string;
+  parameters: {
+    [key: string]: any;
+  };
+};
 
 type TTools = ToolsInput;
 export const transformTools = (tools?: TTools) => {
-  const openaiTools = [];
+  const openaiTools: { openaiTool: ToolDefinition; execute: OpenAIExecuteFunction }[] = [];
   for (const [name, tool] of Object.entries(tools || {})) {
     let parameters: { [key: string]: any };
 
@@ -28,7 +36,7 @@ export const transformTools = (tools?: TTools) => {
       console.warn(`Tool ${name} has neither inputSchema nor parameters, skipping`);
       continue;
     }
-    const openaiTool = {
+    const openaiTool: ToolDefinition = {
       type: 'function',
       name,
       description: tool.description || `Tool: ${name}`,