oomi-ai 0.2.28 → 0.2.29

package/README.md

@@ -4,7 +4,7 @@ OpenClaw channel plugin and bridge tooling for Oomi managed chat and voice.
 
 ## Current Focus
 
-`0.2.28` keeps the persona automation lane and adds a usable local managed-voice validation path:
+`0.2.29` keeps the persona automation lane, adds a usable local managed-voice validation path, and makes bridge logging quiet by default in production:
 - WebSpatial-based persona scaffolding for generated Oomi apps
 - a high-level `oomi personas create-managed` command for agent-driven persona creation
 - device-authenticated persona runtime registration and job callbacks
@@ -141,7 +141,7 @@ That bridge:
 - preserves or synthesizes `idempotencyKey` for `chat.send`
 - keeps voice-session faults from poisoning normal provider health where possible
 
-This is the part of the package most likely to matter when debugging voice turn failures.
+This is the part of the package most likely to matter when debugging voice turn failures.
 
 For managed cloned-voice replies, the canonical contract is:
 - visible assistant `content` stays user-facing
@@ -150,6 +150,18 @@ For managed cloned-voice replies, the canonical contract is:
 
 The backend cloned-voice path is intentionally strict. If `metadata.spoken` does not reach Oomi, backend TTS fails instead of speaking a flat fallback voice.
 
+## Bridge Logging
+
+The bridge is intentionally quiet by default in production so normal deploys do not spam logs with frame-level transport noise.
+
+To enable verbose bridge tracing temporarily, set:
+
+```bash
+OOMI_BRIDGE_DEBUG=1
+```
+
+With that flag enabled, the bridge will emit low-level session, frame, and spoken-metadata debug logs again.
+
 ## Local TTS Validation
 
 If you are developing this package inside the Oomi repo, you can now validate the managed voice path locally before publishing.

package/bin/oomi-ai.js

@@ -54,6 +54,17 @@ const DEBUG_PROVIDER_ENV_KEYS = [
 ];
 const DEVICE_IDENTITY_PATH = path.join(os.homedir(), '.openclaw', 'identity', 'device.json');
 const ED25519_SPKI_PREFIX = Buffer.from('302a300506032b6570032100', 'hex');
+const BRIDGE_DEBUG_ENABLED = process.env.OOMI_BRIDGE_DEBUG === '1';
+
+function bridgeDebugLog(...args) {
+  if (!BRIDGE_DEBUG_ENABLED) return;
+  console.log(...args);
+}
+
+function bridgeDebugWarn(...args) {
+  if (!BRIDGE_DEBUG_ENABLED) return;
+  console.warn(...args);
+}
 
 function parsePositiveInteger(value, fallback) {
   const num = Number(value);
@@ -2960,7 +2971,7 @@ async function startOpenclawBridge(flags) {
       : null;
 
   if (personaJobPollEnabled && brokerHttp && deviceToken) {
-    console.log('[persona-jobs] polling filtered control queue for persona_job messages.');
+    bridgeDebugLog('[persona-jobs] polling filtered control queue for persona_job messages.');
   } else if (personaJobPollEnabled) {
     console.warn('[persona-jobs] disabled because broker HTTP URL or device token is unavailable.');
   }
@@ -3195,9 +3206,9 @@ async function startOpenclawBridge(flags) {
       classifyBridgeFailure({ reason: 'connection closed without classified error' });
     const delayMs = computeReconnectDelayMs(reconnectState.attempt, failure.baseDelayMs);
 
-    console.warn(
-      `[bridge] reconnect scheduled in ${delayMs}ms (attempt ${reconnectState.attempt}, class=${failure.failureClass}, code=${failure.errorCode})`
-    );
+    bridgeDebugWarn(
+      `[bridge] reconnect scheduled in ${delayMs}ms (attempt ${reconnectState.attempt}, class=${failure.failureClass}, code=${failure.errorCode})`
+    );
 
     updateBridgeStatus({
       status: 'reconnecting',
@@ -3323,7 +3334,7 @@ async function startOpenclawBridge(flags) {
         }
         const result = forwardFrameToSession(sessionBridge, prepared.frameText);
         if (result === 'queued') {
-          console.log(`[bridge] client.frame queued after challenge ${sessionId}`);
+          bridgeDebugLog(`[bridge] client.frame queued after challenge ${sessionId}`);
           if (requestMeta) {
             startPendingRequestTimeout(brokerSocket, sessionId, sessionBridge, requestMeta);
           }
@@ -3337,7 +3348,7 @@ async function startOpenclawBridge(flags) {
             });
           }
         } else if (result === 'dropped') {
-          console.log(`[bridge] client.frame dropped after challenge ${sessionId}`);
+          bridgeDebugLog(`[bridge] client.frame dropped after challenge ${sessionId}`);
           incrementBridgeMetric('bridge_drop_count');
           if (requestMeta) {
             const pending = sessionBridge.pendingRequests instanceof Map
@@ -3369,7 +3380,7 @@ async function startOpenclawBridge(flags) {
             });
           }
         } else {
-          console.log(`[bridge] client.frame sent after challenge ${sessionId}`);
+          bridgeDebugLog(`[bridge] client.frame sent after challenge ${sessionId}`);
           if (requestMeta) {
             startPendingRequestTimeout(brokerSocket, sessionId, sessionBridge, requestMeta);
           }
@@ -3435,7 +3446,7 @@ async function startOpenclawBridge(flags) {
           clearTimeout(connectTimeout);
           connectTimeout = null;
         }
-        console.log(`[bridge] gateway.open ${sessionId}`);
+        bridgeDebugLog(`[bridge] gateway.open ${sessionId}`);
         flushSessionQueue(sessionBridge);
       });
 
@@ -3445,17 +3456,17 @@ async function startOpenclawBridge(flags) {
         if (spokenNormalized.changed) {
           frame = spokenNormalized.frameText;
           if (spokenNormalized.scope === 'voice') {
-            console.log(`[bridge] voice.spoken_metadata.${spokenNormalized.reason} ${sessionId} ${JSON.stringify({
+            bridgeDebugLog(`[bridge] voice.spoken_metadata.${spokenNormalized.reason} ${sessionId} ${JSON.stringify({
               before: spokenNormalized.summary,
               after: summarizeVoiceFrameContract(frame),
             })}`);
           }
         } else if (spokenNormalized.scope === 'voice' && spokenNormalized.summary.event === 'chat' && spokenNormalized.summary.state === 'final') {
-          console.log(`[bridge] voice.chat.final ${sessionId} ${JSON.stringify(spokenNormalized.summary)}`);
+          bridgeDebugLog(`[bridge] voice.chat.final ${sessionId} ${JSON.stringify(spokenNormalized.summary)}`);
         }
         const gatewayPayload = parseJsonPayload(frame);
         if (gatewayPayload?.event === 'connect.challenge') {
-          console.log(`[bridge] gateway.connect.challenge ${sessionId}`);
+          bridgeDebugLog(`[bridge] gateway.connect.challenge ${sessionId}`);
           const nonce =
             gatewayPayload.payload && typeof gatewayPayload.payload.nonce === 'string'
               ? gatewayPayload.payload.nonce.trim()
@@ -3601,9 +3612,9 @@ async function startOpenclawBridge(flags) {
         clearChallengeTimer(sessionBridge);
         const reasonText = reason ? reason.toString() : '';
         const closeMeta = classifyGatewayClose(code, reasonText);
-        console.log(
-          `[bridge] gateway.close ${sessionId} code=${String(code)}${reasonText ? ` reason=${reasonText}` : ''}`
-        );
+        bridgeDebugLog(
+          `[bridge] gateway.close ${sessionId} code=${String(code)}${reasonText ? ` reason=${reasonText}` : ''}`
+        );
         if (sessionBridge.pendingRequests instanceof Map) {
           for (const requestMeta of sessionBridge.pendingRequests.values()) {
             if (!requestMeta || typeof requestMeta !== 'object') continue;
@@ -3678,7 +3689,7 @@ async function startOpenclawBridge(flags) {
     };
 
     brokerSocket.on('open', () => {
-      console.log('[bridge] Connected to managed broker.');
+      bridgeDebugLog('[bridge] Connected to managed broker.');
       reconnectState.attempt = 0;
       reconnectState.lastFailure = null;
       if (actionCableMode) {
@@ -3795,14 +3806,14 @@ async function startOpenclawBridge(flags) {
       }
 
       if (payload.type === 'device.ready') {
-        console.log(`[bridge] Broker ready for device ${payload.deviceId || deviceId}.`);
+        bridgeDebugLog(`[bridge] Broker ready for device ${payload.deviceId || deviceId}.`);
         return;
       }
 
       if (payload.type === 'client.open') {
         const sessionId = String(payload.sessionId || '').trim();
         if (!sessionId) return;
-        console.log(`[bridge] client.open ${sessionId}`);
+        bridgeDebugLog(`[bridge] client.open ${sessionId}`);
         getOrCreateGatewaySession(sessionId);
         return;
       }
@@ -3812,9 +3823,9 @@ async function startOpenclawBridge(flags) {
         const frame = typeof payload.frame === 'string' ? payload.frame : '';
         if (!sessionId || !frame) return;
         if (classifyBridgeSessionScope(sessionId) === 'voice') {
-          console.log(`[bridge] client.frame ${sessionId} ${JSON.stringify(summarizeVoiceFrameContract(frame))}`);
+          bridgeDebugLog(`[bridge] client.frame ${sessionId} ${JSON.stringify(summarizeVoiceFrameContract(frame))}`);
         } else {
-          console.log(`[bridge] client.frame ${sessionId}`);
+          bridgeDebugLog(`[bridge] client.frame ${sessionId}`);
         }
         const sessionBridge = getOrCreateGatewaySession(sessionId);
         if (!sessionBridge) return;
@@ -3840,7 +3851,7 @@ async function startOpenclawBridge(flags) {
         });
         if (prepared.waitForChallenge) {
           queueConnectUntilChallenge(sessionId, sessionBridge, frame);
-          console.log(`[bridge] client.frame waiting for challenge ${sessionId}`);
+          bridgeDebugLog(`[bridge] client.frame waiting for challenge ${sessionId}`);
           if (requestMeta) {
             sendGatewayAck(brokerSocket, {
               sessionId,
@@ -3886,7 +3897,7 @@ async function startOpenclawBridge(flags) {
           requiresConnectAccepted: Boolean(requestMeta && requestMeta.method !== 'connect'),
         });
         if (result === 'waiting_for_connect') {
-          console.log(`[bridge] client.frame waiting for connect ${sessionId}`);
+          bridgeDebugLog(`[bridge] client.frame waiting for connect ${sessionId}`);
           if (requestMeta) {
             sendGatewayAck(brokerSocket, {
               sessionId,
@@ -3899,7 +3910,7 @@ async function startOpenclawBridge(flags) {
           return;
         }
         if (result === 'queued') {
-          console.log(`[bridge] client.frame queued ${sessionId}`);
+          bridgeDebugLog(`[bridge] client.frame queued ${sessionId}`);
           if (requestMeta) {
             startPendingRequestTimeout(brokerSocket, sessionId, sessionBridge, requestMeta);
           }
@@ -3913,7 +3924,7 @@ async function startOpenclawBridge(flags) {
             });
           }
         } else if (result === 'dropped') {
-          console.log(`[bridge] client.frame dropped (socket not open) ${sessionId}`);
+          bridgeDebugLog(`[bridge] client.frame dropped (socket not open) ${sessionId}`);
           incrementBridgeMetric('bridge_drop_count');
           if (requestMeta) {
             const pending = sessionBridge.pendingRequests instanceof Map
@@ -3959,7 +3970,7 @@ async function startOpenclawBridge(flags) {
 
       if (payload.type === 'client.close') {
         const sessionId = String(payload.sessionId || '').trim();
-        console.log(`[bridge] client.close ${sessionId}`);
+        bridgeDebugLog(`[bridge] client.close ${sessionId}`);
         const sessionBridge = activeGatewaySockets.get(sessionId);
         if (sessionBridge && sessionBridge.socket) {
           clearChallengeTimer(sessionBridge);
@@ -3982,7 +3993,7 @@ async function startOpenclawBridge(flags) {
         actionCableHeartbeat = null;
       }
       const reasonText = reason ? reason.toString() : '';
-      console.log(`[bridge] Broker disconnected (${code}) ${reasonText}`);
+      bridgeDebugLog(`[bridge] Broker disconnected (${code}) ${reasonText}`);
       incrementBridgeMetric('bridge_disconnect_count');
       for (const [sessionId, sessionBridge] of activeGatewaySockets.entries()) {
         clearChallengeTimer(sessionBridge);

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "oomi-ai",
   "name": "Oomi Channel Plugin",
   "description": "Managed Oomi channel integration for OpenClaw.",
-  "version": "0.2.28",
+  "version": "0.2.29",
   "author": "Oomi",
   "license": "MIT",
   "openclawVersion": ">=0.5.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oomi-ai",
-  "version": "0.2.28",
+  "version": "0.2.29",
   "description": "Oomi OpenClaw channel plugin and bridge tooling",
   "bin": {
     "oomi": "bin/oomi-ai.js"