strray-ai 1.22.21 → 1.22.22

package/dist/integrations/openclaw/config.js

@@ -0,0 +1,375 @@
+/**
+ * OpenClaw Configuration Loader
+ *
+ * Handles loading, validation, and management of OpenClaw integration configuration.
+ *
+ * @version 1.0.0
+ * @since 2026-03-14
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+/**
+ * Default configuration values
+ */
+const DEFAULT_CONFIG = {
+    gatewayUrl: 'ws://127.0.0.1:18789',
+    autoReconnect: true,
+    maxReconnectAttempts: 5,
+    reconnectDelay: 1000,
+    apiServer: {
+        enabled: true,
+        port: 18431,
+        host: '127.0.0.1',
+    },
+    hooks: {
+        enabled: true,
+        toolBefore: true,
+        toolAfter: true,
+        includeArgs: true,
+        includeResult: true,
+    },
+    enabled: true,
+    debug: false,
+    logLevel: 'info',
+};
+/**
+ * Environment variable mappings
+ */
+const ENV_MAPPINGS = {
+    OPENCLAW_GATEWAY_URL: 'gatewayUrl',
+    OPENCLAW_AUTH_TOKEN: 'authToken',
+    OPENCLAW_DEVICE_ID: 'deviceId',
+    OPENCLAW_API_KEY: 'apiServer.apiKey',
+    OPENCLAW_API_PORT: 'apiServer.port',
+    OPENCLAW_ENABLED: 'enabled',
+    OPENCLAW_DEBUG: 'debug',
+};
+/**
+ * Configuration loader class
+ */
+export class OpenClawConfigLoader {
+    config = null;
+    configPath;
+    loadedAt = 0;
+    constructor(configPath) {
+        this.configPath = configPath ||
+            path.join(process.cwd(), '.opencode', 'openclaw', 'config.json');
+    }
+    /**
+     * Load configuration from file with environment variable overrides
+     */
+    load() {
+        try {
+            // Load from file if exists
+            let userConfig = {};
+            if (fs.existsSync(this.configPath)) {
+                const configContent = fs.readFileSync(this.configPath, 'utf-8');
+                userConfig = JSON.parse(configContent);
+            }
+            // Apply environment variable overrides
+            userConfig = this.applyEnvironmentOverrides(userConfig);
+            // Merge with defaults
+            this.config = this.mergeWithDefaults(userConfig);
+            // Validate configuration
+            const validation = this.validateConfig(this.config);
+            if (!validation.valid) {
+                throw new Error(`Configuration validation failed: ${validation.errors.map(e => e.message).join(', ')}`);
+            }
+            this.loadedAt = Date.now();
+            return this.config;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to load OpenClaw configuration: ${error.message}`);
+            }
+            throw new Error('Failed to load OpenClaw configuration: Unknown error');
+        }
+    }
+    /**
+     * Reload configuration from file
+     */
+    reload() {
+        this.config = null;
+        this.loadedAt = 0;
+        return this.load();
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        if (!this.config) {
+            return this.load();
+        }
+        return this.config;
+    }
+    /**
+     * Get configuration age in milliseconds
+     */
+    getConfigAge() {
+        if (!this.loadedAt)
+            return 0;
+        return Date.now() - this.loadedAt;
+    }
+    /**
+     * Check if configuration needs reload
+     */
+    needsReload(maxAgeMs = 60000) {
+        return this.getConfigAge() > maxAgeMs;
+    }
+    /**
+     * Apply environment variable overrides
+     */
+    applyEnvironmentOverrides(config) {
+        const result = { ...config };
+        for (const [envVar, configPath] of Object.entries(ENV_MAPPINGS)) {
+            const envValue = process.env[envVar];
+            if (envValue !== undefined) {
+                // Parse value based on expected type
+                let parsedValue = envValue;
+                // Handle boolean values
+                if (envValue.toLowerCase() === 'true') {
+                    parsedValue = true;
+                }
+                else if (envValue.toLowerCase() === 'false') {
+                    parsedValue = false;
+                }
+                // Handle numeric values
+                else if (/^\d+$/.test(envValue)) {
+                    parsedValue = parseInt(envValue, 10);
+                }
+                // Set nested value
+                const keys = configPath.split('.');
+                let current = result;
+                for (let i = 0; i < keys.length - 1; i++) {
+                    const key = keys[i];
+                    if (!current[key]) {
+                        current[key] = {};
+                    }
+                    current = current[key];
+                }
+                current[keys[keys.length - 1]] = parsedValue;
+            }
+        }
+        return result;
+    }
+    /**
+     * Merge user config with defaults
+     */
+    mergeWithDefaults(userConfig) {
+        // Handle nested defaults
+        const apiServerDefaults = DEFAULT_CONFIG.apiServer || { enabled: true, port: 18431, host: '127.0.0.1' };
+        const hooksDefaults = DEFAULT_CONFIG.hooks || { enabled: true, toolBefore: true, toolAfter: true, includeArgs: true, includeResult: true };
+        const result = {
+            gatewayUrl: userConfig.gatewayUrl || DEFAULT_CONFIG.gatewayUrl || 'ws://127.0.0.1:18789',
+            autoReconnect: userConfig.autoReconnect ?? DEFAULT_CONFIG.autoReconnect ?? true,
+            maxReconnectAttempts: userConfig.maxReconnectAttempts ?? DEFAULT_CONFIG.maxReconnectAttempts ?? 5,
+            reconnectDelay: userConfig.reconnectDelay ?? DEFAULT_CONFIG.reconnectDelay ?? 1000,
+            apiServer: {
+                enabled: userConfig.apiServer?.enabled ?? apiServerDefaults.enabled ?? true,
+                port: userConfig.apiServer?.port ?? apiServerDefaults.port ?? 18431,
+                host: userConfig.apiServer?.host ?? apiServerDefaults.host ?? '127.0.0.1',
+                ...(userConfig.apiServer?.apiKey !== undefined ? { apiKey: userConfig.apiServer.apiKey } : {}),
+            },
+            hooks: {
+                enabled: userConfig.hooks?.enabled ?? hooksDefaults.enabled ?? true,
+                toolBefore: userConfig.hooks?.toolBefore ?? hooksDefaults.toolBefore ?? true,
+                toolAfter: userConfig.hooks?.toolAfter ?? hooksDefaults.toolAfter ?? true,
+                includeArgs: userConfig.hooks?.includeArgs ?? hooksDefaults.includeArgs ?? true,
+                includeResult: userConfig.hooks?.includeResult ?? hooksDefaults.includeResult ?? true,
+            },
+            enabled: userConfig.enabled ?? DEFAULT_CONFIG.enabled ?? true,
+            debug: userConfig.debug ?? DEFAULT_CONFIG.debug ?? false,
+            logLevel: userConfig.logLevel ?? DEFAULT_CONFIG.logLevel ?? 'info',
+        };
+        if (userConfig.authToken !== undefined)
+            result.authToken = userConfig.authToken;
+        if (userConfig.deviceId !== undefined)
+            result.deviceId = userConfig.deviceId;
+        if (userConfig.deviceKeyPair !== undefined)
+            result.deviceKeyPair = userConfig.deviceKeyPair;
+        return result;
+    }
+    /**
+     * Validate configuration
+     */
+    validateConfig(config) {
+        const errors = [];
+        const warnings = [];
+        // Validate gateway URL
+        if (!config.gatewayUrl) {
+            errors.push({
+                field: 'gatewayUrl',
+                message: 'gatewayUrl is required',
+                code: 'MISSING_REQUIRED',
+            });
+        }
+        else {
+            try {
+                const url = new URL(config.gatewayUrl);
+                if (!['ws:', 'wss:'].includes(url.protocol)) {
+                    errors.push({
+                        field: 'gatewayUrl',
+                        message: 'gatewayUrl must be a WebSocket URL (ws:// or wss://)',
+                        code: 'INVALID_PROTOCOL',
+                    });
+                }
+            }
+            catch {
+                errors.push({
+                    field: 'gatewayUrl',
+                    message: 'gatewayUrl is not a valid URL',
+                    code: 'INVALID_URL',
+                });
+            }
+        }
+        // Validate API server port
+        if (config.apiServer?.enabled) {
+            if (!config.apiServer.port || config.apiServer.port < 1 || config.apiServer.port > 65535) {
+                errors.push({
+                    field: 'apiServer.port',
+                    message: 'apiServer.port must be between 1 and 65535',
+                    code: 'INVALID_PORT',
+                });
+            }
+            // Warn if binding to non-localhost
+            if (config.apiServer.host && !['localhost', '127.0.0.1', '::1'].includes(config.apiServer.host)) {
+                warnings.push({
+                    field: 'apiServer.host',
+                    message: 'Binding API server to non-localhost address may expose API externally',
+                });
+            }
+        }
+        // Validate reconnection settings
+        if (config.maxReconnectAttempts < 0) {
+            errors.push({
+                field: 'maxReconnectAttempts',
+                message: 'maxReconnectAttempts must be non-negative',
+                code: 'INVALID_VALUE',
+            });
+        }
+        if (config.reconnectDelay < 0) {
+            errors.push({
+                field: 'reconnectDelay',
+                message: 'reconnectDelay must be non-negative',
+                code: 'INVALID_VALUE',
+            });
+        }
+        // Validate log level
+        const validLogLevels = ['error', 'warn', 'info', 'debug'];
+        if (config.logLevel && !validLogLevels.includes(config.logLevel)) {
+            errors.push({
+                field: 'logLevel',
+                message: `logLevel must be one of: ${validLogLevels.join(', ')}`,
+                code: 'INVALID_VALUE',
+            });
+        }
+        // Warnings for potentially problematic configs
+        if (config.apiServer?.enabled && !config.apiServer.apiKey) {
+            warnings.push({
+                field: 'apiServer.apiKey',
+                message: 'API server is enabled without an API key - consider adding one for security',
+            });
+        }
+        if (config.autoReconnect && config.maxReconnectAttempts === 0) {
+            warnings.push({
+                field: 'autoReconnect',
+                message: 'autoReconnect is true but maxReconnectAttempts is 0',
+            });
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Get configuration file path
+     */
+    getConfigPath() {
+        return this.configPath;
+    }
+    /**
+     * Check if configuration file exists
+     */
+    configExists() {
+        return fs.existsSync(this.configPath);
+    }
+    /**
+     * Create sample configuration file
+     */
+    createSampleConfig() {
+        const configDir = path.dirname(this.configPath);
+        // Create directory if it doesn't exist
+        if (!fs.existsSync(configDir)) {
+            fs.mkdirSync(configDir, { recursive: true });
+        }
+        const sampleConfig = {
+            gatewayUrl: 'ws://127.0.0.1:18789',
+            // SECURITY WARNING: authToken MUST be configured before use.
+            // Leaving this empty will prevent authenticated connections.
+            authToken: process.env.OPENCLAW_AUTH_TOKEN || '',
+            deviceId: process.env.OPENCLAW_DEVICE_ID || 'your-device-id',
+            autoReconnect: true,
+            maxReconnectAttempts: 5,
+            reconnectDelay: 1000,
+            apiServer: {
+                enabled: true,
+                port: 18431,
+                host: '127.0.0.1',
+                ...(process.env.OPENCLAW_API_KEY ? { apiKey: process.env.OPENCLAW_API_KEY } : {}),
+            },
+            hooks: {
+                enabled: true,
+                toolBefore: true,
+                toolAfter: true,
+                includeArgs: true,
+                includeResult: true,
+            },
+            enabled: true, // Disabled by default until configured
+            debug: false,
+            logLevel: 'info',
+        };
+        fs.writeFileSync(this.configPath, JSON.stringify(sampleConfig, null, 2) + os.EOL, 'utf-8');
+    }
+    /**
+     * Get config for API server only
+     */
+    getAPIServerConfig() {
+        const config = this.getConfig();
+        return config.apiServer;
+    }
+    /**
+     * Get config for hooks only
+     */
+    getHooksConfig() {
+        const config = this.getConfig();
+        return config.hooks;
+    }
+    /**
+     * Check if integration is enabled
+     */
+    isEnabled() {
+        return this.getConfig().enabled;
+    }
+    /**
+     * Check if API server is enabled
+     */
+    isAPIServerEnabled() {
+        return this.getConfig().apiServer?.enabled ?? false;
+    }
+    /**
+     * Check if hooks are enabled
+     */
+    areHooksEnabled() {
+        const config = this.getConfig();
+        return config.hooks?.enabled ?? false;
+    }
+}
+// Export singleton instance
+export const configLoader = new OpenClawConfigLoader();
+// Export factory function
+export function createConfigLoader(configPath) {
+    return new OpenClawConfigLoader(configPath);
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/integrations/openclaw/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAQzB;;GAEG;AACH,MAAM,cAAc,GAA8B;IAChD,UAAU,EAAE,sBAAsB;IAClC,aAAa,EAAE,IAAI;IACnB,oBAAoB,EAAE,CAAC;IACvB,cAAc,EAAE,IAAI;IACpB,SAAS,EAAE;QACT,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,WAAW;KAClB;IACD,KAAK,EAAE;QACL,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,IAAI;QAChB,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,IAAI;KACpB;IACD,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,KAAK;IACZ,QAAQ,EAAE,MAAM;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,YAAY,GAA2B;IAC3C,oBAAoB,EAAE,YAAY;IAClC,mBAAmB,EAAE,WAAW;IAChC,kBAAkB,EAAE,UAAU;IAC9B,gBAAgB,EAAE,kBAAkB;IACpC,iBAAiB,EAAE,gBAAgB;IACnC,gBAAgB,EAAE,SAAS;IAC3B,cAAc,EAAE,OAAO;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,oBAAoB;IACvB,MAAM,GAAqC,IAAI,CAAC;IAChD,UAAU,CAAS;IACnB,QAAQ,GAAW,CAAC,CAAC;IAE7B,YAAY,UAAmB;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU;YAC1B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC;YACH,2BAA2B;YAC3B,IAAI,UAAU,GAAuC,EAAE,CAAC;YAExD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;gBACnC,MAAM,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAChE,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YACzC,CAAC;YAED,uCAAuC;YACvC,UAAU,GAAG,IAAI,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC;YAExD,sBAAsB;YACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAEjD,yBAAyB;YACzB,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CACb,oCAAoC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvF,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CACb,0CAA0C,KAAK,CAAC,OAAO,EAAE,CAC1D,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,WAAmB,KAAK;QAClC,OAAO,IAAI,CAAC,YAAY,EAAE,GAAG,QAAQ,CAAC;IACxC,CAAC;IAED;;OAEG;IACK,yBAAyB,CAC/B,MAA0C;QAE1C,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;QAE7B,KAAK,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAErC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,qCAAqC;gBACrC,IAAI,WAAW,GAAY,QAAQ,CAAC;gBAEpC,wBAAwB;gBACxB,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;oBACtC,WAAW,GAAG,IAAI,CAAC;gBACrB,CAAC;qBAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,OAAO,EAAE,CAAC;oBAC9C,WAAW,GAAG,KAAK,CAAC;gBACtB,CAAC;gBAED,wBAAwB;qBACnB,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAChC,WAAW,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBACvC,CAAC;gBAED,mBAAmB;gBACnB,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACnC,IAAI,OAAO,GAA4B,MAA4C,CAAC;gBAEpF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;oBACzC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;oBACrB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;wBAClB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;oBACpB,CAAC;oBACD,OAAO,GAAG,OAAO,CAAC,GAAG,CAA4B,CAAC;gBACpD,CAAC;gBAED,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,GAAG,WAAW,CAAC;YAChD,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,iBAAiB,CACvB,UAA8C;QAE9C,yBAAyB;QACzB,MAAM,iBAAiB,GAA2C,cAAc,CAAC,SAAS,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAChJ,MAAM,aAAa,GAAuC,cAAc,CAAC,KAAK,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QAE/K,MAAM,MAAM,GAA8B;YACxC,UAAU,EAAE,UAAU,CAAC,UAAU,IAAI,cAAc,CAAC,UAAU,IAAI,sBAAsB;YACxF,aAAa,EAAE,UAAU,CAAC,aAAa,IAAI,cAAc,CAAC,aAAa,IAAI,IAAI;YAC/E,oBAAoB,EAAE,UAAU,CAAC,oBAAoB,IAAI,cAAc,CAAC,oBAAoB,IAAI,CAAC;YACjG,cAAc,EAAE,UAAU,CAAC,cAAc,IAAI,cAAc,CAAC,cAAc,IAAI,IAAI;YAClF,SAAS,EAAE;gBACT,OAAO,EAAE,UAAU,CAAC,SAAS,EAAE,OAAO,IAAI,iBAAiB,CAAC,OAAO,IAAI,IAAI;gBAC3E,IAAI,EAAE,UAAU,CAAC,SAAS,EAAE,IAAI,IAAI,iBAAiB,CAAC,IAAI,IAAI,KAAK;gBACnE,IAAI,EAAE,UAAU,CAAC,SAAS,EAAE,IAAI,IAAI,iBAAiB,CAAC,IAAI,IAAI,WAAW;gBACzE,GAAG,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/F;YACD,KAAK,EAAE;gBACL,OAAO,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,IAAI,aAAa,CAAC,OAAO,IAAI,IAAI;gBACnE,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,UAAU,IAAI,aAAa,CAAC,UAAU,IAAI,IAAI;gBAC5E,SAAS,EAAE,UAAU,CAAC,KAAK,EAAE,SAAS,IAAI,aAAa,CAAC,SAAS,IAAI,IAAI;gBACzE,WAAW,EAAE,UAAU,CAAC,KAAK,EAAE,WAAW,IAAI,aAAa,CAAC,WAAW,IAAI,IAAI;gBAC/E,aAAa,EAAE,UAAU,CAAC,KAAK,EAAE,aAAa,IAAI,aAAa,CAAC,aAAa,IAAI,IAAI;aACtF;YACD,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO,IAAI,IAAI;YAC7D,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,cAAc,CAAC,KAAK,IAAI,KAAK;YACxD,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,cAAc,CAAC,QAAQ,IAAI,MAAM;SACnE,CAAC;QAEF,IAAI,UAAU,CAAC,SAAS,KAAK,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QAChF,IAAI,UAAU,CAAC,QAAQ,KAAK,SAAS;YAAE,MAAM,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QAC7E,IAAI,UAAU,CAAC,aAAa,KAAK,SAAS;YAAE,MAAM,CAAC,aAAa,GAAG,UAAU,CAAC,aAAa,CAAC;QAE5F,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,MAAiC;QAC9C,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAA8B,EAAE,CAAC;QAE/C,uBAAuB;QACvB,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,YAAY;gBACnB,OAAO,EAAE,wBAAwB;gBACjC,IAAI,EAAE,kBAAkB;aACzB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBACvC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC5C,MAAM,CAAC,IAAI,CAAC;wBACV,KAAK,EAAE,YAAY;wBACnB,OAAO,EAAE,sDAAsD;wBAC/D,IAAI,EAAE,kBAAkB;qBACzB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,YAAY;oBACnB,OAAO,EAAE,+BAA+B;oBACxC,IAAI,EAAE,aAAa;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,IAAI,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,GAAG,KAAK,EAAE,CAAC;gBACzF,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,gBAAgB;oBACvB,OAAO,EAAE,4CAA4C;oBACrD,IAAI,EAAE,cAAc;iBACrB,CAAC,CAAC;YACL,CAAC;YAED,mCAAmC;YACnC,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChG,QAAQ,CAAC,IAAI,CAAC;oBACZ,KAAK,EAAE,gBAAgB;oBACvB,OAAO,EAAE,uEAAuE;iBACjF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,iCAAiC;QACjC,IAAI,MAAM,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,sBAAsB;gBAC7B,OAAO,EAAE,2CAA2C;gBACpD,IAAI,EAAE,eAAe;aACtB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,MAAM,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,gBAAgB;gBACvB,OAAO,EAAE,qCAAqC;gBAC9C,IAAI,EAAE,eAAe;aACtB,CAAC,CAAC;QACL,CAAC;QAED,qBAAqB;QACrB,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,UAAU;gBACjB,OAAO,EAAE,4BAA4B,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBAChE,IAAI,EAAE,eAAe;aACtB,CAAC,CAAC;QACL,CAAC;QAED,+CAA+C;QAC/C,IAAI,MAAM,CAAC,SAAS,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAC1D,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,kBAAkB;gBACzB,OAAO,EAAE,6EAA6E;aACvF,CAAC,CAAC;QACL,CAAC;QAED,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,oBAAoB,KAAK,CAAC,EAAE,CAAC;YAC9D,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,eAAe;gBACtB,OAAO,EAAE,qDAAqD;aAC/D,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEhD,uCAAuC;QACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,YAAY,GAA8B;YAC9C,UAAU,EAAE,sBAAsB;YAClC,6DAA6D;YAC7D,6DAA6D;YAC7D,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE;YAChD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,gBAAgB;YAC5D,aAAa,EAAE,IAAI;YACnB,oBAAoB,EAAE,CAAC;YACvB,cAAc,EAAE,IAAI;YACpB,SAAS,EAAE;gBACT,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,WAAW;gBACjB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClF;YACD,KAAK,EAAE;gBACL,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,IAAI;gBAChB,SAAS,EAAE,IAAI;gBACf,WAAW,EAAE,IAAI;gBACjB,aAAa,EAAE,IAAI;aACpB;YACD,OAAO,EAAE,IAAI,EAAE,uCAAuC;YACtD,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,MAAM;SACjB,CAAC;QAEF,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAC9C,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,SAAS,EAAE,OAAO,IAAI,KAAK,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,eAAe;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC;IACxC,CAAC;CACF;AAED,4BAA4B;AAC5B,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAEvD,0BAA0B;AAC1B,MAAM,UAAU,kBAAkB,CAAC,UAAmB;IACpD,OAAO,IAAI,oBAAoB,CAAC,UAAU,CAAC,CAAC;AAC9C,CAAC"}

package/dist/integrations/openclaw/hooks/strray-hooks.d.ts

@@ -0,0 +1,125 @@
+/**
+ * OpenClaw 0xRay Hooks Integration
+ *
+ * Integrates OpenClaw with 0xRay's tool.before and tool.after hooks
+ * to send tool execution events to OpenClaw Gateway.
+ *
+ * @version 1.0.0
+ * @since 2026-03-14
+ */
+import { OpenClawClient } from '../client.js';
+/**
+ * Hooks configuration
+ */
+export interface OpenClawHooksConfig {
+    enabled: boolean;
+    toolBefore: boolean;
+    toolAfter: boolean;
+    includeArgs: boolean;
+    includeResult: boolean;
+    toolFilter?: string[];
+}
+/**
+ * 0xRay tool event
+ */
+export interface StringRayToolEvent {
+    toolName: string;
+    toolId: string;
+    args: Record<string, unknown>;
+    result?: unknown;
+    error?: string;
+    duration: number;
+    timestamp: number;
+    sessionId?: string;
+    agent?: string;
+}
+/**
+ * Hook event callback type
+ */
+export type ToolEventCallback = (event: StringRayToolEvent) => void | Promise<void>;
+/**
+ * OpenClaw Hooks Manager
+ */
+export declare class OpenClawHooksManager {
+    private client;
+    private config;
+    private initialized;
+    private toolBeforeCallbacks;
+    private toolAfterCallbacks;
+    private logger;
+    private eventQueue;
+    private maxQueueSize;
+    private isFlushing;
+    constructor(config: OpenClawHooksConfig);
+    /**
+     * Set the OpenClaw client
+     */
+    setClient(client: OpenClawClient): void;
+    /**
+     * Initialize hooks - registers with 0xRay's event system
+     */
+    initialize(): Promise<void>;
+    /**
+     * Register a callback for tool.before events
+     * Call this to connect to 0xRay's tool.before event system
+     */
+    registerToolBefore(callback: ToolEventCallback): void;
+    /**
+     * Unregister a tool.before callback
+     */
+    unregisterToolBefore(callback: ToolEventCallback): void;
+    /**
+     * Register a callback for tool.after events
+     * Call this to connect to 0xRay's tool.after event system
+     */
+    registerToolAfter(callback: ToolEventCallback): void;
+    /**
+     * Unregister a tool.after callback
+     */
+    unregisterToolAfter(callback: ToolEventCallback): void;
+    /**
+     * Handle tool.before event from 0xRay
+     */
+    onToolBefore(event: StringRayToolEvent): Promise<void>;
+    /**
+     * Handle tool.after event from 0xRay
+     */
+    onToolAfter(event: StringRayToolEvent): Promise<void>;
+    /**
+     * Queue an event for later delivery when connection is restored
+     */
+    private queueEvent;
+    /**
+     * Flush queued events to OpenClaw Gateway
+     */
+    private flushEventQueue;
+    /**
+     * Get the current queue size
+     */
+    getQueueSize(): number;
+    /**
+     * Called when client reconnects - flush the event queue
+     */
+    handleReconnect(): Promise<void>;
+    /**
+     * Shutdown hooks
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Check if hooks are initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<OpenClawHooksConfig>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): OpenClawHooksConfig;
+}
+/**
+ * Factory function to create hooks manager
+ */
+export declare function createOpenClawHooksManager(config: OpenClawHooksConfig): OpenClawHooksManager;
+//# sourceMappingURL=strray-hooks.d.ts.map

package/dist/integrations/openclaw/hooks/strray-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strray-hooks.d.ts","sourceRoot":"","sources":["../../../../src/integrations/openclaw/hooks/strray-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpF;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,mBAAmB,CAAqC;IAChE,OAAO,CAAC,kBAAkB,CAAqC;IAC/D,OAAO,CAAC,MAAM,CAAU;IAGxB,OAAO,CAAC,UAAU,CAAwE;IAC1F,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,mBAAmB;IAYvC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAIvC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBjC;;;OAGG;IACH,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAIrD;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAIvD;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAIpD;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAItD;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+C5D;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkD3D;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;YACW,eAAe;IA6B7B;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAU/B;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAOxD;;OAEG;IACH,SAAS,IAAI,mBAAmB;CAGjC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,mBAAmB,GAAG,oBAAoB,CAE5F"}