@phuetz/code-buddy 0.1.4 → 0.1.6

package/dist/desktop-automation/base-native-provider.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Base Native Provider
+ *
+ * Abstract base class for platform-native desktop automation providers.
+ * Provides shared utilities for executing CLI tools, checking tool availability,
+ * and common helper methods.
+ */
+import type { IAutomationProvider } from './automation-manager.js';
+import type { AutomationProvider, ProviderCapabilities, MousePosition, MouseMoveOptions, MouseClickOptions, MouseDragOptions, MouseScrollOptions, MouseButton, KeyCode, KeyPressOptions, TypeOptions, HotkeySequence, WindowInfo, WindowSearchOptions, WindowSetOptions, AppInfo, AppLaunchOptions, ScreenInfo, ColorInfo, ClipboardContent } from './types.js';
+export declare abstract class BaseNativeProvider implements IAutomationProvider {
+    readonly name: AutomationProvider;
+    abstract readonly capabilities: ProviderCapabilities;
+    abstract readonly platformName: string;
+    protected initialized: boolean;
+    protected availableTools: Map<string, boolean>;
+    /**
+     * Execute a command asynchronously with optional timeout
+     */
+    protected exec(cmd: string, timeout?: number): Promise<string>;
+    /**
+     * Execute a command synchronously
+     */
+    protected execSync(cmd: string, timeout?: number): string;
+    /**
+     * Check if a CLI tool is available (cached)
+     */
+    protected checkTool(name: string): boolean;
+    /**
+     * Check if a tool is available (from cache)
+     */
+    protected hasTool(name: string): boolean;
+    /**
+     * Delay helper
+     */
+    protected delay(ms: number): Promise<void>;
+    /**
+     * Ensure provider is initialized
+     */
+    protected ensureInitialized(): void;
+    abstract initialize(): Promise<void>;
+    abstract shutdown(): Promise<void>;
+    abstract isAvailable(): Promise<boolean>;
+    abstract getMousePosition(): Promise<MousePosition>;
+    abstract moveMouse(x: number, y: number, options?: MouseMoveOptions): Promise<void>;
+    abstract click(options?: MouseClickOptions): Promise<void>;
+    abstract doubleClick(button?: MouseButton): Promise<void>;
+    abstract rightClick(): Promise<void>;
+    abstract drag(fromX: number, fromY: number, toX: number, toY: number, options?: MouseDragOptions): Promise<void>;
+    abstract scroll(options: MouseScrollOptions): Promise<void>;
+    abstract keyPress(key: KeyCode, options?: KeyPressOptions): Promise<void>;
+    abstract keyDown(key: KeyCode): Promise<void>;
+    abstract keyUp(key: KeyCode): Promise<void>;
+    abstract type(text: string, options?: TypeOptions): Promise<void>;
+    abstract hotkey(sequence: HotkeySequence): Promise<void>;
+    abstract getActiveWindow(): Promise<WindowInfo | null>;
+    abstract getWindows(options?: WindowSearchOptions): Promise<WindowInfo[]>;
+    abstract getWindow(handle: string): Promise<WindowInfo | null>;
+    abstract focusWindow(handle: string): Promise<void>;
+    abstract minimizeWindow(handle: string): Promise<void>;
+    abstract maximizeWindow(handle: string): Promise<void>;
+    abstract restoreWindow(handle: string): Promise<void>;
+    abstract closeWindow(handle: string): Promise<void>;
+    abstract setWindow(handle: string, options: WindowSetOptions): Promise<void>;
+    abstract getRunningApps(): Promise<AppInfo[]>;
+    abstract launchApp(appPath: string, options?: AppLaunchOptions): Promise<AppInfo>;
+    abstract closeApp(pid: number): Promise<void>;
+    abstract getScreens(): Promise<ScreenInfo[]>;
+    abstract getPixelColor(x: number, y: number): Promise<ColorInfo>;
+    abstract getClipboard(): Promise<ClipboardContent>;
+    abstract setClipboard(content: Partial<ClipboardContent>): Promise<void>;
+    abstract clearClipboard(): Promise<void>;
+}

package/dist/desktop-automation/base-native-provider.js

@@ -0,0 +1,75 @@
+/**
+ * Base Native Provider
+ *
+ * Abstract base class for platform-native desktop automation providers.
+ * Provides shared utilities for executing CLI tools, checking tool availability,
+ * and common helper methods.
+ */
+import { execSync, exec as execCb } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(execCb);
+export class BaseNativeProvider {
+    name = 'native';
+    initialized = false;
+    availableTools = new Map();
+    /**
+     * Execute a command asynchronously with optional timeout
+     */
+    async exec(cmd, timeout = 10000) {
+        const { stdout } = await execAsync(cmd, {
+            timeout,
+            encoding: 'utf-8',
+            maxBuffer: 1024 * 1024,
+        });
+        return stdout.trim();
+    }
+    /**
+     * Execute a command synchronously
+     */
+    execSync(cmd, timeout = 5000) {
+        return execSync(cmd, {
+            encoding: 'utf-8',
+            timeout,
+            maxBuffer: 1024 * 1024,
+        }).trim();
+    }
+    /**
+     * Check if a CLI tool is available (cached)
+     */
+    checkTool(name) {
+        if (this.availableTools.has(name)) {
+            return this.availableTools.get(name);
+        }
+        let available = false;
+        try {
+            execSync(`which ${name}`, { encoding: 'utf-8', timeout: 3000 });
+            available = true;
+        }
+        catch {
+            available = false;
+        }
+        this.availableTools.set(name, available);
+        return available;
+    }
+    /**
+     * Check if a tool is available (from cache)
+     */
+    hasTool(name) {
+        return this.availableTools.get(name) ?? false;
+    }
+    /**
+     * Delay helper
+     */
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Ensure provider is initialized
+     */
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error(`${this.platformName} native provider not initialized. Call initialize() first.`);
+        }
+    }
+}
+//# sourceMappingURL=base-native-provider.js.map

package/dist/desktop-automation/base-native-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-native-provider.js","sourceRoot":"","sources":["../../src/desktop-automation/base-native-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAyBjC,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAEpC,MAAM,OAAgB,kBAAkB;IAC7B,IAAI,GAAuB,QAAQ,CAAC;IAInC,WAAW,GAAG,KAAK,CAAC;IACpB,cAAc,GAAyB,IAAI,GAAG,EAAE,CAAC;IAE3D;;OAEG;IACO,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,OAAO,GAAG,KAAK;QAC/C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;YACtC,OAAO;YACP,QAAQ,EAAE,OAAO;YACjB,SAAS,EAAE,IAAI,GAAG,IAAI;SACvB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACO,QAAQ,CAAC,GAAW,EAAE,OAAO,GAAG,IAAI;QAC5C,OAAO,QAAQ,CAAC,GAAG,EAAE;YACnB,QAAQ,EAAE,OAAO;YACjB,OAAO;YACP,SAAS,EAAE,IAAI,GAAG,IAAI;SACvB,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACO,SAAS,CAAC,IAAY;QAC9B,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;QACxC,CAAC;QACD,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC;YACH,QAAQ,CAAC,SAAS,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAChE,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACzC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACO,OAAO,CAAC,IAAY;QAC5B,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;IAChD,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,EAAU;QACxB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACO,iBAAiB;QACzB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,YAAY,4DAA4D,CAAC,CAAC;QACpG,CAAC;IACH,CAAC;CAyCF"}

package/dist/desktop-automation/index.d.ts

@@ -15,6 +15,10 @@ export { DEFAULT_AUTOMATION_CONFIG } from './types.js';
 export type { IAutomationProvider } from './automation-manager.js';
 export { MockAutomationProvider, DesktopAutomationManager, getDesktopAutomation, resetDesktopAutomation, } from './automation-manager.js';
 export { NutJsProvider } from './nutjs-provider.js';
+export { BaseNativeProvider } from './base-native-provider.js';
+export { LinuxNativeProvider } from './linux-native-provider.js';
+export { WindowsNativeProvider } from './windows-native-provider.js';
+export { MacOSNativeProvider } from './macos-native-provider.js';
 export type { PermissionType, PermissionStatus, PermissionInfo, PermissionCheckResult, PermissionManagerConfig, } from './permission-manager.js';
 export { PermissionManager, PermissionError, getPermissionManager, resetPermissionManager, } from './permission-manager.js';
 export type { VolumeInfo, BrightnessInfo, NotificationOptions, NotificationResult, PowerAction, DisplayInfo, NetworkInfo, BatteryInfo, SystemInfo, } from './system-control.js';

package/dist/desktop-automation/index.js

@@ -14,6 +14,11 @@ export { DEFAULT_AUTOMATION_CONFIG } from './types.js';
 export { MockAutomationProvider, DesktopAutomationManager, getDesktopAutomation, resetDesktopAutomation, } from './automation-manager.js';
 // Providers
 export { NutJsProvider } from './nutjs-provider.js';
+// Platform-Native Providers (OpenClaw-inspired)
+export { BaseNativeProvider } from './base-native-provider.js';
+export { LinuxNativeProvider } from './linux-native-provider.js';
+export { WindowsNativeProvider } from './windows-native-provider.js';
+export { MacOSNativeProvider } from './macos-native-provider.js';
 export { PermissionManager, PermissionError, getPermissionManager, resetPermissionManager, } from './permission-manager.js';
 export { SystemControl, getSystemControl, resetSystemControl, } from './system-control.js';
 export { SmartSnapshotManager, getSmartSnapshotManager, resetSmartSnapshotManager, } from './smart-snapshot.js';

package/dist/desktop-automation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/desktop-automation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiCH,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAKvD,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWpD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAejC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAY7B,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAa7B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/desktop-automation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiCH,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAKvD,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,gDAAgD;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAWjE,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAejC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAY7B,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAa7B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/desktop-automation/linux-native-provider.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Linux Native Desktop Automation Provider
+ *
+ * Uses xdotool, xclip, wmctrl, and xrandr for desktop automation on Linux/X11.
+ */
+import { BaseNativeProvider } from './base-native-provider.js';
+import type { ProviderCapabilities, MousePosition, MouseMoveOptions, MouseClickOptions, MouseDragOptions, MouseScrollOptions, MouseButton, KeyCode, KeyPressOptions, TypeOptions, HotkeySequence, WindowInfo, WindowSearchOptions, WindowSetOptions, AppInfo, AppLaunchOptions, ScreenInfo, ColorInfo, ClipboardContent } from './types.js';
+export declare class LinuxNativeProvider extends BaseNativeProvider {
+    readonly platformName = "Linux";
+    readonly capabilities: ProviderCapabilities;
+    private isX11;
+    initialize(): Promise<void>;
+    isAvailable(): Promise<boolean>;
+    shutdown(): Promise<void>;
+    /**
+     * Map a key name to the xdotool equivalent
+     */
+    private mapKey;
+    getMousePosition(): Promise<MousePosition>;
+    moveMouse(x: number, y: number, options?: MouseMoveOptions): Promise<void>;
+    click(options?: MouseClickOptions): Promise<void>;
+    doubleClick(button?: MouseButton): Promise<void>;
+    rightClick(): Promise<void>;
+    drag(fromX: number, fromY: number, toX: number, toY: number, _options?: MouseDragOptions): Promise<void>;
+    scroll(options: MouseScrollOptions): Promise<void>;
+    keyPress(key: KeyCode, options?: KeyPressOptions): Promise<void>;
+    keyDown(key: KeyCode): Promise<void>;
+    keyUp(key: KeyCode): Promise<void>;
+    type(text: string, options?: TypeOptions): Promise<void>;
+    hotkey(sequence: HotkeySequence): Promise<void>;
+    getActiveWindow(): Promise<WindowInfo | null>;
+    getWindows(options?: WindowSearchOptions): Promise<WindowInfo[]>;
+    getWindow(handle: string): Promise<WindowInfo | null>;
+    focusWindow(handle: string): Promise<void>;
+    minimizeWindow(handle: string): Promise<void>;
+    maximizeWindow(handle: string): Promise<void>;
+    restoreWindow(handle: string): Promise<void>;
+    closeWindow(handle: string): Promise<void>;
+    setWindow(handle: string, options: WindowSetOptions): Promise<void>;
+    getRunningApps(): Promise<AppInfo[]>;
+    launchApp(appPath: string, options?: AppLaunchOptions): Promise<AppInfo>;
+    closeApp(pid: number): Promise<void>;
+    getScreens(): Promise<ScreenInfo[]>;
+    getPixelColor(_x: number, _y: number): Promise<ColorInfo>;
+    getClipboard(): Promise<ClipboardContent>;
+    setClipboard(content: Partial<ClipboardContent>): Promise<void>;
+    clearClipboard(): Promise<void>;
+}