@openbrt/audioctl 0.1.9 → 0.1.10

package/README.md

@@ -113,7 +113,9 @@ audioctl led flash amber --repeat 1
 `feedback effect` is for continuous device-local effects such as beat/pulse or
 breathing animations. It sends one control message; the timing loop belongs on
 the device, not in the agent process. `feedback clear` stops the current
-device-local effect and clears the indicator.
+device-local effect and clears the indicator. Beat-style names such as
+`music_beat` are treated as effects, not as a signal that should be published in
+a loop.
 
 Physical keys/touch surfaces are reported as VM capabilities such as
 `input.touch.read`, `input.gesture.read`, and `input.button.bind`. A VM app can

package/bin/audioctl.mjs

@@ -329,12 +329,12 @@ async function commandFeedback(values) {
     "playing",
     "paused",
     "wake",
-    "music_beat",
     "volume_step_up",
     "volume_step_down",
     "button_press",
     "button_long_press",
   ]);
+  const shorthandEffects = new Set(["music_beat", "pulse", "breathing"]);
   const options = parseOptions(values.slice(1), {
     credentials: credentialsPath(),
     timeout: 12,
@@ -345,11 +345,26 @@ async function commandFeedback(values) {
   let command = subcommand;
   const payload = {};
   if (!command) throw new Error("feedback_requires_subcommand");
-  if (shorthandSignals.has(command)) {
+  if (shorthandEffects.has(command)) {
+    payload.effect = command;
+    payload.bpm = options.bpm;
+    payload.color = options.color;
+    payload.alpha = options.alpha;
+    command = "effect";
+  } else if (shorthandSignals.has(command)) {
     payload.semantic = command;
     command = "signal";
   } else if (command === "signal") {
-    payload.semantic = options._[0];
+    const semantic = String(options._[0] || "").replace(/-/gu, "_").toLowerCase();
+    if (shorthandEffects.has(semantic)) {
+      payload.effect = semantic;
+      payload.bpm = options.bpm;
+      payload.color = options.color;
+      payload.alpha = options.alpha;
+      command = "effect";
+    } else {
+      payload.semantic = options._[0];
+    }
   } else if (command === "flash") {
     payload.color = options._[0] || options.color;
     payload.repeat = options.repeat;

package/lib/index.mjs

@@ -71,7 +71,6 @@ export const FEEDBACK_SIGNALS = Object.freeze([
   "playing",
   "paused",
   "wake",
-  "music_beat",
   "volume_step_up",
   "volume_step_down",
   "button_press",
@@ -425,6 +424,12 @@ export function normalizeFeedbackCommand(command, options = {}) {
         options.value ||
         "button_press",
     ).replace(/-/gu, "_").toLowerCase();
+    if (FEEDBACK_EFFECTS.includes(semantic)) {
+      return normalizeFeedbackCommand("effect", {
+        ...options,
+        effect: semantic,
+      });
+    }
     if (!/^[a-z0-9_.:]{1,64}$/u.test(semantic)) {
       throw new Error("feedback_signal_invalid");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openbrt/audioctl",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Generic WeClawBot audio/voice endpoint control CLI and AI-agent plugin.",
   "type": "module",
   "license": "MIT",