stelo 1.0.1

package/dist/clipboard.js

@@ -0,0 +1,352 @@
+"use strict";
+// ============================================================================
+// Stelo — Clipboard Module
+// ============================================================================
+// Read/write clipboard text and images, clipboard monitoring, content type
+// detection, and clipboard history tracking.
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clipboard = void 0;
+const events_1 = require("./events");
+const logger_1 = require("./logger");
+// ── Internal State ───────────────────────────────────────────────────────────
+const _history = [];
+let _maxHistory = 100;
+let _watchInterval = null;
+let _lastHash = '';
+const _log = logger_1.logger.child('clipboard');
+function simpleHash(str) {
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash |= 0;
+    }
+    return hash.toString(36);
+}
+function getNative() {
+    try {
+        return require('../index.js');
+    }
+    catch {
+        return null;
+    }
+}
+// ── Clipboard Operations ─────────────────────────────────────────────────────
+exports.clipboard = {
+    /**
+     * Read text from the clipboard.
+     *
+     * Uses keyboard shortcut approach if no native clipboard API is available.
+     * For best results, ensure the active window supports Ctrl+V pasting.
+     */
+    async readText() {
+        try {
+            // Try using PowerShell to read clipboard (Windows)
+            if (process.platform === 'win32') {
+                const { execSync } = require('child_process');
+                const result = execSync('powershell -command "Get-Clipboard"', {
+                    encoding: 'utf-8',
+                    timeout: 5000,
+                    windowsHide: true,
+                });
+                return result.trimEnd();
+            }
+            // macOS
+            if (process.platform === 'darwin') {
+                const { execSync } = require('child_process');
+                return execSync('pbpaste', { encoding: 'utf-8', timeout: 5000 });
+            }
+            // Linux
+            if (process.platform === 'linux') {
+                const { execSync } = require('child_process');
+                try {
+                    return execSync('xclip -selection clipboard -o', { encoding: 'utf-8', timeout: 5000 });
+                }
+                catch {
+                    return execSync('xsel --clipboard --output', { encoding: 'utf-8', timeout: 5000 });
+                }
+            }
+            return '';
+        }
+        catch (err) {
+            _log.error('Failed to read clipboard', err);
+            return '';
+        }
+    },
+    /**
+     * Write text to the clipboard.
+     */
+    async writeText(text) {
+        try {
+            if (process.platform === 'win32') {
+                const { execSync } = require('child_process');
+                // Pipe text via stdin to avoid command injection
+                execSync('powershell -NoProfile -NonInteractive -Command "$input | Set-Clipboard"', {
+                    input: text,
+                    timeout: 5000,
+                    windowsHide: true,
+                });
+            }
+            else if (process.platform === 'darwin') {
+                const { execSync } = require('child_process');
+                execSync('pbcopy', { input: text, timeout: 5000 });
+            }
+            else if (process.platform === 'linux') {
+                const { execSync } = require('child_process');
+                try {
+                    execSync('xclip -selection clipboard', { input: text, timeout: 5000 });
+                }
+                catch {
+                    execSync('xsel --clipboard --input', { input: text, timeout: 5000 });
+                }
+            }
+            const entry = {
+                type: 'text',
+                text,
+                timestamp: new Date().toISOString(),
+                source: 'stelo',
+                hash: simpleHash(text),
+            };
+            _addToHistory(entry);
+            _lastHash = entry.hash;
+            events_1.events.emit('clipboard.write', 'clipboard', { type: 'text', length: text.length }, { source: 'clipboard' });
+        }
+        catch (err) {
+            _log.error('Failed to write clipboard', err);
+            throw err;
+        }
+    },
+    /**
+     * Read HTML from the clipboard (Windows only).
+     */
+    async readHtml() {
+        if (process.platform === 'win32') {
+            try {
+                const { execSync } = require('child_process');
+                return execSync('powershell -command "Get-Clipboard -Format Html"', { encoding: 'utf-8', timeout: 5000, windowsHide: true }).trimEnd();
+            }
+            catch {
+                return '';
+            }
+        }
+        return '';
+    },
+    /**
+     * Clear the clipboard.
+     */
+    async clear() {
+        try {
+            if (process.platform === 'win32') {
+                const { execSync } = require('child_process');
+                execSync('powershell -command "Set-Clipboard -Value $null"', {
+                    timeout: 5000,
+                    windowsHide: true,
+                });
+            }
+            else if (process.platform === 'darwin') {
+                const { execSync } = require('child_process');
+                execSync('pbcopy < /dev/null', { timeout: 5000 });
+            }
+            events_1.events.emit('clipboard.clear', 'clipboard', undefined, { source: 'clipboard' });
+        }
+        catch (err) {
+            _log.error('Failed to clear clipboard', err);
+        }
+    },
+    /**
+     * Copy text using keyboard shortcut (Ctrl+C / Cmd+C).
+     * Copies whatever is currently selected in the active window.
+     */
+    copy() {
+        const native = getNative();
+        if (native) {
+            const mod = process.platform === 'darwin' ? 'cmd' : 'ctrl';
+            native.keyboardHotkey([mod, 'c']);
+        }
+    },
+    /**
+     * Paste from clipboard using keyboard shortcut (Ctrl+V / Cmd+V).
+     */
+    paste() {
+        const native = getNative();
+        if (native) {
+            const mod = process.platform === 'darwin' ? 'cmd' : 'ctrl';
+            native.keyboardHotkey([mod, 'v']);
+        }
+    },
+    /**
+     * Cut using keyboard shortcut (Ctrl+X / Cmd+X).
+     */
+    cut() {
+        const native = getNative();
+        if (native) {
+            const mod = process.platform === 'darwin' ? 'cmd' : 'ctrl';
+            native.keyboardHotkey([mod, 'x']);
+        }
+    },
+    /**
+     * Select all text (Ctrl+A / Cmd+A), then copy.
+     * Returns the copied text.
+     */
+    async selectAllAndCopy() {
+        const native = getNative();
+        if (native) {
+            const mod = process.platform === 'darwin' ? 'cmd' : 'ctrl';
+            native.keyboardHotkey([mod, 'a']);
+            native.delay(50);
+            native.keyboardHotkey([mod, 'c']);
+            native.delay(100);
+        }
+        return exports.clipboard.readText();
+    },
+    /**
+     * Write text to clipboard and paste it into the active window.
+     * This is a common pattern for typing text that includes special characters.
+     */
+    async typeViaClipboard(text) {
+        // Save current clipboard
+        const saved = await exports.clipboard.readText();
+        // Write and paste
+        await exports.clipboard.writeText(text);
+        exports.clipboard.paste();
+        // Small delay to let paste complete
+        const native = getNative();
+        if (native)
+            native.delay(100);
+        // Restore clipboard (optional — disable if not needed)
+        await exports.clipboard.writeText(saved);
+    },
+    // ── Monitoring ───────────────────────────────────────────────────────────
+    /**
+     * Start watching the clipboard for changes.
+     * Emits 'clipboard.change' events when content changes.
+     */
+    startWatching(options) {
+        if (_watchInterval)
+            return;
+        const intervalMs = options?.intervalMs ?? 500;
+        _maxHistory = options?.maxHistory ?? 100;
+        _log.info('Clipboard watcher started', { intervalMs });
+        _watchInterval = setInterval(async () => {
+            try {
+                const text = await exports.clipboard.readText();
+                const hash = simpleHash(text || '');
+                if (hash !== _lastHash && text) {
+                    _lastHash = hash;
+                    const entry = {
+                        type: text ? 'text' : 'empty',
+                        text,
+                        timestamp: new Date().toISOString(),
+                        source: 'external',
+                        hash,
+                    };
+                    if (options?.trackHistory !== false) {
+                        _addToHistory(entry);
+                    }
+                    events_1.events.emit('clipboard.change', 'clipboard', {
+                        type: entry.type,
+                        length: text?.length ?? 0,
+                        hash,
+                    }, { source: 'clipboard' });
+                }
+            }
+            catch {
+                // Silently ignore clipboard read errors during monitoring
+            }
+        }, intervalMs);
+    },
+    /**
+     * Stop watching the clipboard.
+     */
+    stopWatching() {
+        if (_watchInterval) {
+            clearInterval(_watchInterval);
+            _watchInterval = null;
+            _log.info('Clipboard watcher stopped');
+        }
+    },
+    /** Is the clipboard watcher running? */
+    isWatching() {
+        return _watchInterval !== null;
+    },
+    // ── History ──────────────────────────────────────────────────────────────
+    /**
+     * Get clipboard history.
+     */
+    getHistory(limit) {
+        const entries = [..._history];
+        if (limit)
+            return entries.slice(-limit);
+        return entries;
+    },
+    /**
+     * Search clipboard history.
+     */
+    searchHistory(query) {
+        const lower = query.toLowerCase();
+        return _history.filter((e) => e.text?.toLowerCase().includes(lower) ||
+            e.html?.toLowerCase().includes(lower));
+    },
+    /** Clear clipboard history */
+    clearHistory() {
+        _history.length = 0;
+    },
+    // ── Utility ──────────────────────────────────────────────────────────────
+    /**
+     * Wait for the clipboard to contain specific text.
+     */
+    async waitForText(match, timeoutMs = 10000, pollIntervalMs = 200) {
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            const text = await exports.clipboard.readText();
+            if (typeof match === 'string') {
+                if (text.includes(match))
+                    return text;
+            }
+            else {
+                if (match.test(text))
+                    return text;
+            }
+            await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+        }
+        return null;
+    },
+    /**
+     * Detect the current clipboard content type.
+     */
+    async detectContentType() {
+        const text = await exports.clipboard.readText();
+        if (!text)
+            return 'empty';
+        // Check for HTML
+        if (text.startsWith('<!DOCTYPE') || text.startsWith('<html') || text.startsWith('<')) {
+            return 'html';
+        }
+        // Check for file paths
+        const lines = text.split('\n');
+        const pathPattern = /^[A-Z]:\\|^\/|^\\/;
+        if (lines.length > 0 && lines.every((l) => pathPattern.test(l.trim()))) {
+            return 'files';
+        }
+        return 'text';
+    },
+    /** Reset the clipboard module */
+    reset() {
+        exports.clipboard.stopWatching();
+        _history.length = 0;
+        _lastHash = '';
+    },
+};
+// ── Internal Helpers ─────────────────────────────────────────────────────────
+function _addToHistory(entry) {
+    // Dedup
+    if (_history.length > 0 && _history[_history.length - 1].hash === entry.hash) {
+        return;
+    }
+    _history.push(entry);
+    while (_history.length > _maxHistory) {
+        _history.shift();
+    }
+}
+//# sourceMappingURL=clipboard.js.map

package/dist/clipboard.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,183 @@
+export interface SteloConfig {
+    [key: string]: unknown;
+    /** Mouse automation defaults */
+    mouse?: {
+        defaultDurationMs?: number;
+        defaultCurve?: string;
+        humanize?: boolean;
+        jitter?: number;
+        overshoot?: boolean;
+        stepsPerSecond?: number;
+    };
+    /** Keyboard automation defaults */
+    keyboard?: {
+        defaultDelayMs?: number;
+        humanize?: boolean;
+        minDelayMs?: number;
+        maxDelayMs?: number;
+    };
+    /** Screen capture defaults */
+    screen?: {
+        captureFormat?: 'rgba' | 'bgra';
+        defaultRegion?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    };
+    /** Safety configuration */
+    safety?: {
+        failsafe?: boolean;
+        failsafeThresholdPx?: number;
+        rateLimitPerSecond?: number;
+        boundaryRegion?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        } | null;
+        maxConcurrentActions?: number;
+        emergencyStopKey?: string;
+    };
+    /** Vision defaults */
+    vision?: {
+        defaultTolerance?: number;
+        defaultSampleRate?: number;
+        gridCols?: number;
+        gridRows?: number;
+        waitTimeoutMs?: number;
+        waitPollIntervalMs?: number;
+    };
+    /** Stream defaults */
+    stream?: {
+        fps?: number;
+        scale?: number;
+        bufferSize?: number;
+        rawBgra?: boolean;
+    };
+    /** Audio stream defaults */
+    audio?: {
+        bufferSize?: number;
+    };
+    /** Executor defaults */
+    executor?: {
+        maxConcurrency?: number;
+        defaultTimeoutMs?: number;
+        defaultPriority?: number;
+        maxQueueSize?: number;
+        retryAttempts?: number;
+        retryDelayMs?: number;
+    };
+    /** Logging configuration */
+    logging?: {
+        level?: string;
+        json?: boolean;
+        emitEvents?: boolean;
+        redactSensitive?: boolean;
+    };
+    /** Telemetry configuration */
+    telemetry?: {
+        enabled?: boolean;
+        metricsEnabled?: boolean;
+        healthCheckIntervalMs?: number;
+    };
+    /** Plugin configuration */
+    plugins?: {
+        autoDiscover?: boolean;
+        directories?: string[];
+        enabled?: string[];
+        disabled?: string[];
+        config?: Record<string, Record<string, unknown>>;
+    };
+    /** Custom data */
+    custom?: Record<string, unknown>;
+}
+export interface ConfigProfile {
+    name: string;
+    description?: string;
+    config: Partial<SteloConfig>;
+}
+export interface ConfigSource {
+    name: string;
+    priority: number;
+    config: Partial<SteloConfig>;
+}
+export declare const config: {
+    /**
+     * Get the fully resolved configuration.
+     */
+    get(): SteloConfig;
+    /**
+     * Get a specific config section.
+     * @example config.section('mouse') → { defaultDurationMs: 500, ... }
+     */
+    section<K extends keyof SteloConfig>(key: K): SteloConfig[K];
+    /**
+     * Get a specific config value by dot-notation path.
+     * @example config.value('mouse.defaultDurationMs') → 500
+     */
+    value(path: string): unknown;
+    /**
+     * Set configuration values (merged with existing).
+     * Triggers watchers & events.
+     */
+    set(overrides: Partial<SteloConfig>): void;
+    /**
+     * Add a named configuration source with a priority.
+     * Higher priority sources override lower ones.
+     */
+    addSource(name: string, config: Partial<SteloConfig>, priority?: number): void;
+    /**
+     * Remove a configuration source by name.
+     */
+    removeSource(name: string): void;
+    /**
+     * List all config sources (ordered by priority).
+     */
+    getSources(): {
+        name: string;
+        priority: number;
+    }[];
+    /**
+     * Apply a named profile.
+     * @example config.useProfile('production');
+     */
+    useProfile(name: string): void;
+    /** Get the active profile name */
+    getActiveProfile(): string | undefined;
+    /** Register a custom profile */
+    registerProfile(profile: ConfigProfile): void;
+    /** List available profile names */
+    listProfiles(): string[];
+    /** Get a profile by name */
+    getProfile(name: string): ConfigProfile | undefined;
+    /**
+     * Load configuration from environment variables.
+     * Env vars have priority 90 (override most other sources).
+     */
+    loadEnvironment(): void;
+    /**
+     * Watch for configuration changes.
+     * @returns Unsubscribe function
+     */
+    onChange(handler: (config: SteloConfig) => void): () => void;
+    /** Freeze configuration — prevents further changes */
+    freeze(): void;
+    /** Unfreeze configuration — allows changes again */
+    unfreeze(): void;
+    /** Check if configuration is frozen */
+    isFrozen(): boolean;
+    /**
+     * Validate a configuration object against known schema constraints.
+     * Returns an array of validation errors (empty = valid).
+     */
+    validate(cfg: Partial<SteloConfig>): string[];
+    /** Export the resolved configuration as JSON */
+    toJSON(): string;
+    /** Import configuration from JSON */
+    fromJSON(json: string): void;
+    /** Reset to defaults */
+    reset(): void;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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