@fonoster/amd 0.26.0 → 0.30.0

package/README.md

@@ -59,10 +59,15 @@ as a channel variable.
 
 Set it from the dialplan by giving `AMD_MODE` a value before the `AGI()`
 call — apiserver already does this for API-originated calls via
-`APISERVER_AMD_MODE` (see below).
+`amd.mode` in `fonoster.yaml` (see below).
 
 ## Configuration
 
+The sidecar reads these from its container environment only; it never loads a
+`.env` file, in development either. Set them in the container's environment
+(Compose `environment:`, a Kubernetes `env:`), or export them before
+`npm run start:dev`.
+
 | env | default | meaning |
 |---|---|---|
 | `AMD_AGI_PORT` | `4573` | FastAGI listener port |
@@ -76,11 +81,11 @@ call — apiserver already does this for API-originated calls via
 
 ## Enabling it end-to-end
 
-Set `APISERVER_AMD_ENABLED=true` and `APISERVER_AMD_ENGINE=ml` on `apiserver`
-(next to the existing native-AMD env vars). With `AMD_ENGINE` unset or set to
-anything but `ml`, behavior is unchanged from Asterisk's native `AMD()`.
-Additionally set `APISERVER_AMD_MODE=full` to opt into the richer variable
-set — omit it (or leave it `compact`) to stay native-AMD-compatible.
+Set `amd.enabled: true` and `amd.engine: ml` in the API server's
+`config/fonoster.yaml`. With the engine unset or set to anything but `ml`,
+behavior is unchanged from Asterisk's native `AMD()`. Additionally set
+`amd.mode: full` to opt into the richer variable set — omit it (or leave it
+`compact`) to stay native-AMD-compatible.
 
 ## Regression corpus
 
@@ -118,38 +123,11 @@ AGI+AudioSocket mechanism and the mode flag work end-to-end; run it with:
 npm run integration
 ```
 
-## Isolated smoke test (manual, against real Asterisk)
-
-This service can also be exercised without `apiserver`, `autopilot`, NATS, or
-Postgres — just this container and a bare Asterisk instance. Unlike the
-integration test above, this path has not been run against a real Asterisk
-box in this repo's CI; treat it as a documented starting point to validate by
-hand:
-
-```sh
-docker compose -f mods/amd/docker-compose.smoke.yaml up --build
-```
-
-That starts `amd` alongside a `fonoster/asterisk` container using
-`mods/amd/smoke/extensions.conf`, a minimal dialplan with one test
-extension:
+## Status after the rebuild
 
-```
-exten => 7000,1,Answer()
- same => n,Wait(1)
- same => n,AGI(agi://amd:4573)
- same => n,Verbose(1,AMDSTATUS=${AMDSTATUS} AMDCAUSE=${AMDCAUSE})
- same => n,Hangup()
-```
-
-Originate a call into extension `7000` playing a known recorded sample (a
-human greeting vs. a voicemail greeting) and check the Asterisk console log
-for the `AMDSTATUS`/`AMDCAUSE` line the `Verbose()` step prints, e.g.:
-
-```sh
-docker compose -f mods/amd/docker-compose.smoke.yaml exec asterisk \
-  asterisk -rx "channel originate Local/7000@smoke-test application Playback /path/to/sample"
-```
+Asterisk is retired (cleanbreak CB-B6), so the AGI and AudioSocket front end has no caller and its
+Asterisk smoke test is gone. The classifier stays: it moves behind a voice-worker listener in
+`add-media-node` task 4.3.
 
 ## Development
 

package/dist/amd/AmdModel.d.ts

@@ -10,6 +10,11 @@ declare function softmaxTop(logits: ArrayLike<number>): {
     index: number;
     confidence: number;
 };
+/**
+ * Releases the loaded ONNX session. Call it before the process exits on purpose (tests): ONNX
+ * Runtime's threads abort the process ("mutex lock failed") if they are still alive at exit.
+ */
+export declare function releaseAmdModel(): Promise<void>;
 /**
  * Classify a buffer of raw slin16 PCM (16 kHz mono) as human / voicemail / IVR /
  * machine. Loads and caches the ONNX session on first call. Throws on model or

package/dist/amd/AmdModel.js

@@ -43,6 +43,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_MODEL_DIR = void 0;
+exports.releaseAmdModel = releaseAmdModel;
 exports.classifyPcm = classifyPcm;
 exports.mapLabelToStatus = mapLabelToStatus;
 exports.softmaxTop = softmaxTop;
@@ -114,6 +115,24 @@ function softmaxTop(logits) {
     return { index, confidence: sum > 0 ? exps[index] / sum : 0 };
 }
 let loaded = null;
+/**
+ * Releases the loaded ONNX session. Call it before the process exits on purpose (tests): ONNX
+ * Runtime's threads abort the process ("mutex lock failed") if they are still alive at exit.
+ */
+function releaseAmdModel() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const entry = loaded;
+        loaded = null;
+        if (!entry)
+            return;
+        try {
+            yield (yield entry.session).release();
+        }
+        catch (_a) {
+            // never loaded, nothing to release
+        }
+    });
+}
 function load(modelDir) {
     var _a;
     if (loaded && loaded.dir === modelDir)

package/dist/envs.js

@@ -1,7 +1,4 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MODEL_PATH = exports.MIN_CONFIDENCE = exports.TIMEOUT_MS = exports.PROBE_MS = exports.AUDIOSOCKET_ADVERTISE_HOST = exports.AUDIOSOCKET_BIND_ADDR = exports.AUDIOSOCKET_PORT = exports.AGI_PORT = void 0;
 /**
@@ -22,11 +19,9 @@ exports.MODEL_PATH = exports.MIN_CONFIDENCE = exports.TIMEOUT_MS = exports.PROBE
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-const path_1 = require("path");
-const dotenv_1 = __importDefault(require("dotenv"));
-if (process.env.NODE_ENV === "development") {
-    dotenv_1.default.config({ path: (0, path_1.join)(__dirname, "..", "..", "..", ".env") });
-}
+// The sidecar's settings come from its container environment (AMD_*), which
+// the deployment sets. It never loads a .env file, not even in development
+// (fix-config-and-placement-gaps).
 const e = process.env;
 // A malformed AMD_* number must not silently break the probe (NaN
 // thresholds disable the deadline / confidence gate), so fall back to the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonoster/amd",
-  "version": "0.26.0",
+  "version": "0.30.0",
   "description": "Standalone answering-machine-detection sidecar for the Fonoster platform",
   "author": "Pedro Sanders <psanders@fonoster.com>",
   "homepage": "https://github.com/fonoster/fonoster#readme",
@@ -19,10 +19,10 @@
     "start:dev": "nodemon --exec tsx --watch src src/server.ts"
   },
   "dependencies": {
-    "@fonoster/common": "^0.26.0",
-    "@fonoster/logger": "^0.26.0",
-    "@fonoster/streams": "^0.26.0",
-    "@fonoster/types": "^0.26.0",
+    "@fonoster/common": "^0.30.0",
+    "@fonoster/logger": "^0.30.0",
+    "@fonoster/streams": "^0.30.0",
+    "@fonoster/types": "^0.30.0",
     "onnxruntime-node": "1.21.1",
     "uuid": "^11.0.3"
   },
@@ -43,5 +43,5 @@
   "bugs": {
     "url": "https://github.com/fonoster/fonoster/issues"
   },
-  "gitHead": "d14f414d791a33f92e8c4225f7e462abc440a142"
+  "gitHead": "b59b06a3ef325abe3f188c0fb87cc22d50ed5471"
 }