@recallai/desktop-sdk 2.0.37 → 2.0.38

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+### 2.0.38 [patch] (MacOS+Windows) - 2026-10-14
+- Add telemetryMode field to init method
+- Fix for compliance messaging failing to send for Zoom Desktop on macOS
+- Fix for focus issue with compliance messaging for Zoom Desktop on macOS
+- Fix for meeting detection for Teams Desktop v26246+ on macOS
+- Fix for title extraction for Zoom Desktop on macOS
+
 ### 2.0.37 [patch] (MacOS+Windows) - 2026-10-08
 - Fix Arc meeting detection
 - Add anonymizeLogging field to init method

package/index.d.ts

@@ -111,12 +111,7 @@ export interface RecallAiSdkConfig {
      * Ignored on Windows, where these permission flows are unnecessary.
      */
     acquirePermissionsOnStartup?: Exclude<Permission, 'teams-automation' | 'browser-automation'>[];
-    /**
-     * Anonymizes debug logging when enabled. (Default: false).
-     *
-     * This will make debugging issues harder, so please keep that in mind before enabling.
-     * This setting may be required for data privacy.
-     */
+    telemetryMode?: 'full' | 'limited' | 'off';
     anonymizeLogging?: boolean;
     [key: string]: any;
 }

package/index.js

@@ -78,6 +78,7 @@ const listeners = [];
 const lastErrorOut = [];
 const pendingCommands = {};
 let lastOptions;
+let telemetryMode = 'off';
 let remainingAutomaticRestarts = 10;
 let unexpectedShutdown = false;
 let exiting = false;
@@ -111,12 +112,17 @@ function getPackageVersion() {
 process.on("exit", () => {
     exiting = true;
     if (proc && !proc.killed) {
-        console.warn("Desktop SDK received exit signal and is still running, killing the process.");
+        if (telemetryMode !== 'off') {
+            console.warn("Desktop SDK received exit signal and is still running, killing the process.");
+        }
         proc.kill();
         proc = null;
     }
 });
 function appendError(error) {
+    if (telemetryMode !== 'full') {
+        return;
+    }
     lastErrorOut.push(error);
     if (lastErrorOut.length > 100) {
         lastErrorOut.shift();
@@ -131,7 +137,7 @@ function flushLogBuffer() {
     // and know that Nick and Tucker spent at least 10 minutes debating this
     for (const idx in buf) {
         const { level, log, echo } = buf[idx];
-        doLog(level, [log], echo);
+        doLog(level, { full: () => [log] }, echo);
     }
 }
 function isPlainObject(value) {
@@ -175,8 +181,16 @@ function sortedStringify(value, replacer, space) {
     }
     return JSON.stringify(normalize(value), replacer, space);
 }
-async function doLog(level, log, echo = true) {
+async function doLog(level, messages, echo = true) {
+    if (telemetryMode === 'off') {
+        return;
+    }
+    const render = telemetryMode === 'limited' && messages.limited !== true ? messages.limited : messages.full;
+    if (!render) {
+        return;
+    }
     try {
+        const log = render();
         const levelMap = {
             "info": "log",
             "warning": "warn",
@@ -186,6 +200,9 @@ async function doLog(level, log, echo = true) {
             const consoleMethod = console[levelMap[level] ?? "log"];
             consoleMethod(...log);
         }
+        if (telemetryMode === 'limited') {
+            return;
+        }
         const logPayload = {
             log: log.join(" "),
             level: level,
@@ -201,25 +218,27 @@ async function doLog(level, log, echo = true) {
             delete logBuffer[idx];
         }
     }
-    catch (e) {
+    catch {
         if (proc?.exitCode === 0 || exiting) {
             return;
         }
-        console.error("Failed to send log to Desktop SDK", e.stack, e.message);
+        if (telemetryMode === 'full' || telemetryMode === 'limited') {
+            console.error("Failed to send log to Desktop SDK");
+        }
     }
 }
 function log(...log) {
-    doLog("info", log);
+    doLog("info", { full: () => log });
 }
 function logWarning(...log) {
-    doLog("warning", log);
+    doLog("warning", { full: () => log });
 }
 function logError(...log) {
-    doLog("error", log);
+    doLog("error", { full: () => log });
 }
 function emitEvent(type, payload) {
     if (type !== "upload-progress" && type !== "realtime-event" && type !== "log") {
-        doLog("info", ["Receiving event: " + type + " | " + sortedStringify(payload)], false);
+        doLog("info", { full: () => ["Receiving event: " + type + " | " + sortedStringify(payload)] }, false);
     }
     for (const listener of listeners) {
         if (listener.type === type) {
@@ -315,7 +334,7 @@ function flushPendingStdinWrites() {
                     activeDrainWriteSequence = null;
                     waitingForStdinDrain = false;
                     flushingPendingStdinWrites = false;
-                    if (drainStartMs !== null && drainStartIso) {
+                    if (telemetryMode === 'full' && drainStartMs !== null && drainStartIso) {
                         const drainStopIso = new Date(drainStopMs).toISOString();
                         const durationMs = drainStopMs - drainStartMs;
                         void enqueueCommand("log", {
@@ -326,10 +345,18 @@ function flushPendingStdinWrites() {
                             if (proc?.exitCode === 0 || exiting) {
                                 return;
                             }
-                            console.error("Failed to enqueue stdin drain log", error.stack, error.message);
+                            if (telemetryMode === 'full') {
+                                console.error("Failed to enqueue stdin drain log", error.stack, error.message);
+                            }
                         });
                         return;
                     }
+                    if (telemetryMode === 'limited' && drainStartMs !== null) {
+                        void doLog("info", {
+                            full: () => [],
+                            limited: () => [`stdin drain completed | durationMs=${drainStopMs - drainStartMs} | blockedWriteSequence=${drainWriteSequence ?? "unknown"}`]
+                        });
+                    }
                     flushPendingStdinWrites();
                 });
                 return;
@@ -383,7 +410,7 @@ function enqueueCommand(command, params = {}, options = {}) {
         const payloadStr = JSON.stringify(payload);
         enqueueStdinWrite({ command, commandId, data: payloadStr + "\n", writeSequence }, options.front ?? false);
         if (!options.suppressSendLog && command !== "log") {
-            doLog("info", [`Sending command [${writeSequence}]: ` + payloadStr], false);
+            doLog("info", { full: () => [`Sending command [${writeSequence}]: ` + payloadStr] }, false);
         }
     });
 }
@@ -394,7 +421,10 @@ function startProcess() {
     }
     const exe_path = exe_paths.find(fs.existsSync);
     if (!exe_path) {
-        logError(`Desktop SDK: Couldn't launch! This is likely an issue with the build tool you're using.`);
+        void doLog("error", {
+            full: () => ["Desktop SDK: Couldn't launch! This is likely an issue with the build tool you're using."],
+            limited: true
+        });
         for (const exe_path of exe_paths) {
             logError("Tried:", exe_path);
         }
@@ -442,7 +472,7 @@ function startProcess() {
             fs.mkdirSync(gst_dump_dir);
         }
         catch (e) {
-            logError("Failed to create gst dump dir:", String(e));
+            void doLog("error", { full: () => ["Failed to create gst dump dir:", String(e)] });
         }
     }
     // The diarization debug dashboard parses smart_annotator's per-word
@@ -465,6 +495,13 @@ function startProcess() {
             // MallocStackLogging: "1",
             // MallocStackLoggingNoCompact: "1",
             ...envExtra,
+            RECALL_DSDK_TELEMETRY_MODE: telemetryMode,
+            ...(telemetryMode !== 'full' ? {
+                GST_DEBUG: "0",
+                GST_RECALL_DEBUG: "0",
+                GST_DEBUG_DUMP_DOT_DIR: undefined,
+                RUST_BACKTRACE: "0",
+            } : {}),
         }
     });
     const currentProc = proc;
@@ -473,7 +510,12 @@ function startProcess() {
             return;
         }
         // Do not use logError here: it sends a command through this same stdin.
-        console.error(`Desktop SDK: stdin stream error: ${error.stack ?? error.message}`);
+        if (telemetryMode === 'full') {
+            console.error(`Desktop SDK: stdin stream error: ${error.stack ?? error.message}`);
+        }
+        else if (telemetryMode === 'limited') {
+            console.error("Desktop SDK: stdin stream error");
+        }
         resetPendingStdinWrites();
         flushPendingCommands(new Error(`Desktop SDK stdin error: ${error.message}`));
         if (currentProc.exitCode === null && !currentProc.killed) {
@@ -515,11 +557,14 @@ function startProcess() {
                 }
             }
             catch (err) {
-                logError("Desktop SDK: Failed to parse incoming data:", String(err));
+                void doLog("error", {
+                    full: () => ["Desktop SDK: Failed to parse incoming data:", String(err)],
+                    limited: () => ["Desktop SDK: Failed to parse incoming data"]
+                });
             }
         }
         else {
-            if (process.env.RECALLAI_DESKTOP_SDK_DEV) {
+            if (telemetryMode === 'full' && process.env.RECALLAI_DESKTOP_SDK_DEV) {
                 console.log(line);
             }
         }
@@ -528,7 +573,7 @@ function startProcess() {
     rlStdout.on('line', onLine);
     rlStderr.on('line', (line) => {
         appendError(line);
-        if (process.env.RECALLAI_DESKTOP_SDK_DEV) {
+        if (telemetryMode === 'full' && process.env.RECALLAI_DESKTOP_SDK_DEV) {
             console.error(line);
         }
     });
@@ -549,7 +594,10 @@ function startProcess() {
             type: 'process',
             message: `The Desktop SDK server process has failed to start or exited improperly.`
         });
-        logError(`Desktop SDK: Process error: ${error.message}`);
+        void doLog("error", {
+            full: () => [`Desktop SDK: Process error: ${error.message}`],
+            limited: () => ["Desktop SDK: Process error"]
+        });
     });
     proc.on('close', async (code, signal) => {
         if (proc !== currentProc) {
@@ -566,10 +614,12 @@ function startProcess() {
         rlStdout = null;
         rlStderr = null;
         if (code === 0 || signal === 'SIGINT' || signal === 'SIGTERM' || exiting) {
-            log(`Desktop SDK: Process closed with code ${code}, signal ${signal}, exiting ${exiting}`);
+            const message = `Desktop SDK: Process closed with code ${code}, signal ${signal}, exiting ${exiting}`;
+            void doLog("info", { full: () => [message], limited: true });
             return;
         }
-        logError(`Desktop SDK: Process exited with code ${code}, signal ${signal}, exiting ${exiting}`);
+        const message = `Desktop SDK: Process exited with code ${code}, signal ${signal}, exiting ${exiting}`;
+        void doLog("error", { full: () => [message], limited: true });
         emitEvent('error', {
             type: 'process',
             message: "The Desktop SDK server process exited unexpectedly."
@@ -577,10 +627,16 @@ function startProcess() {
         unexpectedShutdown = true;
         if (lastOptions.restartOnError && remainingAutomaticRestarts > 0) {
             remainingAutomaticRestarts--;
-            logError(`Automatically restarting Desktop SDK due to unexpected exit! Automatic restarts left: ${remainingAutomaticRestarts}`);
-            logError(`Last error output from Desktop SDK:\n${lastErrorOut.join("\n")}`);
+            const restartMessage = `Automatically restarting Desktop SDK due to unexpected exit! Automatic restarts left: ${remainingAutomaticRestarts}`;
+            void doLog("error", { full: () => [restartMessage], limited: true });
+            void doLog("error", { full: () => [`Last error output from Desktop SDK:\n${lastErrorOut.join("\n")}`] });
             lastErrorOut.length = 0;
-            doInit(lastOptions);
+            void doInit(lastOptions).catch((error) => {
+                void doLog("error", {
+                    full: () => ["Desktop SDK: Automatic restart failed:", String(error)],
+                    limited: () => ["Desktop SDK: Automatic restart failed"]
+                });
+            });
         }
     });
 }
@@ -590,7 +646,10 @@ function sendCommand(command, params = {}) {
 async function doInit(options) {
     startProcess();
     if (unexpectedShutdown) {
-        logError("Desktop SDK: Recovered from unexpected shutdown");
+        void doLog("error", {
+            full: () => ["Desktop SDK: Recovered from unexpected shutdown"],
+            limited: true
+        });
         unexpectedShutdown = false;
     }
     await sendCommand("init", { config: JSON.stringify(options) });
@@ -610,13 +669,30 @@ async function doInit(options) {
  * @see https://docs.recall.ai/docs/dsdk-supported-platforms
  */
 async function init(options) {
+    if (options.telemetryMode !== undefined && !['full', 'limited', 'off'].includes(options.telemetryMode)) {
+        throw new Error("telemetryMode must be full, limited, or off");
+    }
+    if (options.anonymizeLogging !== undefined && typeof options.anonymizeLogging !== 'boolean') {
+        throw new Error("anonymizeLogging must be a boolean");
+    }
+    if (proc && proc.exitCode === null) {
+        throw new Error("The Desktop SDK is already started; call shutdown before initializing again");
+    }
+    telemetryMode = options.anonymizeLogging === true ? 'off' : options.telemetryMode ?? 'full';
+    if (telemetryMode !== 'full') {
+        logBuffer = [];
+        logIndex = 0;
+        lastErrorOut.length = 0;
+    }
     if (process.platform !== "darwin" && process.platform !== "win32") {
         throw new Error(`Platform ${process.platform} is not supported by Desktop SDK`);
     }
     const { api_url, apiUrl, dev } = options;
     options.api_url = api_url ?? apiUrl ?? "https://api.recall.ai";
     if (!dev && (!options.api_url || !options.api_url.startsWith("https"))) {
-        throw new Error(`apiUrl must be an https url, got: ${options.api_url}`);
+        throw new Error(telemetryMode === 'full'
+            ? `apiUrl must be an https url, got: ${options.api_url}`
+            : "apiUrl must be an https url");
     }
     if (options.restartOnError === undefined) {
         options.restartOnError = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recallai/desktop-sdk",
-  "version": "2.0.37",
+  "version": "2.0.38",
   "description": "Recall Desktop SDK",
   "main": "./index.js",
   "types": "./index.d.ts",
@@ -20,5 +20,5 @@
     "@types/node": "^24.2.0",
     "typescript": "^5.3.3"
   },
-  "commit_sha": "67dbe93b4680eaf1332182daaed9a59fa6c7eafa"
+  "commit_sha": "82799f1ae5ad0c08f58c6605a6a73992325588ce"
 }