@openai/agents-realtime 0.11.8 → 0.12.1

package/dist/tool.mjs

@@ -16,6 +16,43 @@ export function isValidRealtimeTool(tool) {
     return (tool.type === 'function' ||
         (tool.type === 'hosted_tool' && tool.name === 'hosted_mcp'));
 }
+export function validateRealtimeToolNames(tools, handoffs) {
+    const sourcesByName = new Map();
+    for (const tool of tools) {
+        const sources = sourcesByName.get(tool.name) ?? [];
+        sources.push('function tool');
+        sourcesByName.set(tool.name, sources);
+    }
+    for (const handoff of handoffs) {
+        const sources = sourcesByName.get(handoff.toolName) ?? [];
+        sources.push('handoff');
+        sourcesByName.set(handoff.toolName, sources);
+    }
+    const duplicateDescriptions = [...sourcesByName.entries()]
+        .filter(([, sources]) => sources.length > 1)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([name, sources]) => `'${name}' (${formatRealtimeToolSources(sources)})`);
+    if (duplicateDescriptions.length === 0) {
+        return;
+    }
+    const label = duplicateDescriptions.length === 1 ? 'name' : 'names';
+    throw new UserError(`Duplicate Realtime tool ${label} found: ${duplicateDescriptions.join(', ')}. ` +
+        'Realtime function tool and handoff names must be unique. Rename one of them before starting the session.');
+}
+function formatRealtimeToolSources(sources) {
+    const counts = new Map();
+    for (const source of sources) {
+        counts.set(source, (counts.get(source) ?? 0) + 1);
+    }
+    const descriptions = [...counts.entries()].map(([source, count]) => count === 1 ? source : `${count} ${source}s`);
+    if (descriptions.length === 1) {
+        return descriptions[0];
+    }
+    if (descriptions.length === 2) {
+        return `${descriptions[0]} and ${descriptions[1]}`;
+    }
+    return `${descriptions.slice(0, -1).join(', ')}, and ${descriptions.at(-1)}`;
+}
 export function toRealtimeToolDefinition(tool) {
     if (tool.type === 'function') {
         return tool;

package/dist/tool.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tool.mjs","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"OAAO,EAIL,SAAS,GACV,MAAM,qBAAqB;OACrB,EAAE,iCAAiC,EAAE,MAAM,2BAA2B;AAG7E,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAOnE,MAAM,UAAU,gBAAgB,CAAI,OAAU;IAC5C,OAAO;QACL,CAAC,wBAAwB,CAAC,EAAE,IAAI;QAChC,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAAe;IAEf,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,wBAAwB,IAAI,MAAM,CACnC,CAAC;AACJ,CAAC;AAID,MAAM,UAAU,mBAAmB,CAAC,IAAe;IACjD,OAAO,CACL,IAAI,CAAC,IAAI,KAAK,UAAU;QACxB,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,CAC5D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,IAAkB;IAElB,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC9D,MAAM,SAAS,GACb,IAAI,CAAC,YAAY,CAAC,UAAU,IAAI,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;YACrE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU;YAC9B,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,eAAe,GACnB,OAAO,IAAI,CAAC,YAAY,CAAC,gBAAgB,KAAK,WAAW;YACvD,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,iCAAiC,CAAC,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;QAC5E,OAAO;YACL,IAAI,EAAE,KAAK;YACX,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,YAAY;YAC5C,UAAU,EAAE,SAAS;YACrB,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO;YAClC,aAAa,EAAE,IAAI,CAAC,YAAY,CAAC,aAAa;YAC9C,GAAG,CAAC,OAAO,eAAe,KAAK,WAAW;gBACxC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,SAAS,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"tool.mjs","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"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"}

package/dist/transportLayerEvents.d.ts

@@ -18,6 +18,8 @@ export type TransportToolCallEvent = {
     callId: string;
     arguments: string;
     previousItemId?: string;
+    /** The response that produced this tool call. */
+    responseId: string;
 };
 /**
  * Event representing audio data from the model on the transport layer.

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@openai/agents-realtime",
-  "repository": "https://github.com/openai/openai-agents-js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openai/openai-agents-js"
+  },
   "homepage": "https://openai.github.io/openai-agents-js/",
-  "version": "0.11.8",
+  "version": "0.12.1",
   "description": "The OpenAI Agents SDK is a lightweight yet powerful framework for building multi-agent workflows. This package contains the logic for building realtime voice agents on the server or in the browser.",
   "author": "OpenAI <support@openai.com>",
   "main": "dist/index.js",
@@ -50,8 +53,8 @@
   "dependencies": {
     "@types/ws": "^8.18.1",
     "debug": "^4.4.0",
-    "ws": "^8.18.1",
-    "@openai/agents-core": "0.11.8"
+    "ws": "^8.21.0",
+    "@openai/agents-core": "0.12.1"
   },
   "keywords": [
     "openai",
@@ -65,7 +68,7 @@
   },
   "devDependencies": {
     "@types/debug": "^4.1.12",
-    "vite": "^6.4.2",
+    "vite": "^6.4.3",
     "zod": "^4.0.0"
   },
   "files": [