@mclean-capital/neura 3.1.0 → 3.2.0

package/README.md

@@ -21,28 +21,15 @@ Requires **Node.js >= 22**.
 | Platform                            | Supported |
 | ----------------------------------- | :-------: |
 | macOS — Apple Silicon (M1/M2/M3/M4) |    Yes    |
-| macOS — Intel (x64)                 |  **No**   |
+| macOS — Intel (x64)                 |    Yes    |
 | Windows — x64 / arm64               |    Yes    |
 | Linux — x64 / arm64                 |    Yes    |
 
-**Intel Macs are not supported.** Neura's wake-word detector runs on
-`onnxruntime-node`, and upstream dropped Intel Mac (`darwin/x64`) binaries
-starting with version 1.24. Because voice is a required feature — not an
-optional one — `npm install -g @mclean-capital/neura` will appear to
-succeed but core will crash at startup with
-`Cannot find module '../bin/napi-v6/darwin/x64/onnxruntime_binding.node'`.
-
-If you're on an Apple Silicon Mac but see the `darwin/x64` error, you've
-installed the Intel build of Node under Rosetta. Reinstall Node as arm64:
-
-```bash
-nvm uninstall <version>
-arch -arm64 nvm install <version>
-```
-
-For true Intel Macs, there's no workaround short of self-building against
-an older onnxruntime-node — we recommend running Neura on a supported
-machine instead.
+All platforms are fully supported. On Intel Macs, native binaries for
+ONNX runtime and PortAudio (decibri) are unavailable, so Neura
+automatically falls back to WASM-based wake-word detection and
+`@picovoice/pvrecorder-node` for mic capture. No manual configuration
+needed — the fallbacks are transparent.
 
 ## Quick start
 
@@ -134,7 +121,8 @@ After this one-time step, `neura update` works normally for all future upgrades.
 
 `neura listen` uses optional native audio dependencies:
 
-- **`decibri`** — microphone capture via PortAudio
+- **`decibri`** (optional) — microphone capture via PortAudio (arm64 prebuilts)
+- **`@picovoice/pvrecorder-node`** — microphone capture fallback (prebuilts for all platforms incl. Intel Mac)
 - **`speaker`**, **`@picovoice/pvspeaker-node`**, or **`sox`** — speaker playback
 
 These are marked as `optionalDependencies` so `npm install -g @mclean-capital/neura` won't fail if your platform lacks the required build tools. If audio init fails at runtime, `neura listen` will print install instructions for your platform.

package/core/version.txt

@@ -1 +1 @@
-3.1.0
+3.2.0

package/dist/audio/capture.d.ts

@@ -1,8 +1,11 @@
 /**
  * Audio capture abstraction for mic input.
  *
- * Primary: decibri (PortAudio, prebuilt arm64 binaries)
- * The implementation lazy-loads decibri so `neura chat` works without it.
+ * Primary:  decibri (PortAudio, prebuilt arm64 binaries, 24kHz native)
+ * Fallback: @picovoice/pvrecorder-node (prebuilt for all platforms incl.
+ *           Intel Mac, 16kHz fixed — resampled to 24kHz before emission)
+ *
+ * The implementation lazy-loads both so `neura chat` works without either.
  */
 export interface AudioCapture {
     start(): void;

package/dist/audio/capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/audio/capture.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,YAAY;IAC3B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9C;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC,CAoChE;AAED,yCAAyC;AACzC,wBAAsB,gBAAgB,IAAI,OAAO,CAC/C;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,EAAE,CACtD,CAOA"}
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/audio/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,YAAY;IAC3B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9C;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC,CAmBhE;AAED,yCAAyC;AACzC,wBAAsB,gBAAgB,IAAI,OAAO,CAC/C;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,EAAE,CACtD,CAmBA"}

package/dist/audio/capture.js

@@ -1,52 +1,148 @@
 /**
  * Audio capture abstraction for mic input.
  *
- * Primary: decibri (PortAudio, prebuilt arm64 binaries)
- * The implementation lazy-loads decibri so `neura chat` works without it.
+ * Primary:  decibri (PortAudio, prebuilt arm64 binaries, 24kHz native)
+ * Fallback: @picovoice/pvrecorder-node (prebuilt for all platforms incl.
+ *           Intel Mac, 16kHz fixed — resampled to 24kHz before emission)
+ *
+ * The implementation lazy-loads both so `neura chat` works without either.
  */
 import { audioInstallHint } from './install-hints.js';
 export async function createAudioCapture() {
+    // 1. Try decibri (native 24kHz, event-driven)
     try {
-        const { default: Decibri } = await import('decibri');
-        let onData = null;
-        let mic = null;
-        return {
-            get onData() {
-                return onData;
-            },
-            set onData(handler) {
-                onData = handler;
-            },
-            start() {
-                mic = new Decibri({ sampleRate: 24000, channels: 1, format: 'int16' });
-                mic.on('data', (chunk) => {
-                    if (onData) {
-                        onData(chunk.toString('base64'));
-                    }
-                });
-                // Prevent unhandled 'error' from crashing the process
-                mic.on('error', (err) => {
-                    console.error(`Mic error: ${err.message}`);
-                });
-            },
-            stop() {
-                mic?.stop();
-                mic = null;
-            },
-        };
+        return await createDecibriCapture();
     }
     catch {
-        throw new Error('Mic capture requires the "decibri" package.\n' + audioInstallHint('decibri'));
+        // decibri unavailable — try pvrecorder
     }
+    // 2. Try pvrecorder (16kHz polling, resampled to 24kHz)
+    try {
+        return await createPvRecorderCapture();
+    }
+    catch {
+        // pvrecorder also unavailable
+    }
+    throw new Error('Mic capture requires "decibri" or "@picovoice/pvrecorder-node".\n' +
+        audioInstallHint('decibri'));
 }
 /** List available audio input devices */
 export async function listInputDevices() {
+    // Try decibri first (richer device info)
     try {
         const { default: Decibri } = await import('decibri');
         return Decibri.devices();
     }
     catch {
-        return [];
+        // fall through
+    }
+    // Try pvrecorder (returns string[] of device names)
+    try {
+        const { PvRecorder } = await import('@picovoice/pvrecorder-node');
+        const names = PvRecorder.getAvailableDevices();
+        return names.map((name, index) => ({ index, name, isDefault: index === 0 }));
+    }
+    catch {
+        // fall through
+    }
+    return [];
+}
+// ── Decibri backend ─────────────────────────────────────────────
+async function createDecibriCapture() {
+    const { default: Decibri } = await import('decibri');
+    let onData = null;
+    let mic = null;
+    return {
+        get onData() {
+            return onData;
+        },
+        set onData(handler) {
+            onData = handler;
+        },
+        start() {
+            mic = new Decibri({ sampleRate: 24000, channels: 1, format: 'int16' });
+            mic.on('data', (chunk) => {
+                if (onData) {
+                    onData(chunk.toString('base64'));
+                }
+            });
+            mic.on('error', (err) => {
+                console.error(`Mic error: ${err.message}`);
+            });
+        },
+        stop() {
+            mic?.stop();
+            mic = null;
+        },
+    };
+}
+// ── PvRecorder backend ──────────────────────────────────────────
+/** Frame length in samples at 16kHz (~32ms per frame) */
+const PV_FRAME_LENGTH = 512;
+async function createPvRecorderCapture() {
+    const { PvRecorder } = await import('@picovoice/pvrecorder-node');
+    let onData = null;
+    let recorder = null;
+    let running = false;
+    async function pollLoop() {
+        while (running && recorder) {
+            try {
+                const frame = await recorder.read(); // Int16Array, 16kHz
+                if (!running || !onData)
+                    continue;
+                const resampled = resample16kTo24k(frame);
+                onData(resampled.toString('base64'));
+            }
+            catch {
+                // recorder was stopped or released mid-read
+                break;
+            }
+        }
+    }
+    return {
+        get onData() {
+            return onData;
+        },
+        set onData(handler) {
+            onData = handler;
+        },
+        start() {
+            recorder = new PvRecorder(PV_FRAME_LENGTH);
+            running = true;
+            recorder.start();
+            void pollLoop();
+        },
+        stop() {
+            running = false;
+            if (recorder) {
+                try {
+                    recorder.stop();
+                    recorder.release();
+                }
+                catch {
+                    /* already released */
+                }
+                recorder = null;
+            }
+        },
+    };
+}
+/**
+ * Resample Int16 PCM from 16kHz to 24kHz using linear interpolation.
+ * Returns a Buffer of Int16LE samples ready for base64 encoding.
+ */
+function resample16kTo24k(input) {
+    const ratio = 16000 / 24000; // 0.6667
+    const outputLen = Math.ceil(input.length / ratio);
+    const output = Buffer.alloc(outputLen * 2);
+    for (let i = 0; i < outputLen; i++) {
+        const srcIdx = i * ratio;
+        const lo = Math.floor(srcIdx);
+        const hi = Math.min(lo + 1, input.length - 1);
+        const frac = srcIdx - lo;
+        const sample = Math.round(input[lo] * (1 - frac) + input[hi] * frac);
+        output.writeInt16LE(Math.max(-32768, Math.min(32767, sample)), i * 2);
     }
+    return output;
 }
 //# sourceMappingURL=capture.js.map

package/dist/audio/capture.js.map

@@ -1 +1 @@
-{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/audio/capture.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAQtD,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAErD,IAAI,MAAM,GAAyC,IAAI,CAAC;QACxD,IAAI,GAAG,GAAwC,IAAI,CAAC;QAEpD,OAAO;YACL,IAAI,MAAM;gBACR,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,IAAI,MAAM,CAAC,OAA6C;gBACtD,MAAM,GAAG,OAAO,CAAC;YACnB,CAAC;YAED,KAAK;gBACH,GAAG,GAAG,IAAI,OAAO,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;gBACvE,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;oBAC/B,IAAI,MAAM,EAAE,CAAC;wBACX,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;oBACnC,CAAC;gBACH,CAAC,CAAC,CAAC;gBACH,sDAAsD;gBACtD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;oBAC7B,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC7C,CAAC,CAAC,CAAC;YACL,CAAC;YAED,IAAI;gBACF,GAAG,EAAE,IAAI,EAAE,CAAC;gBACZ,GAAG,GAAG,IAAI,CAAC;YACb,CAAC;SACF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,+CAA+C,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;IACjG,CAAC;AACH,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAC,KAAK,UAAU,gBAAgB;IAGpC,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC,OAAO,EAA2D,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/audio/capture.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mclean-capital/neura",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Neura — CLI for installing and managing the Neura AI assistant core service. Includes text chat and voice listen clients.",
   "keywords": [
     "neura",
@@ -53,6 +53,7 @@
     "@electric-sql/pglite": "0.4.3",
     "@inquirer/prompts": "^7",
     "@mariozechner/pi-coding-agent": "^0.66.1",
+    "@picovoice/pvrecorder-node": "^1.2.8",
     "chalk": "^5",
     "chokidar": "^5.0.0",
     "commander": "^13",