@recallai/desktop-sdk 1.0.6 → 1.2.0

package/CHANGELOG.md

@@ -1,8 +1,40 @@
-### 1.0.6 [patch] (MacOS) - 2025-07-11
+### 1.2.0 [minor] (MacOS+Windows) - 2025-09-26
+
+- Initial support for Google Meet on Windows
+- Fixed issues with participant mapping on Windows
+- Mixed audio mp3 support for Windows
+- Zoom, Teams, Google Meet url scraping for Windows
+- Gladia streaming support for transcription
+- Fixed an issue where Zoom video capture would be affected when chat is open
+- Improved acoustic audio cancellation
+- Added the ability to get URL from Zoom and Teams meetings
+- Various improvements for Google Meet support on macOS
+- Speeded up starting a recording
+- Caused recording to stop when the laptop lid is closed
+
+### 1.1.0 [minor] (MacOS+Windows) - 2025-08-29
+
+- Reduce idle power consumption by 80%
+- Add capture support for MS Teams on MacOS
+- Add capture support for MS Teams on Windows
+- Fixed a bug detecting Zoom on Windows for non-premium zoom members
+- Fixed a bug capuring video on old Win10 Windows installs
+- Add support for gathering meeting urls for Zoom/Teams on Windows
+- Add support for AssemblyAI Universal Streaming Model (v3)
+- Add support for transcript.partial_data
+- Fix permissions to allow system only audio without requiring an initial request
+- Add Google Meet url to URL field
+- Generate index.js and index.d.ts from an index.ts file
+- Prevent rogue screen capture kit calls from causing CPU drain in system audio only mode
+- Fix memory growth during recording
+- Fix memory leaks on idle
+- Prevent zombie exe on stdin kill
+
+### 1.0.6 [patch] (MacOS) - 2025-08-15
 
 - Fixes a bug where whole-desktop audio capture would produce corrupted recordings.
 
-### 1.0.5 [patch] (MacOS) - 2025-07-11
+### 1.0.5 [patch] (MacOS) - 2025-08-11
 
 - Fixes a bug that would cause an occasional crash.
 

package/index.d.ts

@@ -1,163 +1,129 @@
-declare module '@recallai/desktop-sdk' {
-    export type RecallAiSdkEvent =
-        | RecordingStartEvent
-        | RecordingStopEvent
-        | UploadProgressEvent
-        | MeetingDetectedEvent
-        | MeetingUpdatedEvent
-        | MeetingClosedEvent
-        | SdkStateChangeEvent
-        | ErrorEvent
-        | MediaCaptureStatusEvent
-        | ParticipantCaptureStatusEvent
-        | PermissionsGrantedEvent
-        | RealtimeEvent
-        | ShutdownEvent;
-
-    export type EventTypeToPayloadMap = {
-        'recording-started': RecordingStartEvent;
-        'recording-ended': RecordingStopEvent;
-        'upload-progress': UploadProgressEvent;
-        'meeting-detected': MeetingDetectedEvent;
-        'meeting-updated': MeetingUpdatedEvent;
-        'meeting-closed': MeetingClosedEvent;
-        'sdk-state-change': SdkStateChangeEvent;
-        'error': ErrorEvent;
-        'media-capture-status': MediaCaptureStatusEvent;
-        'participant-capture-status': ParticipantCaptureStatusEvent;
-        'permissions-granted': PermissionsGrantedEvent;
-        'permission-status': PermissionStatusEvent;
-        'realtime-event': RealtimeEvent;
-        'shutdown': ShutdownEvent;
-    };
-
-    export type Permission =
-        | 'accessibility'
-        | 'screen-capture'
-        | 'microphone'
-        | 'system-audio' // not necessary if you have screen-capture
-    ;
-
-    export function addEventListener<T extends keyof EventTypeToPayloadMap>(
-        type: T,
-        listener: (event: EventTypeToPayloadMap[T]) => void
-    ): void;
-
-    export function init(config: RecallAiSdkConfig): Promise<null>;
-    export function startRecording(config: StartRecordingConfig): Promise<null>;
-    export function pauseRecording(config: PauseRecordingConfig): Promise<null>;
-    export function resumeRecording(config: ResumeRecordingConfig): Promise<null>;
-    export function stopRecording(config: StopRecordingConfig): Promise<null>;
-    export function uploadRecording(config: UploadRecordingConfig): Promise<null>;
-    export function prepareDesktopAudioRecording(): Promise<string>;
-    export function requestPermission(permission: Permission): Promise<null>;
-    export function shutdown(): Promise<null>;
-
-    ///
-
-    export interface RecallAiSdkWindow {
+export type RecallAiSdkEvent = RecordingStartEvent | RecordingStopEvent | UploadProgressEvent | MeetingDetectedEvent | MeetingUpdatedEvent | MeetingClosedEvent | SdkStateChangeEvent | ErrorEvent | MediaCaptureStatusEvent | ParticipantCaptureStatusEvent | PermissionsGrantedEvent | RealtimeEvent | ShutdownEvent;
+export type EventTypeToPayloadMap = {
+    'recording-started': RecordingStartEvent;
+    'recording-ended': RecordingStopEvent;
+    'upload-progress': UploadProgressEvent;
+    'meeting-detected': MeetingDetectedEvent;
+    'meeting-updated': MeetingUpdatedEvent;
+    'meeting-closed': MeetingClosedEvent;
+    'sdk-state-change': SdkStateChangeEvent;
+    'error': ErrorEvent;
+    'media-capture-status': MediaCaptureStatusEvent;
+    'participant-capture-status': ParticipantCaptureStatusEvent;
+    'permissions-granted': PermissionsGrantedEvent;
+    'permission-status': PermissionStatusEvent;
+    'realtime-event': RealtimeEvent;
+    'shutdown': ShutdownEvent;
+};
+export type Permission = 'accessibility' | 'screen-capture' | 'microphone' | 'system-audio';
+export interface RecallAiSdkWindow {
+    id: string;
+    title?: string;
+    url?: string;
+    platform: string;
+}
+export interface RecallAiSdkConfig {
+    api_url?: string;
+    apiUrl?: string;
+    acquirePermissionsOnStartup?: Permission[];
+    restartOnError?: boolean;
+    dev?: boolean;
+}
+export interface StartRecordingConfig {
+    windowId: string;
+    uploadToken: string;
+}
+export interface StopRecordingConfig {
+    windowId: string;
+}
+export interface PauseRecordingConfig {
+    windowId: string;
+}
+export interface ResumeRecordingConfig {
+    windowId: string;
+}
+export interface UploadRecordingConfig {
+    windowId: string;
+}
+export interface RecordingStartEvent {
+    window: RecallAiSdkWindow;
+}
+export interface RecordingStopEvent {
+    window: RecallAiSdkWindow;
+}
+export interface UploadProgressEvent {
+    window: {
         id: string;
-        title?: string;
-        url?: string;
-        platform: string;
-    }
-
-    export interface RecallAiSdkConfig {
-        api_url?: string;
-        apiUrl?: string;
-        acquirePermissionsOnStartup?: Permission[];
-        restartOnError?: boolean;
-    }
-
-    export interface StartRecordingConfig {
-        windowId: string;
-        uploadToken: string;
-    }
-
-    export interface StopRecordingConfig {
-        windowId: string;
-    }
-
-    export interface PauseRecordingConfig {
-        windowId: string;
-    }
-
-    export interface ResumeRecordingConfig {
-        windowId: string;
-    }
-
-    export interface UploadRecordingConfig {
-        windowId: string;
-    }
-
-    ///
-
-    export interface RecordingStartEvent {
-        window: RecallAiSdkWindow;
-    }
-
-    export interface RecordingStopEvent {
-        window: RecallAiSdkWindow;
-    }
-
-    export interface UploadProgressEvent {
-        window: { id: string };
-        progress: number;
-    }
-
-    export interface MeetingDetectedEvent {
-        window: RecallAiSdkWindow;
-    }
-
-    export interface MeetingUpdatedEvent {
-        window: RecallAiSdkWindow;
-    }
-
-    export interface MeetingClosedEvent {
-        window: RecallAiSdkWindow;
-    }
-
-    export interface SdkStateChangeEvent {
-        sdk: {
-            state: {
-                code: 'recording' | 'idle' | 'paused';
-            };
+    };
+    progress: number;
+}
+export interface MeetingDetectedEvent {
+    window: RecallAiSdkWindow;
+}
+export interface MeetingUpdatedEvent {
+    window: RecallAiSdkWindow;
+}
+export interface MeetingClosedEvent {
+    window: RecallAiSdkWindow;
+}
+export interface SdkStateChangeEvent {
+    sdk: {
+        state: {
+            code: 'recording' | 'idle' | 'paused';
         };
-    }
-
-    export interface MediaCaptureStatusEvent {
-        window: RecallAiSdkWindow;
-        type: 'video' | 'audio';
-        capturing: boolean;
-    }
-
-    export interface ParticipantCaptureStatusEvent {
-        window: RecallAiSdkWindow;
-        type: 'video' | 'audio' | 'screenshare';
-        capturing: boolean;
-    }
-
-    export interface PermissionsGrantedEvent {}
-
-    export interface PermissionStatusEvent {
-        permission: Permission;
-        status: string;
-    }
-
-    export interface ErrorEvent {
-        window?: RecallAiSdkWindow;
-        type: string;
-        message: string;
-    }
-
-    export interface RealtimeEvent {
-        window: RecallAiSdkWindow;
-        event: string;
-        data: any;
-    }
-
-    export interface ShutdownEvent {
-        code: number;
-        signal: string;
-    }
+    };
+}
+export interface MediaCaptureStatusEvent {
+    window: RecallAiSdkWindow;
+    type: 'video' | 'audio';
+    capturing: boolean;
+}
+export interface ParticipantCaptureStatusEvent {
+    window: RecallAiSdkWindow;
+    type: 'video' | 'audio' | 'screenshare';
+    capturing: boolean;
+}
+export interface PermissionsGrantedEvent {
+}
+export interface PermissionStatusEvent {
+    permission: Permission;
+    status: string;
+}
+export interface ErrorEvent {
+    window?: RecallAiSdkWindow;
+    type: string;
+    message: string;
+}
+export interface RealtimeEvent {
+    window: RecallAiSdkWindow;
+    event: string;
+    data: any;
+}
+export interface ShutdownEvent {
+    code: number;
+    signal: string;
 }
+export declare function init(options: RecallAiSdkConfig): Promise<null>;
+export declare function shutdown(): Promise<null>;
+export declare function dumpAXTree(procName: string): Promise<any>;
+export declare function startRecording(config: StartRecordingConfig): Promise<null>;
+export declare function stopRecording({ windowId }: StopRecordingConfig): Promise<null>;
+export declare function pauseRecording({ windowId }: PauseRecordingConfig): Promise<null>;
+export declare function resumeRecording({ windowId }: ResumeRecordingConfig): Promise<null>;
+export declare function uploadRecording({ windowId }: UploadRecordingConfig): Promise<null>;
+export declare function prepareDesktopAudioRecording(): Promise<string>;
+export declare function requestPermission(permission: Permission): Promise<null>;
+export declare function addEventListener<T extends keyof EventTypeToPayloadMap>(type: T, callback: (event: EventTypeToPayloadMap[T]) => void): void;
+declare const RecallAiSdk: {
+    init: typeof init;
+    shutdown: typeof shutdown;
+    startRecording: typeof startRecording;
+    stopRecording: typeof stopRecording;
+    pauseRecording: typeof pauseRecording;
+    resumeRecording: typeof resumeRecording;
+    uploadRecording: typeof uploadRecording;
+    prepareDesktopAudioRecording: typeof prepareDesktopAudioRecording;
+    requestPermission: typeof requestPermission;
+    addEventListener: typeof addEventListener;
+};
+export default RecallAiSdk;

package/index.js

@@ -1,336 +1,398 @@
-const path = require('path');
-const { spawn } = require('child_process');
-const readline = require('node:readline');
-const fs = require('node:fs');
-const os = require("node:os");
-const { v4: uuidv4 } = require('uuid');
-
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.init = init;
+exports.shutdown = shutdown;
+exports.dumpAXTree = dumpAXTree;
+exports.startRecording = startRecording;
+exports.stopRecording = stopRecording;
+exports.pauseRecording = pauseRecording;
+exports.resumeRecording = resumeRecording;
+exports.uploadRecording = uploadRecording;
+exports.prepareDesktopAudioRecording = prepareDesktopAudioRecording;
+exports.requestPermission = requestPermission;
+exports.addEventListener = addEventListener;
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const readline = __importStar(require("node:readline"));
+const node_stream_1 = require("node:stream");
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const uuid_1 = require("uuid");
 // HACK: This is needed because of https://github.com/electron/electron/issues/6262
-
 // Search for the unpacked directory first, since fs.existsSync actually reports
 // the "virtual" files in the .asar as being present
-
 let exe_paths = [];
-
-if (process.platform == "darwin") {
-  exe_paths.push(path.join(__dirname, "desktop_sdk_macos_exe").replace('app.asar', 'app.asar.unpacked'));
-  exe_paths.push(path.join(__dirname, "desktop_sdk_macos_exe"));
-} else if (process.platform == "win32") {
-  exe_paths.push(path.join(__dirname, "agent-windows.exe").replace('app.asar', 'app.asar.unpacked'));
-  exe_paths.push(path.join(__dirname, "agent-windows.exe"));
+if (process.platform === "darwin") {
+    exe_paths.push(path.join(__dirname, "desktop_sdk_macos_exe").replace('app.asar', 'app.asar.unpacked'));
+    exe_paths.push(path.join(__dirname, "desktop_sdk_macos_exe"));
+}
+else if (process.platform === "win32") {
+    exe_paths.push(path.join(__dirname, "agent-windows.exe").replace('app.asar', 'app.asar.unpacked'));
+    exe_paths.push(path.join(__dirname, "agent-windows.exe"));
 }
-
 let proc;
+let rlData;
+let rlStdout;
+let rlStderr;
 const listeners = [];
 const pendingCommands = {};
-
 let lastOptions;
 let remainingAutomaticRestarts = 10;
 let unexpectedShutdown = false;
-
 let logBuffer = [];
 let logIndex = 0;
-
 function flushLogBuffer() {
-  const buf = logBuffer.slice();
-
-  logBuffer = [];
-  logIndex = 0;
-
-  for (const idx in buf) {
-    const { level, log, echo } = buf[idx];
-    doLog(level, [log], echo);
-  }
+    const buf = logBuffer.slice(); // just here for the copy
+    logBuffer = [];
+    logIndex = 0;
+    // we use a for... in... here because it does not loop over the sparse (undefined) entries
+    // if you doubt this, see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/for...in#array_iteration_and_for...in
+    // 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);
+    }
+}
+function isPlainObject(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        Object.getPrototypeOf(value) === Object.prototype);
+}
+/**
+ * JSON.stringify with alphabetically sorted object keys (deep).
+ * - Preserves array order
+ * - Leaves non-plain objects (Date, Map, Set, class instances with toJSON, etc.) intact
+ * - Detects circular references like JSON.stringify and throws
+ */
+function sortedStringify(value, replacer, space) {
+    const seen = new WeakSet();
+    function normalize(v) {
+        if (v === null || typeof v !== "object")
+            return v;
+        const obj = v;
+        if (seen.has(obj)) {
+            throw new TypeError("Converting circular structure to JSON");
+        }
+        seen.add(obj);
+        if (Array.isArray(v)) {
+            const out = v.map(normalize);
+            seen.delete(obj);
+            return out;
+        }
+        if (isPlainObject(v)) {
+            const src = v;
+            const out = {};
+            for (const key of Object.keys(src).sort()) {
+                out[key] = normalize(src[key]);
+            }
+            seen.delete(obj);
+            return out;
+        }
+        // Non-plain object: keep as-is so built-in toJSON/serialization applies.
+        seen.delete(obj);
+        return v;
+    }
+    return JSON.stringify(normalize(value), replacer, space);
 }
-
 async function doLog(level, log, echo = true) {
-  try {
-    const levelMap = {
-      "info": "log",
-      "warning": "warn",
-      "error": "error"
-    };
-
-    if (echo)
-      console[levelMap[level] ?? "log"](...log);
-
-    let logPayload = {
-      log: log.join(" "),
-      level: level,
-      echo
-    };
-
-    let idx = logIndex++;
-
-    logBuffer[idx] = logPayload;
-
-    if (proc && proc.exitCode === null) {
-      await sendCommand("log", logPayload);
-      delete logBuffer[idx];
+    try {
+        const levelMap = {
+            "info": "log",
+            "warning": "warn",
+            "error": "error"
+        };
+        if (echo) {
+            const consoleMethod = console[levelMap[level] ?? "log"];
+            consoleMethod(...log);
+        }
+        const logPayload = {
+            log: log.join(" "),
+            level: level,
+            echo
+        };
+        const idx = logIndex++;
+        logBuffer[idx] = logPayload;
+        if (proc && proc.exitCode === null) {
+            await sendCommand("log", logPayload);
+            delete logBuffer[idx];
+        }
+    }
+    catch (e) {
+        console.error("Failed to send log to Desktop SDK", e.stack, e.message);
     }
-  } catch (e) {
-    console.error("Failed to send log to Desktop SDK", e.stack, e.message);
-  }
 }
-
 function log(...log) {
-  doLog("info", log);
+    doLog("info", log);
 }
-
 function logWarning(...log) {
-  doLog("warning", log);
+    doLog("warning", log);
 }
-
 function logError(...log) {
-  doLog("error", log);
+    doLog("error", log);
 }
-
 function emitEvent(type, payload) {
-  if (type !== "upload-progress" && type !== "realtime-event") {
-    doLog("info", ["Receiving event: " + type + " | " + JSON.stringify(payload)], false);
-  }
-
-  for (const listener of listeners) {
-    if (listener.type === type)
-      listener.callback(payload);
-  }
+    if (type !== "upload-progress" && type !== "realtime-event") {
+        doLog("info", ["Receiving event: " + type + " | " + sortedStringify(payload)], false);
+    }
+    for (const listener of listeners) {
+        if (listener.type === type) {
+            listener.callback(payload);
+        }
+    }
 }
-
 function flushPendingCommands(err) {
-  Object.keys(pendingCommands).forEach(commandId => {
-    pendingCommands[commandId].reject(err);
-    delete pendingCommands[commandId];
-  });
+    Object.keys(pendingCommands).forEach(commandId => {
+        pendingCommands[commandId].reject(err);
+        delete pendingCommands[commandId];
+    });
 }
-
 function startProcess() {
-  if (proc && proc.exitCode === null) {
-    logError("Desktop SDK: Trying to start process while it is already started");
-    return;
-  }
-
-  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.`);
-
-    for (const exe_path of exe_paths)
-      logError("Tried:", exe_path);
-
-    return;
-  }
-
-  let envExtra = {};
-
-  if (process.platform === "win32" && process.env.GLOBAL_GST_RECALL !== "1") {
-    envExtra["GST_PLUGIN_PATH"] = path.join(path.dirname(exe_path), "gstreamer-1.0");
-  }
-
-  proc = spawn(exe_path, {
-    stdio: "pipe",
-    env: {
-      GST_DEBUG: "2",
-      GST_DEBUG_DUMP_DOT_DIR: process.env.RECALLAI_DESKTOP_SDK_DEV ? "/tmp/gst.nocommit" : os.tmpdir(),
-      RUST_BACKTRACE: true,
-      // "DYLD_INSERT_LIBRARIES":"/opt/homebrew/lib/libjemalloc.dylib",
-      // "MALLOC_CONF":"prof:true,prof_active:true,prof_prefix:jeprof",
-      // "DYLD_FORCE_FLAT_NAMESPACE":"1",
-      ...envExtra,
+    if (proc && proc.exitCode === null) {
+        logError("Desktop SDK: Trying to start process while it is already started");
+        return;
     }
-  });
-
-  const rlStdout = readline.createInterface({ input: proc.stdout, crlfDelay: Infinity });
-  const rlStderr = readline.createInterface({ input: proc.stderr, crlfDelay: Infinity });
-
-  rlStdout.on('line', (line) => {
-
-
-    if (line.startsWith("recall_ai_command|")) {
-      try {
-        const data = JSON.parse(line.substring(18));
-
-        switch (data.type) {
-          case "event":
-            const event = JSON.parse(data.event);
-            emitEvent(event.type, event.payload);
-            break;
-
-          case "response":
-            const pendingCommand = pendingCommands[data.commandId];
-            if (pendingCommand) {
-              if (data.status === "success") {
-                pendingCommand.resolve(data.result);
-              }
-              else {
-                pendingCommand.reject(new Error(data.result));
-              }
-              delete pendingCommands[data.commandId];
-            }
-            break;
+    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.`);
+        for (const exe_path of exe_paths) {
+            logError("Tried:", exe_path);
         }
-      } catch (err) {
-        logError("Desktop SDK: Failed to parse incoming data:", err);
-      }
-    } else {
-      if (process.env.RECALLAI_DESKTOP_SDK_DEV)
-        console.log(line);
+        return;
     }
-  });
-
-  rlStderr.on('line', (line) => {
-    if (process.env.RECALLAI_DESKTOP_SDK_DEV)
-      console.error(line);
-  });
-
-  proc.on('error', (error) => {
-    flushPendingCommands(new Error(`Process error: ${error.message}`));
-    emitEvent('error', {
-      type: 'process',
-      message: `The Desktop SDK server process has failed to start or exited improperly.`
-    });
-    logError(`Desktop SDK: Process error: ${error.message}`);
-  });
-
-  proc.on('close', async (code, signal) => {
-    flushPendingCommands(new Error(`Process exited with code ${code}, signal ${signal}.`));
-    emitEvent('shutdown', { code, signal });
-
-    if (code === 0 || signal == 'SIGINT')
-      return;
-
-    logError(`Desktop SDK: Process exited with code ${code}, signal ${signal}`);
-
-    emitEvent('error', {
-      type: 'process',
-      message: "The Desktop SDK server process exited unexpectedly."
+    let envExtra = {};
+    if (process.platform === "win32" && process.env.GLOBAL_GST_RECALL !== "1") {
+        envExtra["GST_PLUGIN_PATH"] = path.join(path.dirname(exe_path), "gstreamer-1.0");
+    }
+    const gst_dump_dir = process.env.RECALLAI_DESKTOP_SDK_DEV ? path.join(os.tmpdir(), "gst.nocommit") : os.tmpdir();
+    if (!fs.existsSync(gst_dump_dir)) {
+        try {
+            fs.mkdirSync(gst_dump_dir);
+        }
+        catch (e) {
+            logError("Failed to create gst dump dir:", String(e));
+        }
+    }
+    proc = (0, child_process_1.spawn)(exe_path, {
+        stdio: (process.platform === "darwin" ? ["pipe", "pipe", "pipe", "pipe"] : "pipe"),
+        env: {
+            GST_DEBUG: "2",
+            GST_DEBUG_DUMP_DOT_DIR: gst_dump_dir,
+            RUST_BACKTRACE: "1",
+            // "DYLD_INSERT_LIBRARIES":"/opt/homebrew/lib/libjemalloc.dylib",
+            // "MALLOC_CONF":"prof:true,prof_active:true,prof_prefix:jeprof",
+            // "DYLD_FORCE_FLAT_NAMESPACE":"1",
+            ...envExtra,
+        }
     });
-
-    proc = null;
-    unexpectedShutdown = true;
-
-    if (lastOptions.restartOnError && remainingAutomaticRestarts > 0) {
-      remainingAutomaticRestarts--;
-      logError(`Automatically restarting Desktop SDK due to unexpected exit! Automatic restarts left: ${remainingAutomaticRestarts}`);
-      doInit(lastOptions);
+    if (process.platform === "darwin") {
+        const fd3 = proc.stdio[3];
+        if (fd3 && fd3 instanceof node_stream_1.Readable) {
+            rlData = readline.createInterface({ input: fd3, crlfDelay: Infinity });
+        }
     }
-  });
+    rlStdout = readline.createInterface({ input: proc.stdout, crlfDelay: Infinity });
+    rlStderr = readline.createInterface({ input: proc.stderr, crlfDelay: Infinity });
+    let onLine = (line) => {
+        if (line?.startsWith("recall_ai_command|")) {
+            try {
+                const data = JSON.parse(line.substring(18));
+                switch (data.type) {
+                    case "event":
+                        if (data.event) {
+                            const event = JSON.parse(data.event);
+                            emitEvent(event.type, event.payload);
+                        }
+                        break;
+                    case "response":
+                        const pendingCommand = pendingCommands[data.commandId];
+                        if (pendingCommand) {
+                            if (data.status === "success") {
+                                pendingCommand.resolve(data.result);
+                            }
+                            else {
+                                pendingCommand.reject(new Error(data.result));
+                            }
+                            delete pendingCommands[data.commandId];
+                        }
+                        break;
+                }
+            }
+            catch (err) {
+                logError("Desktop SDK: Failed to parse incoming data:", String(err));
+            }
+        }
+        else {
+            if (process.env.RECALLAI_DESKTOP_SDK_DEV) {
+                console.log(line);
+            }
+        }
+    };
+    rlData?.on('line', onLine);
+    rlStdout.on('line', onLine);
+    rlStderr.on('line', (line) => {
+        if (process.env.RECALLAI_DESKTOP_SDK_DEV) {
+            console.error(line);
+        }
+    });
+    proc.on('error', (error) => {
+        flushPendingCommands(new Error(`Process error: ${error.message}`));
+        emitEvent('error', {
+            type: 'process',
+            message: `The Desktop SDK server process has failed to start or exited improperly.`
+        });
+        logError(`Desktop SDK: Process error: ${error.message}`);
+    });
+    proc.on('close', async (code, signal) => {
+        flushPendingCommands(new Error(`Process exited with code ${code}, signal ${signal}.`));
+        emitEvent('shutdown', { code: code ?? 0, signal: signal ?? '' });
+        rlStdout?.close();
+        rlStderr?.close();
+        rlStdout = null;
+        rlStderr = null;
+        if (code === 0 || signal === 'SIGINT') {
+            return;
+        }
+        logError(`Desktop SDK: Process exited with code ${code}, signal ${signal}`);
+        emitEvent('error', {
+            type: 'process',
+            message: "The Desktop SDK server process exited unexpectedly."
+        });
+        proc = null;
+        unexpectedShutdown = true;
+        if (lastOptions.restartOnError && remainingAutomaticRestarts > 0) {
+            remainingAutomaticRestarts--;
+            logError(`Automatically restarting Desktop SDK due to unexpected exit! Automatic restarts left: ${remainingAutomaticRestarts}`);
+            doInit(lastOptions);
+        }
+    });
 }
-
 function sendCommand(command, params = {}) {
-  return new Promise((resolve, reject) => {
-    if (!proc || !proc.stdin) {
-      reject(new Error("The Desktop SDK is not started; call `init` to start it."));
-      return;
-    }
-
-    const commandId = uuidv4();
-    pendingCommands[commandId] = { resolve, reject };
-
-    const payload = {
-      command,
-      commandId,
-      params
-    };
-
-    let payloadStr = JSON.stringify(payload);
-    proc.stdin.write(payloadStr + "\n");
-
-    if (command !== "log") {
-      doLog("info", ["Sending command: " + payloadStr], false);
-    }
-  });
+    return new Promise((resolve, reject) => {
+        if (!proc || !proc.stdin) {
+            reject(new Error("The Desktop SDK is not started; call `init` to start it."));
+            return;
+        }
+        const commandId = (0, uuid_1.v4)();
+        pendingCommands[commandId] = { resolve, reject };
+        const payload = {
+            command,
+            commandId,
+            params
+        };
+        const payloadStr = JSON.stringify(payload);
+        proc.stdin.write(payloadStr + "\n");
+        if (command !== "log") {
+            doLog("info", ["Sending command: " + payloadStr], false);
+        }
+    });
 }
-
 async function doInit(options) {
-  startProcess();
-
-  if (unexpectedShutdown) {
-    logError("Desktop SDK: Recovered from unexpected shutdown");
-    unexpectedShutdown = false;
-  }
-
-  await sendCommand("init", { config: JSON.stringify(options) });
-  flushLogBuffer();
+    startProcess();
+    if (unexpectedShutdown) {
+        logError("Desktop SDK: Recovered from unexpected shutdown");
+        unexpectedShutdown = false;
+    }
+    await sendCommand("init", { config: JSON.stringify(options) });
+    flushLogBuffer();
 }
-
 async function init(options) {
-  if (process.platform !== "darwin"
-    && process.platform !== "win32"
-  ) {
-    throw new Error(`Platform ${process.platform} is not supported by Desktop SDK`);
-  }
-
-  let { 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}`);
-  }
-
-  if (options.restartOnError === undefined)
-    options.restartOnError = true;
-
-  lastOptions = options;
-  return doInit(options);
+    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}`);
+    }
+    if (options.restartOnError === undefined) {
+        options.restartOnError = true;
+    }
+    lastOptions = options;
+    await doInit(options);
+    return null;
 }
-
 async function shutdown() {
-  const result = await sendCommand("shutdown");
-
-  if (proc) {
-    const currentProc = proc;
-    setTimeout(() => {
-      if (!currentProc.killed) {
-        currentProc.kill();
-      }
-    }, 5000);
-  }
-
-  return result;
+    const result = await sendCommand("shutdown");
+    if (proc) {
+        const currentProc = proc;
+        setTimeout(() => {
+            if (!currentProc.killed) {
+                currentProc.kill();
+            }
+        }, 5000);
+    }
+    return result;
+}
+function dumpAXTree(procName) {
+    return sendCommand("dumpAXTree", { procName });
 }
-
 function startRecording(config) {
-  return sendCommand("startRecording", { config: JSON.stringify(config) });
+    return sendCommand("startRecording", { config: JSON.stringify(config) });
 }
-
 function stopRecording({ windowId }) {
-  return sendCommand("stopRecording", { windowId });
+    return sendCommand("stopRecording", { windowId });
 }
-
 function pauseRecording({ windowId }) {
-  return sendCommand("pauseRecording", { windowId });
+    return sendCommand("pauseRecording", { windowId });
 }
-
 function resumeRecording({ windowId }) {
-  return sendCommand("resumeRecording", { windowId });
+    return sendCommand("resumeRecording", { windowId });
 }
-
 function uploadRecording({ windowId }) {
-  return sendCommand("uploadRecording", { windowId });
+    return sendCommand("uploadRecording", { windowId });
 }
-
 function prepareDesktopAudioRecording() {
-  return sendCommand("prepareDesktopAudioRecording");
+    return sendCommand("prepareDesktopAudioRecording");
 }
-
 function requestPermission(permission) {
-  return sendCommand("requestPermission", { permission });
+    return sendCommand("requestPermission", { permission });
 }
-
 function addEventListener(type, callback) {
-  listeners.push({ type, callback });
+    listeners.push({ type, callback });
 }
-
-module.exports = {
-  init,
-  shutdown,
-  addEventListener,
-  startRecording,
-  pauseRecording,
-  resumeRecording,
-  stopRecording,
-  uploadRecording,
-  prepareDesktopAudioRecording,
-  requestPermission
+const RecallAiSdk = {
+    init,
+    shutdown,
+    startRecording,
+    stopRecording,
+    pauseRecording,
+    resumeRecording,
+    uploadRecording,
+    prepareDesktopAudioRecording,
+    requestPermission,
+    addEventListener,
 };
+exports.default = RecallAiSdk;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recallai/desktop-sdk",
-  "version": "1.0.6",
+  "version": "1.2.0",
   "description": "Recall Desktop SDK",
   "main": "./index.js",
   "types": "./index.d.ts",
@@ -13,10 +13,12 @@
   },
   "scripts": {
     "install": "node ./setup.js",
-    "validate-types": "tsc --noEmit index.d.ts"
+    "validate-types": "tsc --noEmit",
+    "build": "tsc -p tsconfig.build.json"
   },
   "devDependencies": {
+    "@types/node": "^24.2.0",
     "typescript": "^5.3.3"
   },
-  "commit_sha": "78bcd926390af65c83ffa27a66147f8ad9144c9c"
+  "commit_sha": "f1c3fbbb113f8f5a51d801dd9fe240b371125539"
 }