feat(native): implement Phase 5 AppleScript handlers and remote control

- Implemented specialized PowerPoint/Keynote handlers with auto-focus and slideshow start.
- Added native:control-presentation for remote navigation (next/prev/stop).
- Added native:list-tools handler for self-documenting the bridge API.
- Added a comprehensive project README.md.

src/main/file_handlers.ts

@@ -90,15 +90,37 @@ export function registerFileHandlers() {
           });
         }
 
-        if (os.platform() === 'darwin' && ext === 'key') {
-          console.log(`Native: Launching Keynote via AppleScript for ${target}`);
-          const script = `tell application "Keynote" to open POSIX file "${target}"`;
-          return new Promise((resolve) => {
-            exec(`osascript -e "${script.replace(/"/g, '\"')}"`, (err) => {
-              if (err) resolve({ success: false, error: err.message });
-              else resolve({ success: true });
+        if (os.platform() === 'darwin') {
+          let script = '';
+          if (ext === 'key') {
+            script = `
+              tell application "Keynote"
+                activate
+                open (POSIX file "${target}")
+                delay 1
+                start (front document)
+              end tell
+            `;
+          } else if (ext === 'pptx' || ext === 'ppt') {
+            script = `
+              tell application "Microsoft PowerPoint"
+                activate
+                open (POSIX file "${target}")
+                delay 1
+                run slide show of active presentation
+              end tell
+            `;
+          }
+
+          if (script) {
+            console.log(`Native: Launching ${ext} via AppleScript for ${target}`);
+            return new Promise((resolve) => {
+              exec(`osascript -e "${script.replace(/"/g, '\\\\"')}"`, (err) => {
+                if (err) resolve({ success: false, error: err.message });
+                else resolve({ success: true });
+              });
             });
-          });
+          }
         }
       }
 
@@ -109,4 +131,4 @@ export function registerFileHandlers() {
       return { success: false, error: error.message };
     }
   });
-}
+}

src/main/shell_handlers.ts

@@ -79,10 +79,30 @@ export function registerShellHandlers() {
     }
 
     if (os.platform() === 'darwin') {
+      let script = '';
       if (appType === 'keynote') {
-        const script = `tell application "Keynote" to open POSIX file "${cleanedPath}"`;
-        const escapedScript = script.replace(/"/g, '\\"');
+        script = `
+          tell application "Keynote"
+            activate
+            open (POSIX file "${cleanedPath}")
+            delay 1
+            start (front document)
+          end tell
+        `;
+      } else if (appType === 'powerpoint') {
+        script = `
+          tell application "Microsoft PowerPoint"
+            activate
+            open (POSIX file "${cleanedPath}")
+            delay 1
+            run slide show of active presentation
+          end tell
+        `;
+      }
+
+      if (script) {
         return new Promise((resolve) => {
+          const escapedScript = script.replace(/"/g, '\\"');
           exec(`osascript -e "${escapedScript}"`, (err, stdout, stderr) => {
             if (err) resolve({ success: false, error: err.message });
             else resolve({ success: true });
@@ -94,4 +114,98 @@ export function registerShellHandlers() {
     const error = await shell.openPath(cleanedPath);
     return { success: !error, error };
   });
+
+  ipcMain.handle('native:control-presentation', async (event, { app, action }) => {
+    if (os.platform() !== 'darwin') return { success: false, error: 'Presentation control is only available on macOS' };
+    
+    let script = '';
+    if (app === 'powerpoint') {
+      switch (action) {
+        case 'next': script = 'tell application "Microsoft PowerPoint" to next slide of slide show view of active presentation'; break;
+        case 'prev': script = 'tell application "Microsoft PowerPoint" to previous slide of slide show view of active presentation'; break;
+        case 'start': script = 'tell application "Microsoft PowerPoint" to run slide show of active presentation'; break;
+        case 'stop': script = 'tell application "Microsoft PowerPoint" to stop slide show of active presentation'; break;
+      }
+    } else if (app === 'keynote') {
+      switch (action) {
+        case 'next': script = 'tell application "Keynote" to show next'; break;
+        case 'prev': script = 'tell application "Keynote" to show previous'; break;
+        case 'start': script = 'tell application "Keynote" to start (front document)'; break;
+        case 'stop': script = 'tell application "Keynote" to stop'; break;
+      }
+    }
+
+    if (!script) return { success: false, error: `Unsupported app or action: ${app}/${action}` };
+
+    return new Promise((resolve) => {
+      exec(`osascript -e "${script.replace(/"/g, '\\"')}"`, (error, stdout, stderr) => {
+        resolve({ success: !error, stdout: stdout.trim(), stderr: stderr.trim(), error: error ? error.message : null });
+      });
+    });
+  });
+
+  ipcMain.handle('native:list-tools', async () => {
+    return [
+      {
+        name: 'open_folder',
+        description: 'Opens a directory in the OS file explorer (Finder/Files/Explorer).',
+        params: { path: 'string' }
+      },
+      {
+        name: 'run_cmd',
+        description: 'Executes an asynchronous shell command with a timeout.',
+        params: { cmd: 'string', timeout: 'number (optional)' }
+      },
+      {
+        name: 'run_cmd_sync',
+        description: 'Executes a synchronous shell command.',
+        params: { cmd: 'string' }
+      },
+      {
+        name: 'run_osascript',
+        description: 'Executes a raw AppleScript string (macOS only).',
+        params: { script: 'string' }
+      },
+      {
+        name: 'kill_processes',
+        description: 'Forcefully terminates processes by name.',
+        params: { process_name_li: 'string[]' }
+      },
+      {
+        name: 'open_local_file_v2',
+        description: 'Opens a local file using the default OS handler.',
+        params: { filePath: 'string' }
+      },
+      {
+        name: 'launch_presentation',
+        description: 'Phase 5: Specialized launcher for PowerPoint, Keynote, and LibreOffice with auto-focus.',
+        params: { path: 'string', app: 'default|powerpoint|keynote' }
+      },
+      {
+        name: 'control_presentation',
+        description: 'Phase 5: Remote navigation for active slideshows.',
+        params: { app: 'powerpoint|keynote', action: 'next|prev|start|stop' }
+      },
+      {
+        name: 'check_cache',
+        description: 'Checks if a file exists in the local organized cache.',
+        params: { cache_root: 'string', hash: 'string', hash_prefix_length: 'number' }
+      },
+      {
+        name: 'download_to_cache',
+        description: 'Downloads a file from the API directly into the native cache.',
+        params: { url: 'string', cache_root: 'string', hash: 'string', api_key: 'string', account_id: 'string' }
+      },
+      {
+        name: 'launch_from_cache',
+        description: 'Atomic operation: Copies file from cache to temp with original name and launches via specialized handler.',
+        params: { cache_root: 'string', hash: 'string', temp_root: 'string', filename: 'string' }
+      },
+      {
+        name: 'get_device_info',
+        description: 'Returns hardware and OS metadata (CPUs, RAM, IP addresses, Hostname).',
+        params: {}
+      }
+    ];
+  });
 }