@fonoster/common 0.25.1 → 0.27.0

package/dist/assistants/assistantSchema.d.ts

@@ -18,6 +18,16 @@
  */
 import { z } from "zod";
 declare const assistantSchema: z.ZodObject<{
+    audioFilters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        options?: Record<string, unknown>;
+        name?: string;
+    }, {
+        options?: Record<string, unknown>;
+        name?: string;
+    }>, "many">>;
     conversationSettings: z.ZodObject<{
         firstMessage: z.ZodOptional<z.ZodString>;
         systemPrompt: z.ZodString;
@@ -526,6 +536,10 @@ declare const assistantSchema: z.ZodObject<{
         }[];
     }>>;
 }, "strip", z.ZodTypeAny, {
+    audioFilters?: {
+        options?: Record<string, unknown>;
+        name?: string;
+    }[];
     conversationSettings?: {
         firstMessage?: string;
         systemPrompt?: string;
@@ -622,6 +636,10 @@ declare const assistantSchema: z.ZodObject<{
         }[];
     };
 }, {
+    audioFilters?: {
+        options?: Record<string, unknown>;
+        name?: string;
+    }[];
     conversationSettings?: {
         firstMessage?: string;
         systemPrompt?: string;

package/dist/assistants/assistantSchema.js

@@ -20,11 +20,15 @@ exports.assistantSchema = void 0;
  * limitations under the License.
  */
 const zod_1 = require("zod");
+const audioFiltersSchema_1 = require("./audioFiltersSchema");
 const conversationSettingsSchema_1 = require("./conversationSettingsSchema");
 const eventsHookSchema_1 = require("./eventsHookSchema");
 const languageModelConfigSchema_1 = require("./languageModelConfigSchema");
 const testCasesSchema_1 = require("./testCasesSchema");
 const assistantSchema = zod_1.z.object({
+    // Audio filters the Media Server runs on the caller's audio, before speech
+    // recognition and voice activity detection. Optional; none by default.
+    audioFilters: audioFiltersSchema_1.audioFiltersSchema,
     conversationSettings: conversationSettingsSchema_1.conversationSettingsSchema,
     languageModel: languageModelConfigSchema_1.languageModelConfigSchema,
     eventsHook: eventsHookSchema_1.eventsHookSchema.optional(),

package/dist/assistants/audioFiltersSchema.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { z } from "zod";
+declare const audioFiltersSchema: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    options?: Record<string, unknown>;
+    name?: string;
+}, {
+    options?: Record<string, unknown>;
+    name?: string;
+}>, "many">>;
+export { audioFiltersSchema };

package/dist/assistants/audioFiltersSchema.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.audioFiltersSchema = void 0;
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const zod_1 = require("zod");
+// Audio filters run in the Media Server. Options carry tuning values only;
+// credentials live in the Media Server's environment, never in this config,
+// so assistant files stay safe to commit and share.
+const audioFiltersSchema = zod_1.z
+    .array(zod_1.z.object({
+    name: zod_1.z.string().min(1, { message: "An audio filter name is required" }),
+    options: zod_1.z.record(zod_1.z.unknown()).optional()
+}))
+    .default([]);
+exports.audioFiltersSchema = audioFiltersSchema;

package/dist/assistants/index.d.ts

@@ -17,6 +17,7 @@
  * limitations under the License.
  */
 export * from "./tools";
+export * from "./audioFiltersSchema";
 export * from "./assistantSchema";
 export * from "./LanguageModelProvider";
 export * from "./conversationSettingsSchema";

package/dist/assistants/index.js

@@ -33,6 +33,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * limitations under the License.
  */
 __exportStar(require("./tools"), exports);
+__exportStar(require("./audioFiltersSchema"), exports);
 __exportStar(require("./assistantSchema"), exports);
 __exportStar(require("./LanguageModelProvider"), exports);
 __exportStar(require("./conversationSettingsSchema"), exports);

package/dist/protos/voice.proto

@@ -405,6 +405,36 @@ message StreamGatherPayload {
   int32 response_time = 4;
 }
 
+// An audio filter the application wants applied to the caller's audio
+message AudioFilter {
+  // Name of a filter registered in the Media Server (e.g. "aiCoustics")
+  string name = 1;
+
+  // Filter-specific options. Carries tuning values only; credentials are read
+  // from the Media Server's environment and never travel on this stream.
+  google.protobuf.Struct options = 2;
+}
+
+// Request to set the audio filters for the session. Sending it again replaces
+// the previous filters; an empty list removes them.
+message SetAudioFiltersRequest {
+  // The session reference generated by the Media Server
+  string media_session_ref = 1;
+
+  // Filters to run, in order
+  repeated AudioFilter filters = 2;
+}
+
+// Result of setting the session's audio filters. `error` is set when the
+// filters could not be applied; the call continues with unfiltered audio.
+message SetAudioFiltersResponse {
+  // The session reference generated by the Media Server
+  string media_session_ref = 1;
+
+  // Empty when the filters were applied
+  string error = 2;
+}
+
 // VoiceInStream is the input stream for the voice service
 message VoiceInStream {
   oneof content {
@@ -461,6 +491,9 @@ message VoiceInStream {
 
     // Message with payload for the stream gather
     StreamGatherPayload stream_gather_payload = 17;
+
+    // Response to setting the session's audio filters
+    SetAudioFiltersResponse set_audio_filters_response = 19;
   }
 }
 
@@ -517,5 +550,8 @@ message VoiceOutStream {
 
     // Request to stop a stream gather
     StopStreamGatherRequest stop_stream_gather_request = 18;
+
+    // Request to set the audio filters for the session
+    SetAudioFiltersRequest set_audio_filters_request = 20;
   }
 }

package/dist/voice/voice.d.ts

@@ -71,8 +71,22 @@ declare enum StreamContent {
     START_STREAM_GATHER_RESPONSE = "startStreamGatherResponse",
     STOP_STREAM_GATHER_REQUEST = "stopStreamGatherRequest",
     STOP_STREAM_GATHER_RESPONSE = "stopStreamGatherResponse",
-    STREAM_GATHER_PAYLOAD = "streamGatherPayload"
+    STREAM_GATHER_PAYLOAD = "streamGatherPayload",
+    SET_AUDIO_FILTERS_REQUEST = "setAudioFiltersRequest",
+    SET_AUDIO_FILTERS_RESPONSE = "setAudioFiltersResponse"
 }
+type AudioFilterConfig = {
+    name: string;
+    options?: Record<string, unknown>;
+};
+type SetAudioFiltersRequest = {
+    mediaSessionRef: string;
+    filters: AudioFilterConfig[];
+};
+type SetAudioFiltersResponse = {
+    mediaSessionRef: string;
+    error?: string;
+};
 declare enum AmdStatus {
     UNSPECIFIED = "AMD_STATUS_UNSPECIFIED",
     HUMAN = "HUMAN",
@@ -123,6 +137,7 @@ type VoiceIn = {
     startStreamGatherResponse?: VerbResponse;
     stopStreamGatherResponse?: VerbResponse;
     stopSayResponse?: VerbResponse;
+    setAudioFiltersResponse?: SetAudioFiltersResponse;
 };
 type VoiceOut = {
     answerRequest?: VerbRequest;
@@ -142,6 +157,7 @@ type VoiceOut = {
     startStreamGatherRequest?: StartStreamGatherRequest;
     stopStreamGatherRequest?: VerbRequest;
     stopSayRequest?: StopSayRequest;
+    setAudioFiltersRequest?: SetAudioFiltersRequest;
 };
 type BaseVoiceStream<T, W> = {
     removeListener: (e: StreamEvent, cb: (voice: T) => void) => void;
@@ -152,4 +168,4 @@ type BaseVoiceStream<T, W> = {
 };
 type VoiceSessionStreamServer = BaseVoiceStream<VoiceIn, VoiceOut>;
 type VoiceSessionStreamClient = BaseVoiceStream<VoiceOut | GrpcError, VoiceIn | GrpcError>;
-export { Amd, AmdStatus, DATA, END, ERROR, StreamContent, StreamEvent, VoiceClientConfig, VoiceIn, VoiceOut, VoiceSessionStreamClient, VoiceSessionStreamServer };
+export { Amd, AmdStatus, AudioFilterConfig, DATA, END, ERROR, SetAudioFiltersRequest, SetAudioFiltersResponse, StreamContent, StreamEvent, VoiceClientConfig, VoiceIn, VoiceOut, VoiceSessionStreamClient, VoiceSessionStreamServer };

package/dist/voice/voice.js

@@ -49,6 +49,8 @@ var StreamContent;
     StreamContent["STOP_STREAM_GATHER_REQUEST"] = "stopStreamGatherRequest";
     StreamContent["STOP_STREAM_GATHER_RESPONSE"] = "stopStreamGatherResponse";
     StreamContent["STREAM_GATHER_PAYLOAD"] = "streamGatherPayload";
+    StreamContent["SET_AUDIO_FILTERS_REQUEST"] = "setAudioFiltersRequest";
+    StreamContent["SET_AUDIO_FILTERS_RESPONSE"] = "setAudioFiltersResponse";
 })(StreamContent || (exports.StreamContent = StreamContent = {}));
 // Answering Machine Detection verdict. String values match the proto enum value
 // names so the object round-trips through @grpc/proto-loader (enums: String).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonoster/common",
-  "version": "0.25.1",
+  "version": "0.27.0",
   "description": "Common library for Fonoster projects",
   "author": "Pedro Sanders <psanders@fonoster.com>",
   "homepage": "https://github.com/fonoster/fonoster#readme",
@@ -18,8 +18,8 @@
     "clean": "rimraf ./dist node_modules tsconfig.tsbuildinfo"
   },
   "dependencies": {
-    "@fonoster/logger": "^0.25.0",
-    "@fonoster/types": "^0.25.0",
+    "@fonoster/logger": "^0.27.0",
+    "@fonoster/types": "^0.27.0",
     "@grpc/grpc-js": "~1.10.11",
     "@grpc/proto-loader": "^0.7.15",
     "@influxdata/influxdb-client": "^1.35.0",
@@ -50,5 +50,5 @@
   "devDependencies": {
     "@types/nodemailer": "^6.4.21"
   },
-  "gitHead": "7a3786a2704ae379211fbd350a3f6e8d913a5fd6"
+  "gitHead": "1191b34677b51a36000177887ff82303ef2693e1"
 }