stelo 1.0.1

package/dist/plugin.js

@@ -0,0 +1,409 @@
+"use strict";
+// ============================================================================
+// Stelo — Plugin System
+// ============================================================================
+// Plugin discovery, lifecycle management, inter-plugin communication,
+// hook registration, and sandboxed execution for extensibility.
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.plugin = void 0;
+const events_1 = require("./events");
+const logger_1 = require("./logger");
+const _plugins = new Map();
+const _hooks = new Map();
+const _loadOrder = [];
+const _log = logger_1.logger.child('plugin');
+function createPluginAPI(pluginId) {
+    const pluginLogger = logger_1.logger.child(`plugin:${pluginId}`);
+    const pluginConfig = _plugins.get(pluginId)?.config ?? {};
+    return {
+        events: events_1.events,
+        logger: pluginLogger,
+        getPlugin(id) {
+            const p = _plugins.get(id);
+            if (!p || p.status !== 'active')
+                return null;
+            return p.exports;
+        },
+        registerHook(name, fn) {
+            if (!_hooks.has(name))
+                _hooks.set(name, []);
+            _hooks.get(name).push({ pluginId, fn });
+        },
+        async callHook(name, ...args) {
+            const handlers = _hooks.get(name) ?? [];
+            const results = [];
+            for (const handler of handlers) {
+                try {
+                    results.push(await handler.fn(...args));
+                }
+                catch (err) {
+                    pluginLogger.error(`Hook "${name}" failed in plugin ${handler.pluginId}`, err);
+                }
+            }
+            return results;
+        },
+        getConfig(key, defaultValue) {
+            return (key in pluginConfig ? pluginConfig[key] : defaultValue);
+        },
+        setConfig(key, value) {
+            pluginConfig[key] = value;
+            const p = _plugins.get(pluginId);
+            if (p)
+                p.config = pluginConfig;
+        },
+    };
+}
+function resolveDependencyOrder(pluginIds) {
+    const visited = new Set();
+    const result = [];
+    function visit(id, visiting) {
+        if (visited.has(id))
+            return;
+        if (visiting.has(id)) {
+            throw new Error(`Circular plugin dependency detected involving: ${id}`);
+        }
+        visiting.add(id);
+        const plugin = _plugins.get(id);
+        if (plugin?.definition.manifest.dependencies) {
+            for (const dep of plugin.definition.manifest.dependencies) {
+                if (_plugins.has(dep)) {
+                    visit(dep, visiting);
+                }
+                else {
+                    _log.warn(`Plugin "${id}" depends on "${dep}" which is not registered`);
+                }
+            }
+        }
+        visiting.delete(id);
+        visited.add(id);
+        result.push(id);
+    }
+    // Sort by priority first
+    const sorted = [...pluginIds].sort((a, b) => {
+        const pa = _plugins.get(a)?.definition.manifest.priority ?? 0;
+        const pb = _plugins.get(b)?.definition.manifest.priority ?? 0;
+        return pb - pa; // Higher priority first
+    });
+    for (const id of sorted) {
+        visit(id, new Set());
+    }
+    return result;
+}
+// ── Public API ───────────────────────────────────────────────────────────────
+exports.plugin = {
+    /**
+     * Register a plugin (does not initialize it yet).
+     */
+    register(definition) {
+        const { id } = definition.manifest;
+        if (_plugins.has(id)) {
+            throw new Error(`Plugin "${id}" is already registered`);
+        }
+        _plugins.set(id, {
+            definition,
+            status: 'registered',
+            exports: null,
+            config: {},
+        });
+        events_1.events.emit('plugin.registered', 'plugin', {
+            pluginId: id,
+            name: definition.manifest.name,
+            version: definition.manifest.version,
+        }, { source: 'plugin' });
+        _log.info('Plugin registered', {
+            id,
+            name: definition.manifest.name,
+            version: definition.manifest.version,
+        });
+    },
+    /**
+     * Initialize and activate a specific plugin.
+     */
+    async activate(pluginId) {
+        const p = _plugins.get(pluginId);
+        if (!p) {
+            _log.error('Plugin not found', undefined, { pluginId });
+            return false;
+        }
+        if (p.status === 'active')
+            return true;
+        // Check dependencies
+        const deps = p.definition.manifest.dependencies ?? [];
+        for (const dep of deps) {
+            const depPlugin = _plugins.get(dep);
+            if (!depPlugin) {
+                _log.error(`Dependency "${dep}" not found for plugin "${pluginId}"`);
+                p.status = 'error';
+                p.errorMessage = `Missing dependency: ${dep}`;
+                return false;
+            }
+            if (depPlugin.status !== 'active') {
+                const activated = await exports.plugin.activate(dep);
+                if (!activated) {
+                    p.status = 'error';
+                    p.errorMessage = `Failed to activate dependency: ${dep}`;
+                    return false;
+                }
+            }
+        }
+        p.status = 'initializing';
+        try {
+            const api = createPluginAPI(pluginId);
+            p.exports = await p.definition.init(api);
+            p.status = 'active';
+            p.loadedAt = Date.now();
+            _loadOrder.push(pluginId);
+            events_1.events.emit('plugin.activated', 'plugin', {
+                pluginId,
+                name: p.definition.manifest.name,
+            }, { source: 'plugin' });
+            _log.info('Plugin activated', { pluginId });
+            return true;
+        }
+        catch (err) {
+            p.status = 'error';
+            p.errorMessage = String(err);
+            events_1.events.emit('plugin.error', 'plugin', {
+                pluginId,
+                error: String(err),
+            }, { source: 'plugin' });
+            _log.error('Plugin activation failed', err, { pluginId });
+            return false;
+        }
+    },
+    /**
+     * Activate all registered plugins (in dependency order).
+     */
+    async activateAll() {
+        const ids = [..._plugins.keys()].filter((id) => {
+            const p = _plugins.get(id);
+            return p.status === 'registered' || p.status === 'error';
+        });
+        let ordered;
+        try {
+            ordered = resolveDependencyOrder(ids);
+        }
+        catch (err) {
+            _log.error('Failed to resolve dependency order', err);
+            return { activated: [], failed: ids };
+        }
+        const activated = [];
+        const failed = [];
+        for (const id of ordered) {
+            const success = await exports.plugin.activate(id);
+            if (success) {
+                activated.push(id);
+            }
+            else {
+                failed.push(id);
+            }
+        }
+        return { activated, failed };
+    },
+    /**
+     * Deactivate/unload a plugin.
+     */
+    async deactivate(pluginId) {
+        const p = _plugins.get(pluginId);
+        if (!p || p.status === 'unloaded')
+            return false;
+        try {
+            if (p.definition.destroy) {
+                await p.definition.destroy();
+            }
+            p.status = 'unloaded';
+            p.exports = null;
+            // Remove hooks registered by this plugin
+            for (const [name, handlers] of _hooks) {
+                _hooks.set(name, handlers.filter((h) => h.pluginId !== pluginId));
+            }
+            events_1.events.emit('plugin.deactivated', 'plugin', { pluginId }, { source: 'plugin' });
+            _log.info('Plugin deactivated', { pluginId });
+            return true;
+        }
+        catch (err) {
+            _log.error('Plugin deactivation failed', err, { pluginId });
+            p.status = 'error';
+            p.errorMessage = String(err);
+            return false;
+        }
+    },
+    /**
+     * Pause a plugin.
+     */
+    async pause(pluginId) {
+        const p = _plugins.get(pluginId);
+        if (!p || p.status !== 'active')
+            return false;
+        try {
+            if (p.definition.onPause) {
+                await p.definition.onPause();
+            }
+            p.status = 'paused';
+            events_1.events.emit('plugin.paused', 'plugin', { pluginId }, { source: 'plugin' });
+            return true;
+        }
+        catch (err) {
+            _log.error('Plugin pause failed', err, { pluginId });
+            return false;
+        }
+    },
+    /**
+     * Resume a paused plugin.
+     */
+    async resume(pluginId) {
+        const p = _plugins.get(pluginId);
+        if (!p || p.status !== 'paused')
+            return false;
+        try {
+            if (p.definition.onResume) {
+                await p.definition.onResume();
+            }
+            p.status = 'active';
+            events_1.events.emit('plugin.resumed', 'plugin', { pluginId }, { source: 'plugin' });
+            return true;
+        }
+        catch (err) {
+            _log.error('Plugin resume failed', err, { pluginId });
+            return false;
+        }
+    },
+    /**
+     * Get a plugin's exported API.
+     */
+    get(pluginId) {
+        const p = _plugins.get(pluginId);
+        if (!p || p.status !== 'active')
+            return null;
+        return p.exports;
+    },
+    /**
+     * Get plugin info.
+     */
+    getInfo(pluginId) {
+        const p = _plugins.get(pluginId);
+        if (!p)
+            return null;
+        return {
+            id: p.definition.manifest.id,
+            name: p.definition.manifest.name,
+            version: p.definition.manifest.version,
+            status: p.status,
+            description: p.definition.manifest.description,
+            author: p.definition.manifest.author,
+            tags: p.definition.manifest.tags ?? [],
+            loadedAt: p.loadedAt ? new Date(p.loadedAt).toISOString() : undefined,
+            errorMessage: p.errorMessage,
+        };
+    },
+    /**
+     * List all registered plugins.
+     */
+    list() {
+        return [..._plugins.keys()].map((id) => exports.plugin.getInfo(id));
+    },
+    /**
+     * Check if a plugin is registered.
+     */
+    has(pluginId) {
+        return _plugins.has(pluginId);
+    },
+    /**
+     * Check if a plugin is active.
+     */
+    isActive(pluginId) {
+        return _plugins.get(pluginId)?.status === 'active';
+    },
+    // ── Hooks ──────────────────────────────────────────────────────────────
+    /**
+     * Call a named hook registered by any plugin. Returns all results.
+     */
+    async callHook(name, ...args) {
+        const handlers = _hooks.get(name) ?? [];
+        const results = [];
+        for (const handler of handlers) {
+            const p = _plugins.get(handler.pluginId);
+            if (p?.status !== 'active')
+                continue;
+            try {
+                results.push(await handler.fn(...args));
+            }
+            catch (err) {
+                _log.error(`Hook "${name}" failed`, err, {
+                    pluginId: handler.pluginId,
+                });
+            }
+        }
+        return results;
+    },
+    /**
+     * List all registered hook names.
+     */
+    listHooks() {
+        return [..._hooks.keys()];
+    },
+    /**
+     * Get all handlers for a specific hook.
+     */
+    getHookHandlers(name) {
+        return (_hooks.get(name) ?? []).map((h) => ({ pluginId: h.pluginId }));
+    },
+    // ── Plugin Builder ─────────────────────────────────────────────────────
+    /**
+     * Quick plugin definition builder.
+     *
+     * @example
+     *   plugin.register(plugin.define({
+     *     id: 'my-plugin',
+     *     name: 'My Plugin',
+     *     version: '1.0.0',
+     *   }, async (api) => {
+     *     api.logger.info('Hello from my plugin!');
+     *     api.registerHook('transform', (data) => data.toUpperCase());
+     *     return { greet: () => 'hello!' };
+     *   }));
+     */
+    define(manifest, init, options) {
+        return {
+            manifest,
+            init,
+            destroy: options?.destroy,
+            onPause: options?.onPause,
+            onResume: options?.onResume,
+        };
+    },
+    /**
+     * Get stats about the plugin system.
+     */
+    getStats() {
+        let active = 0, error = 0;
+        for (const p of _plugins.values()) {
+            if (p.status === 'active')
+                active++;
+            if (p.status === 'error')
+                error++;
+        }
+        let hooks = 0;
+        for (const handlers of _hooks.values()) {
+            hooks += handlers.length;
+        }
+        return {
+            totalPlugins: _plugins.size,
+            activePlugins: active,
+            errorPlugins: error,
+            totalHooks: hooks,
+        };
+    },
+    /** Reset the plugin system (deactivate all, clear state) */
+    async reset() {
+        // Unload in reverse order
+        for (const id of [..._loadOrder].reverse()) {
+            await exports.plugin.deactivate(id);
+        }
+        _plugins.clear();
+        _hooks.clear();
+        _loadOrder.length = 0;
+    },
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/process.d.ts

@@ -0,0 +1,106 @@
+export interface ProcessInfo {
+    /** Process ID */
+    pid: number;
+    /** Process name */
+    name: string;
+    /** Window title (from the first window found) */
+    title: string;
+    /** Window ID */
+    windowId: number;
+    /** Window bounds */
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Is the window visible? */
+    isVisible: boolean;
+    /** Is the window minimized? */
+    isMinimized: boolean;
+}
+export interface ForegroundChange {
+    /** Previous foreground process */
+    previous?: ProcessInfo;
+    /** Current foreground process */
+    current: ProcessInfo;
+    /** Timestamp */
+    timestamp: string;
+}
+export interface ProcessWatcherOptions {
+    /** Poll interval in ms. Default: 500 */
+    intervalMs?: number;
+    /** Track foreground changes? Default: true */
+    trackForeground?: boolean;
+}
+export declare const process_manager: {
+    /**
+     * List all visible processes (via window enumeration).
+     */
+    list(): ProcessInfo[];
+    /**
+     * Find processes by name (case-insensitive partial match).
+     */
+    findByName(name: string): ProcessInfo[];
+    /**
+     * Find processes by window title (case-insensitive partial match).
+     */
+    findByTitle(title: string): ProcessInfo[];
+    /**
+     * Get the currently focused/foreground process.
+     */
+    getForeground(): ProcessInfo | null;
+    /**
+     * Focus a process by name (brings its window to front).
+     */
+    focus(name: string): boolean;
+    /**
+     * Focus a process by PID.
+     */
+    focusByPid(pid: number): boolean;
+    /**
+     * Close a process window by name.
+     */
+    close(name: string): boolean;
+    /**
+     * Wait for a process/window to appear.
+     */
+    waitFor(name: string, timeoutMs?: number, pollIntervalMs?: number): Promise<ProcessInfo | null>;
+    /**
+     * Wait for a process to close/disappear.
+     */
+    waitForClose(name: string, timeoutMs?: number, pollIntervalMs?: number): Promise<boolean>;
+    /**
+     * Launch a process/application.
+     */
+    launch(command: string, args?: string[]): Promise<number | null>;
+    /**
+     * Kill a process by PID.
+     */
+    kill(pid: number, signal?: string): boolean;
+    /**
+     * Start monitoring foreground process changes.
+     */
+    startWatching(options?: ProcessWatcherOptions): void;
+    /**
+     * Stop monitoring.
+     */
+    stopWatching(): void;
+    /** Is the watcher running? */
+    isWatching(): boolean;
+    /**
+     * Get foreground process change history.
+     */
+    getForegroundHistory(): ForegroundChange[];
+    /**
+     * Get how long the current foreground process has been active (ms).
+     */
+    getForegroundDuration(): number;
+    /**
+     * Wait until a specific process becomes the foreground window.
+     */
+    waitForForeground(name: string, timeoutMs?: number, pollIntervalMs?: number): Promise<ProcessInfo | null>;
+    /** Reset the module */
+    reset(): void;
+};
+//# sourceMappingURL=process.d.ts.map

package/dist/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../ts/process.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,6BAA6B;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,iCAAiC;IACjC,OAAO,EAAE,WAAW,CAAC;IACrB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAiCD,eAAO,MAAM,eAAe;IAC1B;;OAEG;YACK,WAAW,EAAE;IAqBrB;;OAEG;qBACc,MAAM,GAAG,WAAW,EAAE;IAOvC;;OAEG;uBACgB,MAAM,GAAG,WAAW,EAAE;IAazC;;OAEG;qBACc,WAAW,GAAG,IAAI;IAanC;;OAEG;gBACS,MAAM,GAAG,OAAO;IAsB5B;;OAEG;oBACa,MAAM,GAAG,OAAO;IAehC;;OAEG;gBACS,MAAM,GAAG,OAAO;IAe5B;;OAEG;kBAEK,MAAM,cACD,MAAM,mBACD,MAAM,GACrB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAc9B;;OAEG;uBAEK,MAAM,cACD,MAAM,mBACD,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC;IAWnB;;OAEG;oBACmB,MAAM,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAsBtE;;OAEG;cACO,MAAM,WAAU,MAAM,GAAe,OAAO;IAkBtD;;OAEG;4BACqB,qBAAqB,GAAG,IAAI;IAuCpD;;OAEG;oBACa,IAAI;IAQpB,8BAA8B;kBAChB,OAAO;IAIrB;;OAEG;4BACqB,gBAAgB,EAAE;IAI1C;;OAEG;6BACsB,MAAM;IAM/B;;OAEG;4BAEK,MAAM,cACD,MAAM,mBACD,MAAM,GACrB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAc9B,uBAAuB;aACd,IAAI;CAMd,CAAC"}