stelo 1.0.1

package/dist/process.js

@@ -0,0 +1,326 @@
+"use strict";
+// ============================================================================
+// Stelo — Process Management
+// ============================================================================
+// Process discovery, tracking, lifecycle management, and foreground
+// process monitoring using the existing window API.
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.process_manager = void 0;
+const events_1 = require("./events");
+const logger_1 = require("./logger");
+// ── Internal ─────────────────────────────────────────────────────────────────
+let _watchInterval = null;
+let _lastForegroundPid = null;
+let _lastForegroundInfo = null;
+const _foregroundHistory = [];
+const MAX_FOREGROUND_HISTORY = 100;
+const _log = logger_1.logger.child('process');
+function getNative() {
+    try {
+        return require('../index.js');
+    }
+    catch {
+        return null;
+    }
+}
+function windowToProcess(w) {
+    return {
+        pid: w.processId,
+        name: w.processName,
+        title: w.title,
+        windowId: w.id,
+        bounds: { x: w.x, y: w.y, width: w.width, height: w.height },
+        isVisible: w.isVisible,
+        isMinimized: w.isMinimized,
+    };
+}
+// ── Public API ───────────────────────────────────────────────────────────────
+exports.process_manager = {
+    /**
+     * List all visible processes (via window enumeration).
+     */
+    list() {
+        const native = getNative();
+        if (!native)
+            return [];
+        try {
+            const windows = native.windowGetAll();
+            // Deduplicate by PID (keep first/most relevant window)
+            const seen = new Map();
+            for (const w of windows) {
+                const proc = windowToProcess(w);
+                if (!seen.has(proc.pid)) {
+                    seen.set(proc.pid, proc);
+                }
+            }
+            return [...seen.values()];
+        }
+        catch (err) {
+            _log.error('Failed to list processes', err);
+            return [];
+        }
+    },
+    /**
+     * Find processes by name (case-insensitive partial match).
+     */
+    findByName(name) {
+        const lower = name.toLowerCase();
+        return exports.process_manager.list().filter((p) => p.name.toLowerCase().includes(lower));
+    },
+    /**
+     * Find processes by window title (case-insensitive partial match).
+     */
+    findByTitle(title) {
+        const native = getNative();
+        if (!native)
+            return [];
+        try {
+            const windows = native.windowFind(title);
+            return windows.map(windowToProcess);
+        }
+        catch (err) {
+            _log.error('Failed to find process by title', err);
+            return [];
+        }
+    },
+    /**
+     * Get the currently focused/foreground process.
+     */
+    getForeground() {
+        const native = getNative();
+        if (!native)
+            return null;
+        try {
+            const active = native.windowGetActive();
+            return windowToProcess(active);
+        }
+        catch (err) {
+            _log.error('Failed to get foreground process', err);
+            return null;
+        }
+    },
+    /**
+     * Focus a process by name (brings its window to front).
+     */
+    focus(name) {
+        const native = getNative();
+        if (!native)
+            return false;
+        try {
+            native.windowFocusByTitle(name);
+            return true;
+        }
+        catch {
+            // Try finding by process name
+            const procs = exports.process_manager.findByName(name);
+            if (procs.length > 0) {
+                try {
+                    native.windowFocus(procs[0].windowId);
+                    return true;
+                }
+                catch {
+                    return false;
+                }
+            }
+            return false;
+        }
+    },
+    /**
+     * Focus a process by PID.
+     */
+    focusByPid(pid) {
+        const native = getNative();
+        if (!native)
+            return false;
+        const proc = exports.process_manager.list().find((p) => p.pid === pid);
+        if (!proc)
+            return false;
+        try {
+            native.windowFocus(proc.windowId);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    /**
+     * Close a process window by name.
+     */
+    close(name) {
+        const native = getNative();
+        if (!native)
+            return false;
+        const procs = exports.process_manager.findByName(name);
+        if (procs.length === 0)
+            return false;
+        try {
+            native.windowClose(procs[0].windowId);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    /**
+     * Wait for a process/window to appear.
+     */
+    async waitFor(name, timeoutMs = 30000, pollIntervalMs = 500) {
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            const procs = exports.process_manager.findByName(name);
+            if (procs.length > 0)
+                return procs[0];
+            const byTitle = exports.process_manager.findByTitle(name);
+            if (byTitle.length > 0)
+                return byTitle[0];
+            await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+        }
+        return null;
+    },
+    /**
+     * Wait for a process to close/disappear.
+     */
+    async waitForClose(name, timeoutMs = 30000, pollIntervalMs = 500) {
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            const procs = exports.process_manager.findByName(name);
+            const byTitle = exports.process_manager.findByTitle(name);
+            if (procs.length === 0 && byTitle.length === 0)
+                return true;
+            await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+        }
+        return false;
+    },
+    /**
+     * Launch a process/application.
+     */
+    async launch(command, args) {
+        try {
+            const { spawn } = require('child_process');
+            const child = spawn(command, args ?? [], {
+                detached: true,
+                stdio: 'ignore',
+            });
+            child.unref();
+            events_1.events.emit('process.launch', 'process', {
+                command,
+                args,
+                pid: child.pid,
+            }, { source: 'process' });
+            return child.pid ?? null;
+        }
+        catch (err) {
+            _log.error('Failed to launch process', err, { command, args });
+            return null;
+        }
+    },
+    /**
+     * Kill a process by PID.
+     */
+    kill(pid, signal = 'SIGTERM') {
+        if (!Number.isInteger(pid) || pid <= 0) {
+            _log.error('Invalid PID', undefined, { pid });
+            return false;
+        }
+        try {
+            const p = require('process');
+            p.kill(pid, signal);
+            events_1.events.emit('process.kill', 'process', { pid, signal }, { source: 'process' });
+            return true;
+        }
+        catch (err) {
+            _log.error('Failed to kill process', err, { pid, signal });
+            return false;
+        }
+    },
+    // ── Foreground Monitoring ──────────────────────────────────────────────
+    /**
+     * Start monitoring foreground process changes.
+     */
+    startWatching(options) {
+        if (_watchInterval)
+            return;
+        const intervalMs = options?.intervalMs ?? 500;
+        const trackForeground = options?.trackForeground ?? true;
+        _log.info('Process watcher started', { intervalMs });
+        _watchInterval = setInterval(() => {
+            if (!trackForeground)
+                return;
+            const current = exports.process_manager.getForeground();
+            if (!current)
+                return;
+            if (current.pid !== _lastForegroundPid) {
+                const change = {
+                    previous: _lastForegroundInfo ?? undefined,
+                    current,
+                    timestamp: new Date().toISOString(),
+                };
+                _foregroundHistory.push(change);
+                while (_foregroundHistory.length > MAX_FOREGROUND_HISTORY) {
+                    _foregroundHistory.shift();
+                }
+                _lastForegroundPid = current.pid;
+                _lastForegroundInfo = current;
+                events_1.events.emit('process.foreground_change', 'process', {
+                    previousName: change.previous?.name,
+                    currentName: current.name,
+                    currentTitle: current.title,
+                    pid: current.pid,
+                }, { source: 'process' });
+            }
+        }, intervalMs);
+    },
+    /**
+     * Stop monitoring.
+     */
+    stopWatching() {
+        if (_watchInterval) {
+            clearInterval(_watchInterval);
+            _watchInterval = null;
+            _log.info('Process watcher stopped');
+        }
+    },
+    /** Is the watcher running? */
+    isWatching() {
+        return _watchInterval !== null;
+    },
+    /**
+     * Get foreground process change history.
+     */
+    getForegroundHistory() {
+        return [..._foregroundHistory];
+    },
+    /**
+     * Get how long the current foreground process has been active (ms).
+     */
+    getForegroundDuration() {
+        if (_foregroundHistory.length === 0)
+            return 0;
+        const last = _foregroundHistory[_foregroundHistory.length - 1];
+        return Date.now() - new Date(last.timestamp).getTime();
+    },
+    /**
+     * Wait until a specific process becomes the foreground window.
+     */
+    async waitForForeground(name, timeoutMs = 30000, pollIntervalMs = 300) {
+        const lower = name.toLowerCase();
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            const fg = exports.process_manager.getForeground();
+            if (fg && (fg.name.toLowerCase().includes(lower) || fg.title.toLowerCase().includes(lower))) {
+                return fg;
+            }
+            await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+        }
+        return null;
+    },
+    /** Reset the module */
+    reset() {
+        exports.process_manager.stopWatching();
+        _lastForegroundPid = null;
+        _lastForegroundInfo = null;
+        _foregroundHistory.length = 0;
+    },
+};
+//# sourceMappingURL=process.js.map

package/dist/process.js.map

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

package/dist/recorder.d.ts

@@ -0,0 +1,100 @@
+import type { AutomationEvent, PlaybackOptions, MouseButton, ScrollDirection } from './types';
+/**
+ * Automation recorder and playback engine.
+ *
+ * @example
+ * ```typescript
+ * import { recorder } from 'stelo';
+ *
+ * // Build a sequence programmatically
+ * const sequence = recorder.sequence()
+ *   .moveTo(100, 200)
+ *   .click()
+ *   .delay(500)
+ *   .type('Hello World')
+ *   .hotkey('ctrl', 's')
+ *   .build();
+ *
+ * // Execute the sequence
+ * await recorder.play(sequence);
+ *
+ * // Replay at 2x speed
+ * await recorder.play(sequence, { speed: 2 });
+ *
+ * // Export/Import
+ * const json = recorder.toJSON(sequence);
+ * const loaded = recorder.fromJSON(json);
+ * ```
+ */
+export declare const recorder: {
+    /**
+     * Create a new sequence builder.
+     */
+    sequence(): SequenceBuilder;
+    /**
+     * Play back a recorded sequence of automation events.
+     */
+    play(events: AutomationEvent[], options?: PlaybackOptions): Promise<void>;
+    /**
+     * Serialize a sequence to JSON string.
+     */
+    toJSON(events: AutomationEvent[]): string;
+    /**
+     * Deserialize a sequence from JSON string.
+     */
+    fromJSON(json: string): AutomationEvent[];
+};
+declare class SequenceBuilder {
+    private events;
+    private currentTime;
+    /**
+     * Move mouse to position.
+     */
+    moveTo(x: number, y: number): this;
+    /**
+     * Click at current position.
+     */
+    click(button?: MouseButton): this;
+    /**
+     * Mouse button down.
+     */
+    mouseDown(button?: MouseButton): this;
+    /**
+     * Mouse button up.
+     */
+    mouseUp(button?: MouseButton): this;
+    /**
+     * Scroll mouse wheel.
+     */
+    scroll(amount: number, direction?: ScrollDirection): this;
+    /**
+     * Press and release a key.
+     */
+    press(key: string): this;
+    /**
+     * Hold a key down.
+     */
+    keyDown(key: string): this;
+    /**
+     * Release a key.
+     */
+    keyUp(key: string): this;
+    /**
+     * Type text string.
+     */
+    type(text: string): this;
+    /**
+     * Execute a keyboard shortcut.
+     */
+    hotkey(...keys: string[]): this;
+    /**
+     * Add a delay between actions.
+     */
+    delay(ms: number): this;
+    /**
+     * Build the sequence into an array of events.
+     */
+    build(): AutomationEvent[];
+}
+export {};
+//# sourceMappingURL=recorder.d.ts.map

package/dist/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../ts/recorder.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAM9F;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,QAAQ;IACnB;;OAEG;gBACS,eAAe;IAI3B;;OAEG;iBACgB,eAAe,EAAE,YAAY,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/E;;OAEG;mBACY,eAAe,EAAE,GAAG,MAAM;IAIzC;;OAEG;mBACY,MAAM,GAAG,eAAe,EAAE;CAG1C,CAAC;AAIF,cAAM,eAAe;IACnB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,WAAW,CAAK;IAExB;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAUlC;;OAEG;IACH,KAAK,CAAC,MAAM,GAAE,WAAoB,GAAG,IAAI;IAWzC;;OAEG;IACH,SAAS,CAAC,MAAM,GAAE,WAAoB,GAAG,IAAI;IAW7C;;OAEG;IACH,OAAO,CAAC,MAAM,GAAE,WAAoB,GAAG,IAAI;IAW3C;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,eAAsB,GAAG,IAAI;IAU/D;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IASxB;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAS1B;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IASxB;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASxB;;OAEG;IACH,MAAM,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAmB/B;;OAEG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IASvB;;OAEG;IACH,KAAK,IAAI,eAAe,EAAE;CAG3B"}

package/dist/recorder.js

@@ -0,0 +1,258 @@
+"use strict";
+// ============================================================================
+// Stelo — Automation Recorder & Playback Engine
+// ============================================================================
+// Record user actions, replay them with timing, export/import sequences.
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recorder = void 0;
+const mouse_1 = require("./mouse");
+const keyboard_1 = require("./keyboard");
+const native = require('../index.js');
+/**
+ * Automation recorder and playback engine.
+ *
+ * @example
+ * ```typescript
+ * import { recorder } from 'stelo';
+ *
+ * // Build a sequence programmatically
+ * const sequence = recorder.sequence()
+ *   .moveTo(100, 200)
+ *   .click()
+ *   .delay(500)
+ *   .type('Hello World')
+ *   .hotkey('ctrl', 's')
+ *   .build();
+ *
+ * // Execute the sequence
+ * await recorder.play(sequence);
+ *
+ * // Replay at 2x speed
+ * await recorder.play(sequence, { speed: 2 });
+ *
+ * // Export/Import
+ * const json = recorder.toJSON(sequence);
+ * const loaded = recorder.fromJSON(json);
+ * ```
+ */
+exports.recorder = {
+    /**
+     * Create a new sequence builder.
+     */
+    sequence() {
+        return new SequenceBuilder();
+    },
+    /**
+     * Play back a recorded sequence of automation events.
+     */
+    async play(events, options) {
+        const speed = options?.speed ?? 1.0;
+        const repeat = options?.repeat ?? 1;
+        for (let r = 0; r < repeat; r++) {
+            for (const event of events) {
+                await executeEvent(event, speed);
+            }
+        }
+    },
+    /**
+     * Serialize a sequence to JSON string.
+     */
+    toJSON(events) {
+        return JSON.stringify(events, null, 2);
+    },
+    /**
+     * Deserialize a sequence from JSON string.
+     */
+    fromJSON(json) {
+        return JSON.parse(json);
+    },
+};
+// ── Sequence Builder ────────────────────────────────────────────────────────
+class SequenceBuilder {
+    events = [];
+    currentTime = 0;
+    /**
+     * Move mouse to position.
+     */
+    moveTo(x, y) {
+        this.events.push({
+            type: 'mouseMove',
+            x,
+            y,
+            timestamp: this.currentTime,
+        });
+        return this;
+    }
+    /**
+     * Click at current position.
+     */
+    click(button = 'left') {
+        this.events.push({
+            type: 'mouseClick',
+            button,
+            x: 0,
+            y: 0,
+            timestamp: this.currentTime,
+        });
+        return this;
+    }
+    /**
+     * Mouse button down.
+     */
+    mouseDown(button = 'left') {
+        this.events.push({
+            type: 'mouseDown',
+            button,
+            x: 0,
+            y: 0,
+            timestamp: this.currentTime,
+        });
+        return this;
+    }
+    /**
+     * Mouse button up.
+     */
+    mouseUp(button = 'left') {
+        this.events.push({
+            type: 'mouseUp',
+            button,
+            x: 0,
+            y: 0,
+            timestamp: this.currentTime,
+        });
+        return this;
+    }
+    /**
+     * Scroll mouse wheel.
+     */
+    scroll(amount, direction = 'up') {
+        this.events.push({
+            type: 'mouseScroll',
+            amount,
+            direction,
+            timestamp: this.currentTime,
+        });
+        return this;
+    }
+    /**
+     * Press and release a key.
+     */
+    press(key) {
+        this.events.push({
+            type: 'keyPress',
+            key,
+            timestamp: this.currentTime,
+        });
+        return this;
+    }
+    /**
+     * Hold a key down.
+     */
+    keyDown(key) {
+        this.events.push({
+            type: 'keyDown',
+            key,
+            timestamp: this.currentTime,
+        });
+        return this;
+    }
+    /**
+     * Release a key.
+     */
+    keyUp(key) {
+        this.events.push({
+            type: 'keyUp',
+            key,
+            timestamp: this.currentTime,
+        });
+        return this;
+    }
+    /**
+     * Type text string.
+     */
+    type(text) {
+        this.events.push({
+            type: 'typeText',
+            text,
+            timestamp: this.currentTime,
+        });
+        return this;
+    }
+    /**
+     * Execute a keyboard shortcut.
+     */
+    hotkey(...keys) {
+        // Expand as keyDown + keyUp sequence
+        for (const key of keys) {
+            this.events.push({
+                type: 'keyDown',
+                key,
+                timestamp: this.currentTime,
+            });
+        }
+        for (const key of [...keys].reverse()) {
+            this.events.push({
+                type: 'keyUp',
+                key,
+                timestamp: this.currentTime,
+            });
+        }
+        return this;
+    }
+    /**
+     * Add a delay between actions.
+     */
+    delay(ms) {
+        this.currentTime += ms;
+        this.events.push({
+            type: 'delay',
+            duration: ms,
+        });
+        return this;
+    }
+    /**
+     * Build the sequence into an array of events.
+     */
+    build() {
+        return [...this.events];
+    }
+}
+// ── Event Executor ──────────────────────────────────────────────────────────
+async function executeEvent(event, speed) {
+    switch (event.type) {
+        case 'mouseMove':
+            mouse_1.mouse.move(event.x, event.y);
+            break;
+        case 'mouseClick':
+            mouse_1.mouse.click(event.button);
+            break;
+        case 'mouseDown':
+            mouse_1.mouse.down(event.button);
+            break;
+        case 'mouseUp':
+            mouse_1.mouse.up(event.button);
+            break;
+        case 'mouseScroll':
+            mouse_1.mouse.scroll(event.amount, event.direction);
+            break;
+        case 'keyPress':
+            keyboard_1.keyboard.press(event.key);
+            break;
+        case 'keyDown':
+            keyboard_1.keyboard.down(event.key);
+            break;
+        case 'keyUp':
+            keyboard_1.keyboard.up(event.key);
+            break;
+        case 'typeText':
+            keyboard_1.keyboard.type(event.text);
+            break;
+        case 'delay': {
+            const duration = Math.round(event.duration / speed);
+            await new Promise((resolve) => setTimeout(resolve, duration));
+            break;
+        }
+    }
+}
+//# sourceMappingURL=recorder.js.map