strray-ai 1.22.21 → 1.22.22

package/dist/integrations/openclaw/client.js

@@ -0,0 +1,447 @@
+/**
+ * OpenClaw WebSocket Client
+ *
+ * Implements OpenClaw Gateway Protocol v3 with proper request/response handling,
+ * reconnection logic, and event management.
+ *
+ * @version 1.0.0
+ * @since 2026-03-14
+ */
+import { WebSocket } from 'ws';
+import * as crypto from 'crypto';
+import { isOpenClawResponse, isOpenClawEvent, OpenClawTimeoutError, OpenClawConnectionError, } from './types.js';
+/**
+ * OpenClaw WebSocket Client
+ */
+export class OpenClawClient {
+    ws = null;
+    config;
+    state = 'disconnected';
+    pendingRequests = new Map();
+    eventListeners = new Map();
+    stateListeners = new Set();
+    reconnectAttempts = 0;
+    reconnectTimeout = null;
+    pingInterval = null;
+    stats = {
+        messagesSent: 0,
+        messagesReceived: 0,
+        requestsSent: 0,
+        requestsSucceeded: 0,
+        requestsFailed: 0,
+        reconnects: 0,
+        errors: 0,
+    };
+    logger;
+    constructor(config) {
+        this.config = {
+            gatewayUrl: config.gatewayUrl || 'ws://127.0.0.1:18789',
+            authToken: config.authToken || '',
+            deviceId: config.deviceId || '',
+            deviceKeyPair: config.deviceKeyPair || { publicKey: '', privateKey: '' },
+            reconnect: config.reconnect ?? true,
+            reconnectAttempts: config.reconnectAttempts ?? 5,
+            reconnectDelay: config.reconnectDelay ?? 1000,
+            pingInterval: config.pingInterval ?? 30000,
+            requestTimeout: config.requestTimeout ?? 30000,
+        };
+        // Use console but can be replaced with proper logger
+        this.logger = console;
+    }
+    /**
+     * Connect to OpenClaw Gateway
+     */
+    async connect() {
+        if (this.state === 'connected' || this.state === 'authenticating') {
+            this.logger.warn('[OpenClawClient] Already connected or connecting');
+            return;
+        }
+        this.setState('connecting');
+        return new Promise((resolve, reject) => {
+            try {
+                this.ws = new WebSocket(this.config.gatewayUrl);
+                this.ws.on('open', () => {
+                    this.logger.info('[OpenClawClient] WebSocket connected, sending handshake...');
+                    this.sendHandshake();
+                    resolve();
+                });
+                this.ws.on('message', (data) => {
+                    const message = typeof data === 'string' ? data : String(data);
+                    this.handleMessage(message);
+                });
+                this.ws.on('close', (code, reason) => {
+                    this.logger.info(`[OpenClawClient] Connection closed: ${code} ${String(reason)}`);
+                    this.handleDisconnect(Number(code), String(reason));
+                });
+                this.ws.on('error', (error) => {
+                    this.logger.error('[OpenClawClient] WebSocket error:', error instanceof Error ? error.message : String(error));
+                    this.stats.errors++;
+                    if (this.state === 'connecting') {
+                        reject(new OpenClawConnectionError(`Failed to connect to ${this.config.gatewayUrl}: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined));
+                    }
+                });
+                this.ws.on('ping', () => {
+                    this.logger.debug('[OpenClawClient] Received ping');
+                });
+                this.ws.on('pong', () => {
+                    this.logger.debug('[OpenClawClient] Received pong');
+                });
+            }
+            catch (error) {
+                this.setState('error');
+                reject(new OpenClawConnectionError('Failed to create WebSocket connection', error));
+            }
+        });
+    }
+    /**
+     * Disconnect from OpenClaw Gateway
+     */
+    disconnect() {
+        this.logger.info('[OpenClawClient] Disconnecting...');
+        // Clear reconnection
+        if (this.reconnectTimeout) {
+            clearTimeout(this.reconnectTimeout);
+            this.reconnectTimeout = null;
+        }
+        // Clear ping interval
+        if (this.pingInterval) {
+            clearInterval(this.pingInterval);
+            this.pingInterval = null;
+        }
+        // Reject pending requests
+        for (const [id, request] of this.pendingRequests.entries()) {
+            clearTimeout(request.timeout);
+            request.reject(new Error('Connection closed'));
+            this.pendingRequests.delete(id);
+        }
+        // Close WebSocket
+        if (this.ws) {
+            this.ws.removeAllListeners();
+            this.ws.close(1000, 'Client disconnecting');
+            this.ws = null;
+        }
+        this.setState('disconnected');
+    }
+    /**
+     * Send request and wait for response
+     */
+    async sendRequest(method, params = {}) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            throw new Error('Not connected to OpenClaw Gateway');
+        }
+        const id = this.generateId();
+        const frame = {
+            type: 'req',
+            id,
+            method,
+            params,
+        };
+        this.logger.debug(`[OpenClawClient] Sending request: ${method} (${id})`);
+        this.stats.requestsSent++;
+        return new Promise((resolve, reject) => {
+            // Set timeout
+            const timeout = setTimeout(() => {
+                this.pendingRequests.delete(id);
+                this.stats.requestsFailed++;
+                reject(new OpenClawTimeoutError(method, this.config.requestTimeout));
+            }, this.config.requestTimeout);
+            // Store pending request
+            this.pendingRequests.set(id, {
+                resolve: (value) => {
+                    clearTimeout(timeout);
+                    this.stats.requestsSucceeded++;
+                    resolve(value);
+                },
+                reject: (reason) => {
+                    clearTimeout(timeout);
+                    this.stats.requestsFailed++;
+                    reject(reason);
+                },
+                timeout,
+                timestamp: Date.now(),
+            });
+            // Send frame
+            try {
+                this.ws.send(JSON.stringify(frame));
+                this.stats.messagesSent++;
+            }
+            catch (error) {
+                clearTimeout(timeout);
+                this.pendingRequests.delete(id);
+                this.stats.errors++;
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Subscribe to events
+     */
+    async subscribeToEvents(events) {
+        await this.sendRequest('events.subscribe', { events });
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Check if connected
+     */
+    isConnected() {
+        return this.state === 'connected' || this.state === 'authorized';
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Add event listener
+     */
+    on(event, listener) {
+        if (!this.eventListeners.has(event)) {
+            this.eventListeners.set(event, new Set());
+        }
+        this.eventListeners.get(event).add(listener);
+    }
+    /**
+     * Remove event listener
+     */
+    off(event, listener) {
+        const listeners = this.eventListeners.get(event);
+        if (listeners) {
+            listeners.delete(listener);
+        }
+    }
+    /**
+     * Add state change listener
+     */
+    onStateChange(listener) {
+        this.stateListeners.add(listener);
+    }
+    /**
+     * Remove state change listener
+     */
+    offStateChange(listener) {
+        this.stateListeners.delete(listener);
+    }
+    // =========================================================================
+    // Private Methods
+    // =========================================================================
+    /**
+     * Send handshake on connect
+     */
+    sendHandshake() {
+        const params = {
+            minProtocol: 3,
+            maxProtocol: 3,
+            client: {
+                id: 'strray-integration',
+                version: '1.0.0',
+                platform: process.platform,
+                mode: 'operator',
+            },
+            role: 'operator',
+            scopes: ['operator.read', 'operator.write'],
+            caps: [],
+            commands: [],
+            userAgent: `0xRay-OpenClaw-Integration/1.0.0`,
+        };
+        // Add auth if provided
+        if (this.config.authToken) {
+            params.auth = { token: this.config.authToken };
+        }
+        // Add device if provided
+        if (this.config.deviceId && this.config.deviceKeyPair) {
+            params.device = {
+                id: this.config.deviceId,
+                publicKey: this.config.deviceKeyPair.publicKey,
+                signature: this.signDeviceChallenge(this.config.deviceId),
+                signedAt: Date.now(),
+                nonce: this.generateNonce(),
+            };
+        }
+        // Send connect request
+        this.sendRequest('connect', params).catch((error) => {
+            this.logger.error('[OpenClawClient] Handshake failed:', error);
+            this.setState('error');
+        });
+    }
+    /**
+     * Handle incoming WebSocket message
+     */
+    handleMessage(data) {
+        this.stats.messagesReceived++;
+        try {
+            const frame = JSON.parse(data);
+            if (isOpenClawResponse(frame)) {
+                this.handleResponse(frame);
+            }
+            else if (isOpenClawEvent(frame)) {
+                this.handleEvent(frame);
+            }
+            else {
+                this.logger.warn('[OpenClawClient] Unknown frame type:', frame);
+            }
+        }
+        catch (error) {
+            this.logger.error('[OpenClawClient] Failed to parse message:', error);
+            this.stats.errors++;
+        }
+    }
+    /**
+     * Handle response frame
+     */
+    handleResponse(frame) {
+        const pending = this.pendingRequests.get(frame.id);
+        if (pending) {
+            this.pendingRequests.delete(frame.id);
+            if (frame.ok) {
+                pending.resolve(frame.result);
+            }
+            else {
+                const error = new Error(frame.error?.message || 'Request failed');
+                error.code = frame.error?.code;
+                pending.reject(error);
+            }
+        }
+        else {
+            this.logger.warn('[OpenClawClient] Received response for unknown request:', frame.id);
+        }
+    }
+    /**
+     * Handle event frame
+     */
+    handleEvent(frame) {
+        this.logger.debug('[OpenClawClient] Event:', frame.event);
+        // Handle specific events
+        if (frame.event === 'authorized') {
+            this.setState('authorized');
+            this.startPingInterval();
+        }
+        // Notify listeners
+        const listeners = this.eventListeners.get(frame.event);
+        if (listeners) {
+            for (const listener of listeners) {
+                try {
+                    listener(frame.data);
+                }
+                catch (error) {
+                    this.logger.error('[OpenClawClient] Event listener error:', error);
+                }
+            }
+        }
+        // Notify all-event listeners
+        const allListeners = this.eventListeners.get('*');
+        if (allListeners) {
+            for (const listener of allListeners) {
+                try {
+                    listener(frame.event, frame.data);
+                }
+                catch (error) {
+                    this.logger.error('[OpenClawClient] All-event listener error:', error);
+                }
+            }
+        }
+    }
+    /**
+     * Handle disconnection
+     */
+    handleDisconnect(code, reason) {
+        // Stop ping interval
+        if (this.pingInterval) {
+            clearInterval(this.pingInterval);
+            this.pingInterval = null;
+        }
+        // Set state
+        if (this.state !== 'disconnected') {
+            this.setState('disconnected');
+        }
+        // Attempt reconnection
+        if (this.config.reconnect && this.reconnectAttempts < this.config.reconnectAttempts) {
+            this.scheduleReconnect();
+        }
+    }
+    /**
+     * Schedule reconnection
+     */
+    scheduleReconnect() {
+        if (this.reconnectTimeout) {
+            return;
+        }
+        this.reconnectAttempts++;
+        this.stats.reconnects++;
+        const delay = this.config.reconnectDelay * Math.pow(2, this.reconnectAttempts - 1);
+        const maxDelay = 30000;
+        const actualDelay = Math.min(delay, maxDelay);
+        this.logger.info(`[OpenClawClient] Scheduling reconnect attempt ${this.reconnectAttempts}/${this.config.reconnectAttempts} in ${actualDelay}ms`);
+        this.setState('reconnecting');
+        this.reconnectTimeout = setTimeout(() => {
+            this.reconnectTimeout = null;
+            this.connect().catch((error) => {
+                this.logger.error('[OpenClawClient] Reconnection failed:', error);
+            });
+        }, actualDelay);
+    }
+    /**
+     * Start ping interval for connection health
+     */
+    startPingInterval() {
+        this.pingInterval = setInterval(() => {
+            if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+                this.ws.ping();
+            }
+        }, this.config.pingInterval);
+    }
+    /**
+     * Set client state
+     */
+    setState(newState) {
+        const previousState = this.state;
+        this.state = newState;
+        if (previousState !== newState) {
+            this.logger.info(`[OpenClawClient] State: ${previousState} → ${newState}`);
+            // Notify state listeners
+            for (const listener of this.stateListeners) {
+                try {
+                    listener(newState, previousState);
+                }
+                catch (error) {
+                    this.logger.error('[OpenClawClient] State listener error:', error);
+                }
+            }
+        }
+    }
+    /**
+     * Generate unique ID for requests
+     */
+    generateId() {
+        return `${Date.now()}-${crypto.randomBytes(4).toString('hex')}`;
+    }
+    /**
+     * Generate nonce for device pairing
+     */
+    generateNonce() {
+        return crypto.randomBytes(16).toString('base64');
+    }
+    /**
+     * Sign device challenge
+     */
+    signDeviceChallenge(deviceId) {
+        if (!this.config.deviceKeyPair) {
+            return '';
+        }
+        const hmac = crypto.createHmac('sha256', this.config.deviceKeyPair.privateKey);
+        hmac.update(deviceId);
+        return hmac.digest('base64');
+    }
+}
+/**
+ * Factory function to create client
+ */
+export function createOpenClawClient(config) {
+    return new OpenClawClient(config);
+}
+//# sourceMappingURL=client.js.map

package/dist/integrations/openclaw/client.js.map

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

package/dist/integrations/openclaw/config.d.ts

@@ -0,0 +1,97 @@
+/**
+ * OpenClaw Configuration Loader
+ *
+ * Handles loading, validation, and management of OpenClaw integration configuration.
+ *
+ * @version 1.0.0
+ * @since 2026-03-14
+ */
+import { OpenClawIntegrationConfig, ConfigValidationResult } from './types.js';
+/**
+ * Configuration loader class
+ */
+export declare class OpenClawConfigLoader {
+    private config;
+    private configPath;
+    private loadedAt;
+    constructor(configPath?: string);
+    /**
+     * Load configuration from file with environment variable overrides
+     */
+    load(): OpenClawIntegrationConfig;
+    /**
+     * Reload configuration from file
+     */
+    reload(): OpenClawIntegrationConfig;
+    /**
+     * Get current configuration
+     */
+    getConfig(): OpenClawIntegrationConfig;
+    /**
+     * Get configuration age in milliseconds
+     */
+    getConfigAge(): number;
+    /**
+     * Check if configuration needs reload
+     */
+    needsReload(maxAgeMs?: number): boolean;
+    /**
+     * Apply environment variable overrides
+     */
+    private applyEnvironmentOverrides;
+    /**
+     * Merge user config with defaults
+     */
+    private mergeWithDefaults;
+    /**
+     * Validate configuration
+     */
+    validateConfig(config: OpenClawIntegrationConfig): ConfigValidationResult;
+    /**
+     * Get configuration file path
+     */
+    getConfigPath(): string;
+    /**
+     * Check if configuration file exists
+     */
+    configExists(): boolean;
+    /**
+     * Create sample configuration file
+     */
+    createSampleConfig(): void;
+    /**
+     * Get config for API server only
+     */
+    getAPIServerConfig(): {
+        enabled: boolean;
+        port: number;
+        host?: string;
+        apiKey?: string;
+    };
+    /**
+     * Get config for hooks only
+     */
+    getHooksConfig(): {
+        enabled: boolean;
+        toolBefore: boolean;
+        toolAfter: boolean;
+        includeArgs: boolean;
+        includeResult: boolean;
+        toolFilter?: string[];
+    };
+    /**
+     * Check if integration is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Check if API server is enabled
+     */
+    isAPIServerEnabled(): boolean;
+    /**
+     * Check if hooks are enabled
+     */
+    areHooksEnabled(): boolean;
+}
+export declare const configLoader: OpenClawConfigLoader;
+export declare function createConfigLoader(configPath?: string): OpenClawConfigLoader;
+//# sourceMappingURL=config.d.ts.map

package/dist/integrations/openclaw/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/integrations/openclaw/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EAGvB,MAAM,YAAY,CAAC;AAwCpB;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAa;gBAEjB,UAAU,CAAC,EAAE,MAAM;IAK/B;;OAEG;IACH,IAAI,IAAI,yBAAyB;IAoCjC;;OAEG;IACH,MAAM,IAAI,yBAAyB;IAMnC;;OAEG;IACH,SAAS,IAAI,yBAAyB;IAOtC;;OAEG;IACH,YAAY,IAAI,MAAM;IAKtB;;OAEG;IACH,WAAW,CAAC,QAAQ,GAAE,MAAc,GAAG,OAAO;IAI9C;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA2CjC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqCzB;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,yBAAyB,GAAG,sBAAsB;IAkGzE;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,kBAAkB,IAAI,IAAI;IA0C1B;;OAEG;IACH,kBAAkB;;;;;;IAKlB;;OAEG;IACH,cAAc;;;;;;;;IAKd;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;IACH,eAAe,IAAI,OAAO;CAI3B;AAGD,eAAO,MAAM,YAAY,sBAA6B,CAAC;AAGvD,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAE5E"}