@recallai/desktop-sdk 2025.3.21-bac17c323e1c541c8e37a11aa29e369f59b0dc28 → 2025.3.24-430771fa71a1136b9be5e37d541f0574ada1385d

package/index.d.ts

@@ -24,10 +24,16 @@ declare module '@recallai/desktop-sdk' {
         'error': ErrorEvent;
         'media-capture-status': MediaCaptureStatusEvent;
         'permissions-granted': PermissionsGrantedEvent;
+        'permission-status': PermissionStatusEvent;
         'realtime-event': RealtimeEvent;
         'shutdown': ShutdownEvent;
     };
 
+    export type Permission =
+        | 'accessibility'
+        | 'screen-capture'
+        | 'microphone';
+
     export function addEventListener<T extends keyof EventTypeToPayloadMap>(
         type: T,
         listener: (event: EventTypeToPayloadMap[T]) => void
@@ -40,6 +46,7 @@ declare module '@recallai/desktop-sdk' {
     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>;
 
     ///
@@ -53,6 +60,8 @@ declare module '@recallai/desktop-sdk' {
 
     export interface RecallAiSdkConfig {
         api_url: string;
+        acquirePermissionsOnStartup?: Permission[];
+        restartOnError?: boolean;
     }
 
     export interface StartRecordingConfig {
@@ -119,6 +128,11 @@ declare module '@recallai/desktop-sdk' {
 
     export interface PermissionsGrantedEvent {}
 
+    export interface PermissionStatusEvent {
+        permission: Permission;
+        granted: boolean;
+    }
+
     export interface ErrorEvent {
         window?: RecallAiSdkWindow;
         type: string;

package/index.js

@@ -45,6 +45,41 @@ let proc;
 const listeners = [];
 const pendingCommands = {};
 
+let lastOptions;
+let remainingAutomaticRestarts = 10;
+let unexpectedShutdown = false;
+
+async function doLog(level, log) {
+  try {
+    const levelMap = {
+      "info": "log",
+      "warning": "warn",
+      "error": "error"
+    };
+
+    console[levelMap[level]](...log);
+
+    await sendCommand("log", {
+      log: log.join(" "),
+      level: level
+    });
+  } catch (e) {
+    //console.error("Log failed:", e.message, e.stack);
+  }
+}
+
+function log(...log) {
+  doLog("info", log);
+}
+
+function logWarning(...log) {
+  doLog("warning", log);
+}
+
+function logError(...log) {
+  doLog("error", log);
+}
+
 function emitEvent(type, payload) {
   for (const listener of listeners) {
     if (listener.type === type)
@@ -65,12 +100,12 @@ function startProcess() {
   const exe_path = exe_paths.find(fs.existsSync);
 
   if (!exe_path) {
-    console.error(`Desktop SDK: Couldn't launch! This is likely an issue with the build tool you're using.`);
+    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)
-      console.error("Tried:", exe_path);
+      logError("Tried:", exe_path);
 
-    console.log();
+    log();
 
     return;
   }
@@ -117,7 +152,7 @@ function startProcess() {
           break;
       }
     } catch (err) {
-      console.error("Desktop SDK: Failed to parse incoming data:", err);
+      logError("Desktop SDK: Failed to parse incoming data:", err);
     }
   });
 
@@ -127,7 +162,7 @@ function startProcess() {
       type: 'process',
       message: `The Desktop SDK server process has failed to start or exited improperly.`
     });
-    console.error(`Desktop SDK: Process error: ${error.message}`);
+    logError(`Desktop SDK: Process error: ${error.message}`);
   });
 
   proc.on('close', (code, signal) => {
@@ -137,12 +172,20 @@ function startProcess() {
     if (code === 0 || signal == 'SIGINT')
       return;
 
-    console.error(`Desktop SDK: Process exited with code ${code}, signal ${signal}`);
+    logError(`Desktop SDK: Process exited with code ${code}, signal ${signal}`);
 
     emitEvent('error', {
       type: 'process',
       message: "The Desktop SDK server process exited unexpectedly."
     });
+
+    unexpectedShutdown = true;
+
+    if (lastOptions.restartOnError && remainingAutomaticRestarts > 0) {
+      remainingAutomaticRestarts--;
+      console.error("Automatically restarting Desktop SDK due to unexpected exit!");
+      doInit(lastOptions);
+    }
   });
 }
 
@@ -166,14 +209,29 @@ function sendCommand(command, params = {}) {
   });
 }
 
+function doInit(options) {
+  startProcess();
+
+  if (unexpectedShutdown) {
+    logError("Desktop SDK: Recovered from unexpected shutdown");
+    unexpectedShutdown = false;
+  }
+
+  return sendCommand("init", { config: JSON.stringify(options) });
+}
+
 function init(options) {
   let { api_url, dev } = options;
+
   if (!dev && (!api_url || !api_url.startsWith("https"))) {
     throw new Error(`api_url must be an https url, got: ${api_url}`);
   }
 
-  startProcess();
-  return sendCommand("init", { config: JSON.stringify(options) });
+  if (options.restartOnError === undefined)
+    options.restartOnError = true;
+
+  lastOptions = options;
+  doInit(options);
 }
 
 async function shutdown() {
@@ -215,6 +273,10 @@ function prepareDesktopAudioRecording() {
   return sendCommand("prepareDesktopAudioRecording");
 }
 
+function requestPermission(permission) {
+  return sendCommand("requestPermission", { permission });
+}
+
 function addEventListener(type, callback) {
   listeners.push({ type, callback });
 }
@@ -229,4 +291,5 @@ module.exports = {
   stopRecording,
   uploadRecording,
   prepareDesktopAudioRecording,
+  requestPermission
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recallai/desktop-sdk",
-  "version": "2025.03.21-bac17c323e1c541c8e37a11aa29e369f59b0dc28",
+  "version": "2025.03.24-430771fa71a1136b9be5e37d541f0574ada1385d",
   "description": "Recall Desktop SDK (Alpha)",
   "main": "./index.js",
   "types": "./index.d.ts",
@@ -8,6 +8,10 @@
     "uuid": "^11.1.0"
   },
   "scripts": {
-    "install": "./unpack-frameworks.sh"
+    "install": "./unpack-frameworks.sh",
+    "validate-types": "tsc --noEmit index.d.ts"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.3"
   }
 }