@mostrom/meeting-detector 1.0.0

package/README.md

@@ -0,0 +1,182 @@
+# Meeting Detector
+
+Real-time meeting detection for macOS desktop apps using TCC (Transparency, Consent, and Control) logs.
+
+## Features
+
+- 🎯 **App-agnostic**: Works with Zoom, Slack, Teams, Chrome, and any desktop meeting app
+- ⚡ **Real-time**: Detects meeting start/stop events as they happen
+- 🔍 **Process attribution**: Identifies which app is using camera/microphone with PID
+- 🎛️ **Event-driven**: Clean Node.js API with TypeScript support
+- 🚫 **Smart deduplication**: Prevents spam from multi-process apps like Teams
+- 📱 **Front app correlation**: Shows which app is currently in focus
+
+## Installation
+
+### From npm (when published)
+```bash
+npm install @mostrom/meeting-detector
+```
+
+### Local development
+```bash
+git clone <repo-url>
+cd meeting-detector
+npm install
+npm run build
+```
+
+### As a local dependency
+```bash
+# In your project's package.json
+{
+  "dependencies": {
+    "@mostrom/meeting-detector": "file:../path/to/meeting-detector"
+  }
+}
+```
+
+### Using npm link
+```bash
+# In meeting-detector directory
+npm link
+
+# In your project directory
+npm link @mostrom/meeting-detector
+```
+
+## Quick Start
+
+### Simple API
+```typescript
+import { detector } from '@mostrom/meeting-detector';
+import type { MeetingSignal } from '@mostrom/meeting-detector';
+
+const meetingDetector = detector((signal: MeetingSignal) => {
+  console.log('Meeting event:', signal);
+}, { debug: true });
+
+// Graceful shutdown
+process.on('SIGINT', () => {
+  meetingDetector.stop();
+  process.exit(0);
+});
+```
+
+### Class API
+```typescript
+import { MeetingDetector } from '@mostrom/meeting-detector';
+import type { MeetingSignal } from '@mostrom/meeting-detector';
+
+const detector = new MeetingDetector({ debug: true });
+
+detector.onMeeting((signal: MeetingSignal) => {
+  console.log(`${signal.process} is using ${signal.service}`);
+  if (signal.verdict === 'requested') {
+    console.log('🔴 Meeting started');
+  }
+});
+
+detector.onError((error) => {
+  console.error('Detection error:', error);
+});
+
+detector.start();
+
+// Later...
+detector.stop();
+```
+
+## API Reference
+
+### `detector(callback, options?)`
+Convenience function for simple usage.
+
+### `MeetingDetector` Class
+
+#### Constructor
+```typescript
+new MeetingDetector(options?: MeetingDetectorOptions)
+```
+
+#### Methods
+- `start(callback?)` - Start monitoring
+- `stop()` - Stop monitoring  
+- `isRunning()` - Check if running
+- `onMeeting(callback)` - Add meeting event listener
+- `onError(callback)` - Add error event listener
+
+#### Events
+- `meeting` - Emitted when meeting state changes
+- `error` - Emitted on errors
+- `exit` - Emitted when process exits
+
+## Example Output
+
+```json
+{
+  "event": "meeting_signal",
+  "timestamp": "2025-09-01T14:30:29Z",
+  "service": "microphone",
+  "verdict": "requested", 
+  "process": "Microsoft Teams WebView Helper",
+  "pid": "7390",
+  "front_app": "MSTeams",
+  "camera_active": true
+}
+```
+
+## TypeScript Types
+
+```typescript
+interface MeetingSignal {
+  event: 'meeting_signal';
+  timestamp: string;
+  service: 'microphone' | 'camera' | '';
+  verdict: 'requested' | 'allowed' | 'denied' | '';
+  process: string;
+  pid: string;
+  front_app: string;
+  camera_active: boolean;
+}
+
+interface MeetingDetectorOptions {
+  scriptPath?: string;  // Path to bash script (default: './meeting-detect.sh')
+  debug?: boolean;      // Enable debug logging (default: false)
+}
+```
+
+## Development
+
+```bash
+# Run in development mode
+npm run dev
+
+# Build TypeScript
+npm run build
+
+# Watch for changes
+npm run watch
+
+# Prepare for publishing
+npm run prepublishOnly
+```
+
+## Requirements
+
+- macOS 10.14+ (uses TCC privacy logs)
+- Node.js 14.0+
+- TypeScript 4.5+ (for development)
+
+## How It Works
+
+The detector runs a bash script that monitors macOS TCC (privacy) logs for microphone and camera access events. It uses:
+
+1. **TCC Log Streaming** - Monitors `com.apple.TCC` subsystem logs
+2. **Process Attribution** - Extracts PIDs from `target_token` fields  
+3. **Smart Deduplication** - Prevents spam from multi-process apps
+4. **State Tracking** - Only emits when meaningful changes occur
+
+## License
+
+MIT

package/dist/detector.d.ts

@@ -0,0 +1,56 @@
+import { EventEmitter } from 'node:events';
+import { MeetingDetectorOptions, MeetingEventCallback, ErrorEventCallback } from './types.js';
+export declare class MeetingDetector extends EventEmitter {
+    private process?;
+    private options;
+    private activeSessions;
+    constructor(options?: MeetingDetectorOptions);
+    /**
+     * Start monitoring for meeting signals
+     * @param callback Optional callback function for meeting events
+     */
+    start(callback?: MeetingEventCallback): void;
+    /**
+     * Stop monitoring
+     */
+    stop(): void;
+    /**
+     * Check if the detector is currently running
+     */
+    isRunning(): boolean;
+    /**
+     * Add a meeting event listener
+     */
+    onMeeting(callback: MeetingEventCallback): void;
+    /**
+     * Add an error event listener
+     */
+    onError(callback: ErrorEventCallback): void;
+    /**
+     * Comprehensive filtering to prevent false positives
+     * Filters out:
+     * - System processes (WebKit, SiriNCService, Chrome Helper, etc.)
+     * - Development tools (Electron, Terminal, Xcode)
+     * - Generic browser services (Chrome, Safari, Firefox)
+     * - Browser camera initialization (no window title + 'requested' verdict)
+     * - Google Meet signals without valid meeting URL patterns
+     */
+    private shouldIgnoreSignal;
+    /**
+     * Generate a unique session key based on the signal properties
+     */
+    private getSessionKey;
+    /**
+     * Check if this signal is a duplicate of an existing session
+     * Returns true if duplicate, false if new or expired session
+     */
+    private isDuplicateSession;
+    /**
+     * Clean up sessions that have expired
+     */
+    private cleanupExpiredSessions;
+    private parseSignal;
+    private transformAppName;
+}
+export declare function detector(callback: MeetingEventCallback, options?: MeetingDetectorOptions): MeetingDetector;
+//# sourceMappingURL=detector.d.ts.map

package/dist/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../src/detector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAiB,sBAAsB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAO7G,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,cAAc,CAAuC;gBAEjD,OAAO,GAAE,sBAA2B;IAgBhD;;;OAGG;IACI,KAAK,CAAC,QAAQ,CAAC,EAAE,oBAAoB,GAAG,IAAI;IAuEnD;;OAEG;IACI,IAAI,IAAI,IAAI;IAcnB;;OAEG;IACI,SAAS,IAAI,OAAO;IAI3B;;OAEG;IACI,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAItD;;OAEG;IACI,OAAO,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAIlD;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IA0E1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkB9B,OAAO,CAAC,WAAW;IA0BnB,OAAO,CAAC,gBAAgB;CAqDzB;AAGD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,eAAe,CAI1G"}

package/dist/detector.js

@@ -0,0 +1,339 @@
+import { spawn } from 'node:child_process';
+import { EventEmitter } from 'node:events';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+export class MeetingDetector extends EventEmitter {
+    constructor(options = {}) {
+        super();
+        this.activeSessions = new Map();
+        // Get the absolute path to the script relative to this package
+        const defaultScriptPath = options.scriptPath || join(dirname(fileURLToPath(import.meta.url)), '../meeting-detect.sh');
+        this.options = {
+            scriptPath: defaultScriptPath,
+            debug: options.debug || false,
+            sessionDeduplicationMs: options.sessionDeduplicationMs || 60000
+        };
+    }
+    /**
+     * Start monitoring for meeting signals
+     * @param callback Optional callback function for meeting events
+     */
+    start(callback) {
+        if (this.process) {
+            throw new Error('Detector is already running');
+        }
+        if (callback) {
+            this.on('meeting', callback);
+        }
+        this.process = spawn('sh', [this.options.scriptPath], {
+            stdio: ['pipe', 'pipe', 'pipe']
+        });
+        this.process.stdout?.on('data', (data) => {
+            const lines = data.toString().trim().split('\n');
+            for (const line of lines) {
+                if (line.trim()) {
+                    try {
+                        const signal = this.parseSignal(line);
+                        if (this.shouldIgnoreSignal(signal)) {
+                            if (this.options.debug) {
+                                console.log('[MeetingDetector] Ignoring signal:', signal);
+                            }
+                            continue;
+                        }
+                        if (this.isDuplicateSession(signal)) {
+                            if (this.options.debug) {
+                                console.log('[MeetingDetector] Skipping duplicate session:', signal);
+                            }
+                            continue;
+                        }
+                        if (this.options.debug) {
+                            console.log('[MeetingDetector] Parsed signal:', signal);
+                        }
+                        this.emit('meeting', signal);
+                    }
+                    catch (error) {
+                        if (this.options.debug) {
+                            console.log('[MeetingDetector] Failed to parse line:', line);
+                        }
+                        this.emit('error', new Error(`Failed to parse signal: ${line}`));
+                    }
+                }
+            }
+        });
+        this.process.stderr?.on('data', (data) => {
+            if (this.options.debug) {
+                console.log('[MeetingDetector] stderr:', data.toString());
+            }
+        });
+        this.process.on('error', (error) => {
+            this.emit('error', error);
+        });
+        this.process.on('exit', (code, signal) => {
+            if (this.options.debug) {
+                console.log(`[MeetingDetector] Process exited with code ${code}, signal ${signal}`);
+            }
+            this.process = undefined;
+            this.emit('exit', { code, signal });
+        });
+        if (this.options.debug) {
+            console.log('[MeetingDetector] Started monitoring');
+        }
+    }
+    /**
+     * Stop monitoring
+     */
+    stop() {
+        if (this.process) {
+            this.process.kill('SIGTERM');
+            this.process = undefined;
+            // Clear active sessions when stopping
+            this.activeSessions.clear();
+            if (this.options.debug) {
+                console.log('[MeetingDetector] Stopped monitoring');
+            }
+        }
+    }
+    /**
+     * Check if the detector is currently running
+     */
+    isRunning() {
+        return !!this.process;
+    }
+    /**
+     * Add a meeting event listener
+     */
+    onMeeting(callback) {
+        this.on('meeting', callback);
+    }
+    /**
+     * Add an error event listener
+     */
+    onError(callback) {
+        this.on('error', callback);
+    }
+    /**
+     * Comprehensive filtering to prevent false positives
+     * Filters out:
+     * - System processes (WebKit, SiriNCService, Chrome Helper, etc.)
+     * - Development tools (Electron, Terminal, Xcode)
+     * - Generic browser services (Chrome, Safari, Firefox)
+     * - Browser camera initialization (no window title + 'requested' verdict)
+     * - Google Meet signals without valid meeting URL patterns
+     */
+    shouldIgnoreSignal(signal) {
+        // System processes that should never trigger meeting detection
+        const systemProcessPatterns = [
+            'sirinc', // SiriNCService
+            'afplay', // macOS audio file player
+            'systemsoundserver', // System sound effects
+            'wavelink', // Audio routing software
+            'granola helper', // Screen recording helper
+            'webkit.gpu', // WebKit GPU process
+            'webkit.networking', // WebKit networking
+            'chrome helper', // Chrome helper processes (too generic)
+            'electron helper', // Electron helper processes
+        ];
+        // Services/apps that are too generic or development-related
+        const genericServices = [
+            'electron',
+            'terminal',
+            'granola',
+            'finder',
+            'xcode',
+            'tips',
+            'google chrome', // Generic Chrome service (not a specific meeting)
+            'safari', // Generic Safari service
+            'firefox', // Generic Firefox service
+            'microsoft edge', // Generic Edge service
+        ];
+        const processName = signal.process?.toLowerCase() || '';
+        const serviceName = signal.service?.toLowerCase() || '';
+        // Filter by process name patterns (partial match for flexibility)
+        if (systemProcessPatterns.some(pattern => processName.includes(pattern))) {
+            return true;
+        }
+        // Filter by exact generic service names
+        if (genericServices.includes(serviceName)) {
+            return true;
+        }
+        // Camera initialization filter: if verdict is 'requested' and window_title is empty,
+        // it's likely just camera initialization, not an actual meeting
+        // This applies to ALL apps to prevent false positives during camera setup
+        if (signal.verdict === 'requested' && (!signal.window_title || signal.window_title.trim() === '')) {
+            // Exception: if camera is actively being used (not just requested), allow it through
+            // This helps distinguish between "requesting permission" vs "actively in a call"
+            if (!signal.camera_active) {
+                return true;
+            }
+        }
+        // For Google Meet specifically: require window title to contain meeting URL patterns
+        // This prevents false positives from just opening Chrome with camera permissions
+        if (serviceName === 'google meet') {
+            const windowTitle = signal.window_title || '';
+            // Valid Google Meet windows should contain:
+            // - meet.google.com URL
+            // - "Meet - " prefix in title
+            // - Valid meeting code pattern (e.g., abc-defg-hij)
+            const hasValidMeetTitle = windowTitle.includes('meet.google.com') ||
+                windowTitle.includes('Meet - ') ||
+                /[a-z]{3}-[a-z]{4}-[a-z]{3}/.test(windowTitle); // Meeting code pattern
+            if (!hasValidMeetTitle) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Generate a unique session key based on the signal properties
+     */
+    getSessionKey(signal) {
+        return `${signal.pid}:${signal.service}:${signal.front_app}`;
+    }
+    /**
+     * Check if this signal is a duplicate of an existing session
+     * Returns true if duplicate, false if new or expired session
+     */
+    isDuplicateSession(signal) {
+        const sessionKey = this.getSessionKey(signal);
+        const now = Date.now();
+        const existingSession = this.activeSessions.get(sessionKey);
+        // Clean up expired sessions periodically
+        this.cleanupExpiredSessions();
+        if (existingSession) {
+            const timeSinceLastSeen = now - existingSession.lastSeen;
+            if (timeSinceLastSeen < this.options.sessionDeduplicationMs) {
+                // Update last seen time for existing session
+                existingSession.lastSeen = now;
+                return true; // This is a duplicate
+            }
+        }
+        // New session or expired session - track it
+        this.activeSessions.set(sessionKey, {
+            lastSeen: now,
+            signal
+        });
+        return false; // This is not a duplicate
+    }
+    /**
+     * Clean up sessions that have expired
+     */
+    cleanupExpiredSessions() {
+        const now = Date.now();
+        const expiredKeys = [];
+        for (const [key, session] of this.activeSessions.entries()) {
+            if (now - session.lastSeen > this.options.sessionDeduplicationMs) {
+                expiredKeys.push(key);
+            }
+        }
+        for (const key of expiredKeys) {
+            this.activeSessions.delete(key);
+            if (this.options.debug) {
+                console.log(`[MeetingDetector] Cleaned up expired session: ${key}`);
+            }
+        }
+    }
+    parseSignal(line) {
+        const signal = JSON.parse(line);
+        // Use transformed app name as service if the original service is a system service like 'microphone' or 'camera'
+        const originalService = signal.service || '';
+        const transformedService = this.transformAppName(signal.front_app, signal.process);
+        const finalService = (originalService === 'microphone' || originalService === 'camera' || !originalService)
+            ? transformedService
+            : originalService;
+        return {
+            event: signal.event,
+            timestamp: signal.timestamp,
+            service: finalService,
+            verdict: signal.verdict || '',
+            process: signal.process || '',
+            pid: signal.pid || '',
+            parent_pid: signal.parent_pid || '',
+            process_path: signal.process_path || '',
+            front_app: signal.front_app || '',
+            window_title: signal.window_title || '',
+            session_id: signal.session_id || '',
+            camera_active: signal.camera_active === 'true' || signal.camera_active === true
+        };
+    }
+    transformAppName(frontApp, process) {
+        const app = frontApp?.toLowerCase() || '';
+        const proc = process?.toLowerCase() || '';
+        if (app.includes('slack') || proc.includes('slack')) {
+            return 'Slack';
+        }
+        else if (app.includes('msteams') || proc.includes('microsoft teams') || proc.includes('teams')) {
+            return 'Microsoft Teams';
+        }
+        else if (app.includes('zoom') || proc.includes('zoom')) {
+            return 'Zoom';
+        }
+        else if (app.includes('webex') || proc.includes('webex') || proc.includes('cisco webex')) {
+            return 'Webex';
+        }
+        else if (app.includes('google meet') || proc.includes('google meet') || proc.includes('meet.google.com') || (app.includes('chrome') && proc.includes('chrome'))) {
+            return 'Google Meet';
+        }
+        else if (app.includes('skype') || proc.includes('skype')) {
+            return 'Skype';
+        }
+        else if (app.includes('discord') || proc.includes('discord')) {
+            return 'Discord';
+        }
+        else if (app.includes('facetime') || proc.includes('facetime')) {
+            return 'FaceTime';
+        }
+        else if (app.includes('gotomeeting') || proc.includes('gotomeeting') || proc.includes('goto meeting')) {
+            return 'GoToMeeting';
+        }
+        else if (app.includes('bluejeans') || proc.includes('bluejeans') || proc.includes('blue jeans')) {
+            return 'BlueJeans';
+        }
+        else if (app.includes('jitsi') || proc.includes('jitsi')) {
+            return 'Jitsi Meet';
+        }
+        else if (app.includes('whereby') || proc.includes('whereby')) {
+            return 'Whereby';
+        }
+        else if (app.includes('8x8') || proc.includes('8x8')) {
+            return '8x8';
+        }
+        else if (app.includes('ringcentral') || proc.includes('ringcentral') || proc.includes('ring central')) {
+            return 'RingCentral';
+        }
+        else if (app.includes('bigbluebutton') || proc.includes('bigbluebutton') || proc.includes('big blue button')) {
+            return 'BigBlueButton';
+        }
+        else if (app.includes('chime') || proc.includes('chime') || proc.includes('amazon chime')) {
+            return 'Amazon Chime';
+        }
+        else if (app.includes('hangouts') || proc.includes('hangouts') || proc.includes('google hangouts')) {
+            return 'Google Hangouts';
+        }
+        else if (app.includes('adobe connect') || proc.includes('adobe connect')) {
+            return 'Adobe Connect';
+        }
+        else if (app.includes('teamviewer') || proc.includes('teamviewer')) {
+            return 'TeamViewer';
+        }
+        else if (app.includes('anydesk') || proc.includes('anydesk')) {
+            return 'AnyDesk';
+        }
+        else if (app.includes('clickmeeting') || proc.includes('clickmeeting')) {
+            return 'ClickMeeting';
+        }
+        else if (app.includes('appear.in') || proc.includes('appear.in')) {
+            return 'Appear.in';
+        }
+        else {
+            // Fallback to front_app if no match
+            return frontApp || 'Meeting App';
+        }
+    }
+}
+// Convenience function for simple usage
+export function detector(callback, options) {
+    const detector = new MeetingDetector(options);
+    detector.start(callback);
+    return detector;
+}
+//# sourceMappingURL=detector.js.map

package/dist/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../src/detector.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { MeetingDetector, detector } from './detector.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1D,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+import { detector } from './detector.js';
+// Main exports
+export { MeetingDetector, detector } from './detector.js';
+export * from './types.js';
+// Example usage (only when run directly)
+if (import.meta.url === `file://${process.argv[1]}`) {
+    console.log('🔍 Starting meeting detector...');
+    const meetingDetector = detector((stateChange) => {
+        console.log('📱 Meeting signal:', stateChange);
+    }, { debug: true });
+    // Graceful shutdown
+    process.on('SIGINT', () => {
+        console.log('\n⏹️  Stopping meeting detector...');
+        meetingDetector.stop();
+        process.exit(0);
+    });
+    process.on('SIGTERM', () => {
+        meetingDetector.stop();
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,eAAe;AACf,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1D,cAAc,YAAY,CAAC;AAE3B,yCAAyC;AACzC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAE/C,MAAM,eAAe,GAAG,QAAQ,CAAC,CAAC,WAA0B,EAAE,EAAE;QAC9D,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpB,oBAAoB;IACpB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAClD,eAAe,CAAC,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,eAAe,CAAC,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,39 @@
+export interface MeetingSignal {
+    event: 'meeting_signal';
+    timestamp: string;
+    service: 'microphone' | 'camera' | '';
+    verdict: 'requested' | 'allowed' | 'denied' | '';
+    process: string;
+    pid: string;
+    parent_pid: string;
+    process_path: string;
+    front_app: string;
+    window_title: string;
+    session_id: string;
+    camera_active: boolean;
+}
+export interface ProcessExit {
+    code: number | null;
+    signal: NodeJS.Signals | null;
+}
+export interface MeetingDetectorOptions {
+    /**
+     * Path to the meeting-detect.sh script
+     * @default './meeting-detect.sh'
+     */
+    scriptPath?: string;
+    /**
+     * Enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Session deduplication window in milliseconds
+     * Signals from the same session within this window will be ignored
+     * @default 60000 (60 seconds)
+     */
+    sessionDeduplicationMs?: number;
+}
+export type MeetingEventCallback = (signal: MeetingSignal) => void;
+export type ErrorEventCallback = (error: Error) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,gBAAgB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,YAAY,GAAG,QAAQ,GAAG,EAAE,CAAC;IACtC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,EAAE,CAAC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;AACnE,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/meeting-detect.sh

@@ -0,0 +1,211 @@
+# detect-meeting.sh
+# Purpose: Heuristically detect when *any* desktop meeting app starts a meeting by
+# watching for microphone/camera access grants in macOS Unified Logs (TCC)
+# and correlating with the frontmost app at that moment. Prints compact JSON lines.
+#
+# Notes:
+# - This is app-agnostic: Zoom, Slack Huddles, Meet (via Chrome), Teams, Webex, etc.
+# - Triggers on first-time (or resumed) mic/camera usage events emitted by TCC.
+# - Requires no special entitlements; may miss events if the app had continuous access
+#   without re-requesting. That’s why we also add a lightweight camera process probe.
+#
+# Usage: bash detect-meeting.sh
+# Stop  : Ctrl+C
+
+set -euo pipefail
+
+# --- util: print JSON safely ---
+json() {
+  # args: key=value ...
+  # converts to {"key":"value", ...} with basic escaping
+  local kv out="{" first=1
+  for kv in "$@"; do
+    key="${kv%%=*}"; val="${kv#*=}"
+    # escape quotes and backslashes
+    val="${val//\\/\\\\}"; val="${val//\"/\\\"}"
+    if [[ $first -eq 0 ]]; then out+=", "; fi
+    out+="\"$key\":\"$val\""; first=0
+  done
+  out+="}"
+  printf '%s\n' "$out"
+}
+
+# --- util: get frontmost app name (best-effort) ---
+front_app() {
+  /usr/bin/osascript -e 'tell application "System Events" to get name of first process whose frontmost is true' 2>/dev/null || echo ""
+}
+
+# --- util: get active window title ---
+window_title() {
+  /usr/bin/osascript -e 'tell application "System Events" to get title of front window of first process whose frontmost is true' 2>/dev/null || echo ""
+}
+
+# --- util: get parent PID ---
+parent_pid() {
+  local pid="$1"
+  if [[ -n "$pid" ]]; then
+    ps -o ppid= -p "$pid" 2>/dev/null | tr -d ' ' || echo ""
+  else
+    echo ""
+  fi
+}
+
+# --- util: get process path ---
+process_path() {
+  local pid="$1"
+  if [[ -n "$pid" ]]; then
+    ps -o command= -p "$pid" 2>/dev/null | awk '{print $1}' || echo ""
+  else
+    echo ""
+  fi
+}
+
+# --- util: get session ID ---
+session_id() {
+  who -m 2>/dev/null | awk '{print $2}' | head -1 || echo ""
+}
+
+# --- util: quick camera-in-use heuristic (VDCAssistant/AppleCameraAssistant presence) ---
+camera_active() {
+  if pgrep -xq "VDCAssistant" || pgrep -xq "AppleCameraAssistant"; then
+    echo "true"
+  else
+    echo "false"
+  fi
+}
+
+# --- util: normalize app names to main app (reduces Teams/Chrome helper noise) ---
+normalize_app() {
+  local process_name="$1"
+  
+  # Microsoft Teams - all helpers normalize to "Microsoft Teams"
+  if [[ "$process_name" == *"Microsoft Teams"* ]]; then
+    echo "Microsoft Teams"
+  # Google Chrome - all helpers normalize to "Google Chrome"  
+  elif [[ "$process_name" == *"Google Chrome"* ]] || [[ "$process_name" == *"Chrome Helper"* ]]; then
+    echo "Google Chrome"
+  # Slack - all helpers normalize to "Slack"
+  elif [[ "$process_name" == *"Slack"* ]]; then
+    echo "Slack"
+  # Default - return as-is
+  else
+    echo "$process_name"
+  fi
+}
+
+# --- state tracking variables to prevent duplicate logs ---
+prev_camera_active=""
+prev_front_app=""
+prev_service=""
+prev_verdict=""
+prev_process=""
+prev_pid=""
+prev_main_app=""
+last_log_time=0
+
+# --- multi-line TCC parsing state ---
+current_svc=""
+current_pid=""
+current_app=""
+current_verdict=""
+
+# --- stream TCC (privacy) log events for mic/camera access ---
+# We look for kTCCServiceMicrophone / kTCCServiceCamera "Access Allowed"/"Auth Granted".
+/usr/bin/log stream \
+  --style syslog \
+  --predicate 'subsystem == "com.apple.TCC" AND (eventMessage CONTAINS[c] "kTCCServiceMicrophone" OR eventMessage CONTAINS[c] "kTCCServiceCamera")' \
+  2>/dev/null | \
+while IFS= read -r line; do
+  # --- accumulate multi-line TCC log info ---
+  
+  # Parse service type and save to current state
+  if [[ "$line" == *"kTCCServiceMicrophone"* ]]; then
+    current_svc="microphone"
+  elif [[ "$line" == *"kTCCServiceCamera"* ]]; then
+    current_svc="camera"
+  fi
+
+  # Parse verdict and save to current state
+  if [[ "$line" == *"Access Allowed"* ]] || [[ "$line" == *"Auth Granted"* ]] || [[ "$line" == *"Allow"* ]]; then
+    current_verdict="allowed"
+  elif [[ "$line" == *"Denied"* ]]; then
+    current_verdict="denied"
+  elif [[ "$line" == *"FORWARD"* ]]; then
+    current_verdict="requested"
+  fi
+
+  # Parse target PID - when we find this, we have enough info to emit
+  if [[ "$line" =~ target_token=\{pid:([0-9]+) ]]; then
+    current_pid="${BASH_REMATCH[1]}"
+    # Get process info from PID
+    if [[ -n "$current_pid" ]]; then
+      current_app_full=$(ps -p "$current_pid" -o comm= 2>/dev/null | tail -1)
+      # Extract just the app name from full path (e.g., "Google Chrome Helper" from long path)
+      current_app=$(basename "$current_app_full" 2>/dev/null || echo "$current_app_full")
+      
+      # Get additional process details
+      current_parent_pid=$(parent_pid "$current_pid")
+      current_process_path=$(process_path "$current_pid")
+    fi
+    
+    # --- we now have complete info, check if we should emit ---
+    if [[ -n "$current_svc" ]] && [[ -n "$current_pid" ]]; then
+      ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+      fg_app="$(front_app)"
+      cam_now="$(camera_active)"
+      win_title="$(window_title)"
+      sess_id="$(session_id)"
+      
+      # Normalize app name to reduce Teams/Chrome helper noise
+      normalized_app=$(normalize_app "$current_app")
+      
+      # Get current timestamp for time-based deduplication
+      current_time=$(date +%s)
+      
+      # Create state string focusing on actual meeting process, not front app switching
+      # Only track: camera status + service + normalized app (ignore front_app changes)
+      current_state="${cam_now}|${current_svc}|${normalized_app}"
+      previous_state="${prev_camera_active}|${prev_service}|${prev_main_app}"
+      
+      # Calculate time since last log
+      time_diff=$((current_time - last_log_time))
+      
+      # Log if there's a meaningful change OR enough time has passed (10 seconds cooldown)
+      # This allows new meetings while preventing Teams helper process spam
+      if [[ "$current_state" != "$previous_state" ]] || [[ $time_diff -ge 10 ]]; then
+        # State changed - emit JSON
+        json \
+          event="meeting_signal" \
+          timestamp="$ts" \
+          service="$current_svc" \
+          verdict="$current_verdict" \
+          process="$current_app" \
+          pid="$current_pid" \
+          parent_pid="$current_parent_pid" \
+          process_path="$current_process_path" \
+          front_app="$fg_app" \
+          window_title="$win_title" \
+          session_id="$sess_id" \
+          camera_active="$cam_now"
+        
+        # Update previous state
+        prev_camera_active="$cam_now"
+        prev_front_app="$fg_app"  # Still track for JSON output
+        prev_service="$current_svc"
+        prev_verdict="$current_verdict"
+        prev_process="$current_app"
+        prev_pid="$current_pid"
+        prev_main_app="$normalized_app"
+        last_log_time="$current_time"
+      fi
+      
+      # Reset current state for next TCC entry
+      current_svc=""
+      current_pid=""
+      current_app=""
+      current_verdict=""
+      current_parent_pid=""
+      current_process_path=""
+    fi
+  fi
+done

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@mostrom/meeting-detector",
+  "version": "1.0.0",
+  "description": "Real-time meeting detection for macOS desktop apps",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/**/*",
+    "meeting-detect.sh",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "start": "node dist/index.js",
+    "watch": "tsc -w",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["meeting", "detection", "macos", "tcc", "privacy"],
+  "author": "Kaiser White <kaise@mostrom.io>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kaisewhite/meeting-detector.git"
+  },
+  "homepage": "https://github.com/kaisewhite/meeting-detector#readme",
+  "bugs": {
+    "url": "https://github.com/kaisewhite/meeting-detector/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "ts-node": "^10.9.0",
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {},
+  "os": ["darwin"],
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}