@absolutejs/voice 0.0.22-beta.546 → 0.0.22-beta.548

package/dist/core/types.d.ts

@@ -745,7 +745,9 @@ export type VoiceSurfaceConfig<O> = false | O | (Record<string, never> extends O
 export type VoicePluginConfig<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = {
     costTelemetry?: VoiceCostTelemetryConfig<TContext, TSession, TResult>;
     path: string;
-    greeting?: string | (() => string | Promise<string>);
+    greeting?: string | ((input: {
+        session: TSession;
+    }) => string | Promise<string>);
     languageStrategy?: VoiceLanguageStrategy;
     lexicon?: VoiceLexiconEntry[] | VoiceLexiconResolver<TContext>;
     phraseHints?: VoicePhraseHint[] | VoicePhraseHintResolver<TContext>;
@@ -859,7 +861,9 @@ export type CreateVoiceSessionOptions<TContext = unknown, TSession extends Voice
     id: string;
     context: TContext;
     socket: VoiceSocket;
-    greeting?: string | (() => string | Promise<string>);
+    greeting?: string | ((input: {
+        session: TSession;
+    }) => string | Promise<string>);
     stt?: STTAdapter;
     realtime?: RealtimeAdapter;
     realtimeInputFormat?: AudioFormat;

package/dist/index.js

@@ -5721,7 +5721,7 @@ var createVoiceSession = (options) => {
     kickCallSilenceWatchdog();
     startAmdEvaluationTimer();
     if (shouldFireOnSession && options.greeting && session.turns.length === 0) {
-      const greetingText = typeof options.greeting === "function" ? await options.greeting() : options.greeting;
+      const greetingText = typeof options.greeting === "function" ? await options.greeting({ session }) : options.greeting;
       const greetingTurnId = createId();
       await send({
         text: greetingText,
@@ -24302,8 +24302,23 @@ var createTwilioSocketAdapter = (socket, getState) => ({
     if (!state.streamSid) {
       return;
     }
+    const clearMessage = { event: "clear", streamSid: state.streamSid };
     state.reviewRecorder?.recordTwilioOutbound({ event: "clear" });
-    await Promise.resolve(socket.send(JSON.stringify({ event: "clear", streamSid: state.streamSid })));
+    await state.trace?.append({
+      at: Date.now(),
+      payload: {
+        callSid: state.callSid ?? undefined,
+        carrier: state.carrier,
+        direction: "outbound",
+        envelope: clearMessage,
+        event: "clear",
+        streamId: state.streamSid
+      },
+      scenarioId: state.scenarioId ?? undefined,
+      sessionId: state.sessionId ?? state.streamSid,
+      type: "client.telephony_media"
+    });
+    await Promise.resolve(socket.send(JSON.stringify(clearMessage)));
   },
   close: async (code, reason) => {
     await Promise.resolve(socket.close(code, reason));
@@ -24506,7 +24521,9 @@ var createTwilioMediaStreamBridge = (socket, options) => {
     sessionHandle = createVoiceSession({
       audioConditioning,
       context: options.context,
+      costAccountant: options.costAccountant,
       costTelemetry: options.costTelemetry,
+      costTelephony: options.costTelephony,
       greeting: options.greeting,
       id: bridgeState.sessionId,
       languageStrategy: options.languageStrategy,
@@ -24514,6 +24531,7 @@ var createTwilioMediaStreamBridge = (socket, options) => {
       logger,
       phraseHints,
       reconnect,
+      recording: options.recording,
       route,
       scenarioId: bridgeState.scenarioId ?? undefined,
       socket: voiceSocket,
@@ -24521,6 +24539,7 @@ var createTwilioMediaStreamBridge = (socket, options) => {
       stt: options.stt,
       sttFallback: resolveSTTFallbackConfig(options.sttFallback),
       sttLifecycle: options.sttLifecycle ?? runtimePreset.sttLifecycle,
+      trace: options.trace,
       tts: options.tts,
       turnDetection
     });

package/dist/telephony/twilio.d.ts

@@ -107,6 +107,14 @@ export type TwilioMediaStreamBridgeOptions<TContext = unknown, TSession extends
     sessionId?: string;
     stt: STTAdapter;
     telephonyMediaCarrier?: "plivo" | "telnyx" | "twilio";
+    /** Capture call audio (per-channel) to a recording store. */
+    recording?: import("../core/types").VoiceSessionRecordingConfig;
+    /** Per-call cost accounting (STT/LLM/TTS) — emits turn.cost/cost.ready traces. */
+    costAccountant?: import("../core/costAccounting").VoiceCostAccountant;
+    /** Telephony cost provider for the accountant (e.g. "twilio"). */
+    costTelephony?: {
+        provider?: string;
+    };
 };
 export type TwilioMediaStreamBridge = {
     close: (reason?: string) => Promise<void>;

package/dist/testing/index.js

@@ -7538,7 +7538,7 @@ var createVoiceSession = (options) => {
     kickCallSilenceWatchdog();
     startAmdEvaluationTimer();
     if (shouldFireOnSession && options.greeting && session.turns.length === 0) {
-      const greetingText = typeof options.greeting === "function" ? await options.greeting() : options.greeting;
+      const greetingText = typeof options.greeting === "function" ? await options.greeting({ session }) : options.greeting;
       const greetingTurnId = createId();
       await send({
         text: greetingText,
@@ -12838,8 +12838,23 @@ var createTwilioSocketAdapter = (socket, getState) => ({
     if (!state.streamSid) {
       return;
     }
+    const clearMessage = { event: "clear", streamSid: state.streamSid };
     state.reviewRecorder?.recordTwilioOutbound({ event: "clear" });
-    await Promise.resolve(socket.send(JSON.stringify({ event: "clear", streamSid: state.streamSid })));
+    await state.trace?.append({
+      at: Date.now(),
+      payload: {
+        callSid: state.callSid ?? undefined,
+        carrier: state.carrier,
+        direction: "outbound",
+        envelope: clearMessage,
+        event: "clear",
+        streamId: state.streamSid
+      },
+      scenarioId: state.scenarioId ?? undefined,
+      sessionId: state.sessionId ?? state.streamSid,
+      type: "client.telephony_media"
+    });
+    await Promise.resolve(socket.send(JSON.stringify(clearMessage)));
   },
   close: async (code, reason) => {
     await Promise.resolve(socket.close(code, reason));
@@ -13042,7 +13057,9 @@ var createTwilioMediaStreamBridge = (socket, options) => {
     sessionHandle = createVoiceSession({
       audioConditioning,
       context: options.context,
+      costAccountant: options.costAccountant,
       costTelemetry: options.costTelemetry,
+      costTelephony: options.costTelephony,
       greeting: options.greeting,
       id: bridgeState.sessionId,
       languageStrategy: options.languageStrategy,
@@ -13050,6 +13067,7 @@ var createTwilioMediaStreamBridge = (socket, options) => {
       logger,
       phraseHints,
       reconnect,
+      recording: options.recording,
       route,
       scenarioId: bridgeState.scenarioId ?? undefined,
       socket: voiceSocket,
@@ -13057,6 +13075,7 @@ var createTwilioMediaStreamBridge = (socket, options) => {
       stt: options.stt,
       sttFallback: resolveSTTFallbackConfig(options.sttFallback),
       sttLifecycle: options.sttLifecycle ?? runtimePreset.sttLifecycle,
+      trace: options.trace,
       tts: options.tts,
       turnDetection
     });
@@ -13361,7 +13380,7 @@ var createFakeSTTAdapter = (inputSpy, sttDelayMs) => ({
       final: new Set,
       partial: new Set
     };
-    let delivered = false;
+    let sendCount = 0;
     return {
       close: async () => {
         for (const handler of listeners.close) {
@@ -13376,31 +13395,44 @@ var createFakeSTTAdapter = (inputSpy, sttDelayMs) => ({
       },
       send: async (audio) => {
         inputSpy.push(toUint8Array2(audio));
-        if (delivered) {
+        sendCount += 1;
+        if (sendCount === 1) {
+          if (sttDelayMs > 0) {
+            await Bun.sleep(sttDelayMs);
+          }
+          const receivedAt = Date.now();
+          for (const handler of listeners.final) {
+            handler({
+              receivedAt,
+              transcript: {
+                id: "telephony-benchmark-final",
+                isFinal: true,
+                text: "hello from twilio"
+              },
+              type: "final"
+            });
+          }
+          for (const handler of listeners.endOfTurn) {
+            handler({
+              reason: "vendor",
+              receivedAt,
+              type: "endOfTurn"
+            });
+          }
           return;
         }
-        delivered = true;
-        if (sttDelayMs > 0) {
-          await Bun.sleep(sttDelayMs);
-        }
-        const receivedAt = Date.now();
-        for (const handler of listeners.final) {
-          handler({
-            receivedAt,
-            transcript: {
-              id: "telephony-benchmark-final",
-              isFinal: true,
-              text: "hello from twilio"
-            },
-            type: "final"
-          });
-        }
-        for (const handler of listeners.endOfTurn) {
-          handler({
-            reason: "vendor",
-            receivedAt,
-            type: "endOfTurn"
-          });
+        if (sendCount === 2) {
+          for (const handler of listeners.partial) {
+            handler({
+              receivedAt: Date.now(),
+              transcript: {
+                id: "telephony-benchmark-partial",
+                isFinal: false,
+                text: "actually wait"
+              },
+              type: "partial"
+            });
+          }
         }
       }
     };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/voice",
-	"version": "0.0.22-beta.546",
+	"version": "0.0.22-beta.548",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",