@fonoster/common 0.22.3 → 0.24.0

package/dist/protos/calls.proto

@@ -81,6 +81,29 @@ message CallDetailRecord {
   int32 duration = 9;
   // The call direction
   CallDirection direction = 10;
+
+  // Answering Machine Detection verdict for the call. Mirrors
+  // fonoster.voice.v1beta2.Amd.Status; duplicated here (nested, like
+  // TrackCallResponse.Status below) because calls.proto does not import
+  // voice.proto and a top-level enum's values would collide with CallStatus's.
+  enum AmdStatus {
+    AMD_STATUS_UNSPECIFIED = 0;
+    HUMAN = 1;
+    MACHINE = 2;
+    VOICEMAIL = 3;
+    IVR = 4;
+    UNKNOWN = 5;
+  }
+  // Answering Machine Detection verdict, absent when AMD did not run
+  AmdStatus amd_status = 11;
+  // Confidence for the reported amd_status, 0..1
+  float amd_confidence = 12;
+  // Identifier of the detector that produced the verdict (e.g. "asterisk-amd@1")
+  string amd_detector = 13;
+  // Wall-clock time spent producing the verdict, in milliseconds
+  int32 amd_latency_ms = 14;
+  // Detector-specific cause code (e.g. Asterisk's AMDCAUSE), useful for tuning
+  string amd_cause = 15;
 }
 
 // The request message for Calls.Call

package/dist/protos/voice.proto

@@ -67,6 +67,40 @@ message CreateSessionRequest {
 
   // Metadata associated with the session
   map<string, string> metadata = 10;
+
+  // Answering Machine Detection result, computed on early call audio before
+  // this session is dispatched. Absent/UNSPECIFIED when the probe is disabled.
+  Amd amd = 12;
+}
+
+// Answering Machine Detection verdict for the answered call
+message Amd {
+  enum Status {
+    // The probe was disabled or did not run
+    AMD_STATUS_UNSPECIFIED = 0;
+    // A live person answered
+    HUMAN = 1;
+    // A generic answering machine answered
+    MACHINE = 2;
+    // A personal or carrier voicemail greeting answered
+    VOICEMAIL = 3;
+    // An auto-attendant / IVR menu answered
+    IVR = 4;
+    // The probe ran but was inconclusive (low confidence, silence, or timeout)
+    UNKNOWN = 5;
+  }
+
+  // The detected class of answerer
+  Status status = 1;
+
+  // Model confidence for the reported status, 0..1
+  float confidence = 2;
+
+  // Identifier of the detector that produced the verdict (e.g. "asterisk-amd@1")
+  string detector = 3;
+
+  // Wall-clock time spent producing the verdict, in milliseconds
+  int32 latency_ms = 4;
 }
 
 // Common request for verbs

package/dist/voice/voice.d.ts

@@ -73,6 +73,20 @@ declare enum StreamContent {
     STOP_STREAM_GATHER_RESPONSE = "stopStreamGatherResponse",
     STREAM_GATHER_PAYLOAD = "streamGatherPayload"
 }
+declare enum AmdStatus {
+    UNSPECIFIED = "AMD_STATUS_UNSPECIFIED",
+    HUMAN = "HUMAN",
+    MACHINE = "MACHINE",
+    VOICEMAIL = "VOICEMAIL",
+    IVR = "IVR",
+    UNKNOWN = "UNKNOWN"
+}
+type Amd = {
+    status: AmdStatus;
+    confidence: number;
+    detector: string;
+    latencyMs: number;
+};
 type VoiceClientConfig = {
     appRef: string;
     accessKeyId: string;
@@ -85,6 +99,7 @@ type VoiceClientConfig = {
     sessionToken: string;
     callDirection: CallDirection;
     metadata?: Record<string, string>;
+    amd?: Amd;
 };
 type VoiceIn = {
     request?: VoiceRequest;
@@ -137,4 +152,4 @@ type BaseVoiceStream<T, W> = {
 };
 type VoiceSessionStreamServer = BaseVoiceStream<VoiceIn, VoiceOut>;
 type VoiceSessionStreamClient = BaseVoiceStream<VoiceOut | GrpcError, VoiceIn | GrpcError>;
-export { DATA, END, ERROR, StreamContent, StreamEvent, VoiceClientConfig, VoiceIn, VoiceOut, VoiceSessionStreamClient, VoiceSessionStreamServer };
+export { Amd, AmdStatus, DATA, END, ERROR, StreamContent, StreamEvent, VoiceClientConfig, VoiceIn, VoiceOut, VoiceSessionStreamClient, VoiceSessionStreamServer };

package/dist/voice/voice.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StreamEvent = exports.StreamContent = exports.ERROR = exports.END = exports.DATA = void 0;
+exports.StreamEvent = exports.StreamContent = exports.ERROR = exports.END = exports.DATA = exports.AmdStatus = void 0;
 const DATA = "data";
 exports.DATA = DATA;
 const END = "end";
@@ -50,3 +50,14 @@ var StreamContent;
     StreamContent["STOP_STREAM_GATHER_RESPONSE"] = "stopStreamGatherResponse";
     StreamContent["STREAM_GATHER_PAYLOAD"] = "streamGatherPayload";
 })(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).
+var AmdStatus;
+(function (AmdStatus) {
+    AmdStatus["UNSPECIFIED"] = "AMD_STATUS_UNSPECIFIED";
+    AmdStatus["HUMAN"] = "HUMAN";
+    AmdStatus["MACHINE"] = "MACHINE";
+    AmdStatus["VOICEMAIL"] = "VOICEMAIL";
+    AmdStatus["IVR"] = "IVR";
+    AmdStatus["UNKNOWN"] = "UNKNOWN";
+})(AmdStatus || (exports.AmdStatus = AmdStatus = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonoster/common",
-  "version": "0.22.3",
+  "version": "0.24.0",
   "description": "Common library for Fonoster projects",
   "author": "Pedro Sanders <psanders@fonoster.com>",
   "homepage": "https://github.com/fonoster/fonoster#readme",
@@ -18,7 +18,7 @@
     "clean": "rimraf ./dist node_modules tsconfig.tsbuildinfo"
   },
   "dependencies": {
-    "@fonoster/logger": "^0.22.0",
+    "@fonoster/logger": "^0.24.0",
     "@grpc/grpc-js": "~1.10.11",
     "@grpc/proto-loader": "^0.7.15",
     "@influxdata/influxdb-client": "^1.35.0",
@@ -49,5 +49,5 @@
   "devDependencies": {
     "@types/nodemailer": "^6.4.21"
   },
-  "gitHead": "2123e04933b54d78c9e93e64102ec89dc6fb79b6"
+  "gitHead": "36670cb30dbc0604029b2d49a59153c53f69fe1b"
 }