pi-web-voice 0.1.1 → 0.1.3

package/bin/pi-web-voice.js

@@ -21,7 +21,16 @@ const hook = path.join(__dirname, "..", "hook.cjs");
 // `pi-web-voice doctor [file.wav]` checks the speech backend and exits.
 if (args[0] === "doctor") {
   const { doctor } = require("../lib/doctor.cjs");
-  doctor(args.slice(1)).then((code) => process.exit(code));
+  doctor(args.slice(1)).then((code) => {
+    // Setting the code rather than calling process.exit lets the HTTP
+    // connection finish closing. Forcing an exit mid-teardown trips a libuv
+    // assertion on Windows: !(handle->flags & UV_HANDLE_CLOSING).
+    process.exitCode = code;
+    // Keep-alive sockets can still hold the loop open for a few seconds after
+    // the answer is in hand. This timer does not itself keep the process
+    // alive, and by the time it fires nothing is mid-close.
+    setTimeout(() => process.exit(code), 750).unref();
+  });
   return;
 }
 

package/lib/doctor.cjs

@@ -68,6 +68,9 @@ function describe(config) {
 
 /** Turns provider failures into the thing that is actually wrong. */
 function diagnose(message) {
+  if (/cannot go in an HTTP header|ByteString/i.test(message)) {
+    return "the key in ~/.pi/agent/voice.env is not a real key yet";
+  }
   if (/\b401\b|Unauthorized|Access denied/i.test(message)) {
     return "the key is wrong, or it belongs to a different resource";
   }

package/lib/providers.cjs

@@ -27,6 +27,22 @@ function audioBlob(audio) {
   return new Blob([audio], { type: "audio/wav" });
 }
 
+/**
+ * Credentials travel in HTTP headers, which only carry bytes. A key that is
+ * still the placeholder, or that picked up a stray quote or newline, would
+ * otherwise surface as "Cannot convert argument to a ByteString", which says
+ * nothing about what to go and fix.
+ */
+function checkKey(key, variable) {
+  if (!key) throw new Error(`${variable} is not set in ~/.pi/agent/voice.env`);
+  if (!/^[\x21-\x7e]+$/.test(key)) {
+    throw new Error(
+      `${variable} contains characters that cannot go in an HTTP header — ` +
+        `is the placeholder still in ~/.pi/agent/voice.env?`,
+    );
+  }
+}
+
 /**
  * Azure AI Speech — fast transcription, including MAI-Transcribe-2.
  * Phrase list gives real decode-time keyword biasing, and leaving `locales`
@@ -34,7 +50,8 @@ function audioBlob(audio) {
  */
 async function azureSpeech(audio, config, terms) {
   const { endpoint, key, model, apiVersion, style } = config.azureSpeech;
-  if (!endpoint || !key) throw new Error("azure-speech needs AZURE_SPEECH_ENDPOINT and AZURE_SPEECH_KEY");
+  if (!endpoint) throw new Error("azure-speech needs AZURE_SPEECH_ENDPOINT");
+  checkKey(key, "AZURE_SPEECH_KEY");
 
   const url = `${endpoint}/speechtotext/transcriptions:transcribe?api-version=${encodeURIComponent(apiVersion)}`;
 
@@ -102,7 +119,8 @@ function vocabularyPrompt(terms) {
  */
 async function azureOpenAI(audio, config, terms, languages) {
   const { endpoint, key, deployment, apiVersion } = config.azureOpenAI;
-  if (!endpoint || !key) throw new Error("azure-openai needs AZURE_OPENAI_ENDPOINT and AZURE_OPENAI_API_KEY");
+  if (!endpoint) throw new Error("azure-openai needs AZURE_OPENAI_ENDPOINT");
+  checkKey(key, "AZURE_OPENAI_API_KEY");
 
   const explicit = /\/audio\/transcriptions/.test(endpoint);
   const url = explicit
@@ -144,6 +162,7 @@ async function azureOpenAI(audio, config, terms, languages) {
 async function openAICompatible(audio, config, terms) {
   const { baseUrl, key, model } = config.openai;
   if (!baseUrl) throw new Error("openai needs PI_VOICE_OPENAI_BASE_URL");
+  if (key) checkKey(key, "OPENAI_API_KEY");
 
   const form = new FormData();
   form.append("file", audioBlob(audio), "clip.wav");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-web-voice",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Voice input for pi-web. A NODE_OPTIONS hook that injects a microphone button into the chat composer and transcribes speech with Azure AI Speech, Azure OpenAI, or any OpenAI-compatible endpoint. No fork, no patching, no rebuild.",
   "keywords": [
     "pi",