0xray 2.2.3 → 3.0.0

package/dist/integrations/hermes-agent/hermes-agent-integration.js

@@ -0,0 +1,504 @@
+/**
+ * Hermes Agent Integration
+ *
+ * Bridges 0xRay framework components to the Hermes CLI agent.
+ * Manages the bridge.mjs subprocess and wires tool event hooks
+ * through the framework's quality gate, processors, and state manager.
+ *
+ * Extends BaseIntegration for consistent lifecycle management with
+ * the integration registry.
+ *
+ * @version 2.0.0
+ * @since 2026-03-27
+ */
+import { execFile } from "child_process";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { BaseIntegration, } from "../base/index.js";
+import { frameworkLogger, generateJobId } from "../../core/framework-logger.js";
+import { beforeToolHook, afterToolHook } from '../enforcement-gate.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** Tools that produce/modify code and need quality gate + processors */
+const CODE_TOOLS = new Set([
+    "write_file",
+    "patch",
+    "execute_code",
+    "write",
+    "edit",
+]);
+/** Tools native to Hermes (not MCP) that should get nudged */
+const NUDGE_TOOLS = new Set(["terminal", "search_files"]);
+/**
+ * Hermes Agent Integration
+ *
+ * Manages the bridge subprocess and provides tool event hooks
+ * that pipe through 0xRay's quality gate and processor pipeline.
+ */
+export class HermesAgentIntegration extends BaseIntegration {
+    bridgePath;
+    pluginDir;
+    projectRoot;
+    bridgeTimeout;
+    hooksEnabled;
+    loggingEnabled;
+    /** Runtime statistics (separate from base IntegrationStats) */
+    hermesStats;
+    /** Bridge health cache */
+    cachedHealth = null;
+    lastHealthCheck = 0;
+    HEALTH_CACHE_TTL = 30_000; // 30s
+    constructor(config) {
+        super("hermes-agent", "2.0.0", config);
+        this.bridgePath = config?.bridgePath || join(__dirname, "bridge.mjs");
+        this.pluginDir =
+            config?.pluginDir || join(homedir(), ".hermes", "plugins", "xray-hermes");
+        this.projectRoot = config?.projectRoot || process.cwd();
+        this.bridgeTimeout = config?.bridgeTimeout || 15_000;
+        this.hooksEnabled = config?.hooksEnabled ?? true;
+        this.loggingEnabled = config?.loggingEnabled ?? true;
+        this.hermesStats = this.createEmptyStats();
+    }
+    // ==========================================================================
+    // BaseIntegration Implementation
+    // ==========================================================================
+    async performInitialization() {
+        await this.log("info", "Initializing Hermes Agent integration...");
+        // Validate bridge script exists
+        if (!existsSync(this.bridgePath)) {
+            await this.log("info", `Bridge script not found at ${this.bridgePath}`);
+            // Don't fail — tools will fall back to CLI
+            return;
+        }
+        // Validate plugin directory exists
+        if (!existsSync(this.pluginDir)) {
+            await this.log("info", `Plugin directory not found at ${this.pluginDir}`);
+            // Don't fail — may be a consumer install
+        }
+        // Perform initial health check
+        const health = await this.checkBridgeHealth();
+        this.cachedHealth = health;
+        this.lastHealthCheck = Date.now();
+        if (health.status === "ok" && health.framework === "loaded") {
+            const componentCount = Object.entries(health.components)
+                .filter(([, v]) => v)
+                .length;
+            await this.log("info", `Bridge connected — framework v${health.version} with ${componentCount}/4 components`);
+        }
+        else {
+            await this.log("info", `Bridge health: framework=${health.framework}, components=${JSON.stringify(health.components)}`);
+        }
+        // Store project root from health response
+        if (health.projectRoot && health.projectRoot !== "unknown") {
+            this.projectRoot = health.projectRoot;
+        }
+    }
+    async performShutdown() {
+        await this.log("info", "Shutting down Hermes Agent integration...");
+        this.cachedHealth = null;
+    }
+    async performHealthCheck() {
+        const health = await this.checkBridgeHealth();
+        this.cachedHealth = health;
+        this.lastHealthCheck = Date.now();
+        if (health.status === "ok" && health.framework === "loaded") {
+            const componentCount = Object.entries(health.components)
+                .filter(([, v]) => v)
+                .length;
+            return {
+                healthy: true,
+                message: `Framework v${health.version} loaded (${componentCount}/4 components)`,
+                details: {
+                    version: health.version,
+                    components: health.components,
+                    nodeVersion: health.nodeVersion,
+                    projectRoot: health.projectRoot,
+                    stats: this.hermesStats,
+                },
+            };
+        }
+        return {
+            healthy: false,
+            message: `Framework not loaded — ${health.framework}`,
+            details: {
+                version: health.version,
+                components: health.components,
+                projectRoot: health.projectRoot,
+                stats: this.hermesStats,
+            },
+        };
+    }
+    // ==========================================================================
+    // Bridge Communication
+    // ==========================================================================
+    /**
+     * Send a command to the bridge subprocess
+     */
+    async sendToBridge(request, timeout) {
+        const effectiveTimeout = timeout ?? this.bridgeTimeout;
+        return new Promise((resolve, reject) => {
+            const startTime = Date.now();
+            const options = {
+                cwd: this.projectRoot,
+                timeout: effectiveTimeout,
+                maxBuffer: 1024 * 1024, // 1MB
+                env: {
+                    ...process.env,
+                    XRAY_HOME: this.projectRoot,
+                },
+            };
+            const input = JSON.stringify(request);
+            const child = execFile("node", [this.bridgePath, "--cwd", this.projectRoot], options, (error, stdout, stderr) => {
+                const duration = Date.now() - startTime;
+                if (error) {
+                    this.hermesStats.bridgeErrors++;
+                    this.recordError(error);
+                    const isTimeout = "killed" in error && error.killed === true;
+                    reject(new Error(isTimeout
+                        ? `Bridge timeout after ${duration}ms`
+                        : `Bridge error: ${error.message}`));
+                    return;
+                }
+                try {
+                    const stdoutStr = typeof stdout === "string" ? stdout : String(stdout);
+                    const response = JSON.parse(stdoutStr.trim());
+                    resolve(response);
+                }
+                catch {
+                    this.hermesStats.bridgeErrors++;
+                    const stdoutStr = typeof stdout === "string" ? stdout : "";
+                    reject(new Error(`Bridge returned invalid JSON: ${stdoutStr.substring(0, 200)}`));
+                }
+            });
+            // Write request to stdin and close
+            if (child.stdin) {
+                child.stdin.write(input);
+                child.stdin.end();
+            }
+        });
+    }
+    /**
+     * Check bridge health (with caching)
+     */
+    async checkBridgeHealth() {
+        const now = Date.now();
+        if (this.cachedHealth &&
+            now - this.lastHealthCheck < this.HEALTH_CACHE_TTL) {
+            return this.cachedHealth;
+        }
+        try {
+            const response = await this.sendToBridge({
+                command: "health",
+            });
+            return response;
+        }
+        catch {
+            return {
+                status: "error",
+                framework: "not_loaded",
+                version: "unknown",
+                projectRoot: this.projectRoot,
+                components: {
+                    qualityGate: false,
+                    processorManager: false,
+                    stateManager: false,
+                    featuresConfig: false,
+                },
+                nodeVersion: process.version,
+            };
+        }
+    }
+    // ==========================================================================
+    // Tool Hook Methods
+    // ==========================================================================
+    /**
+     * Pre-tool-call hook
+     *
+     * Called before a tool executes. Runs quality gate and pre-processors
+     * for code-producing tools. Returns instructions for the caller.
+     */
+    async onPreToolCall(tool, args, toolId) {
+        this.hermesStats.totalToolCalls++;
+        // Emit event
+        const event = {
+            tool,
+            args: args || {},
+            toolId,
+            timestamp: Date.now(),
+        };
+        this.getEventEmitter().emit("pre-tool-call", event);
+        // 0xRay MCP tools — skip bridge entirely
+        if (this.isStrrayMcp(tool)) {
+            this.hermesStats.xrayMcpCalls++;
+            return { allowed: true };
+        }
+        // Native non-code tools — nudge if applicable
+        if (NUDGE_TOOLS.has(tool)) {
+            this.hermesStats.nativeToolCalls++;
+            const nudge = this.getToolNudge(tool);
+            return { allowed: true, nudge };
+        }
+        // Code-producing tools — run enforcement gate then bridge
+        if (CODE_TOOLS.has(tool)) {
+            this.hermesStats.codeOperations++;
+            this.hermesStats.qualityGateRuns++;
+            try {
+                const gateResult = await beforeToolHook(tool, args);
+                if (gateResult.blocked) {
+                    const msgs = gateResult.violations.map(v => `[${v.severity}] ${v.message}`).join("; ");
+                    await frameworkLogger.log('hermes-agent', 'pre-tool-blocked', 'warning', {
+                        tool, violations: msgs, resonance: gateResult.resonance,
+                    });
+                    return { allowed: false, nudge: `Enforcement blocked: ${msgs}` };
+                }
+                const result = await this.sendToBridge({
+                    command: "pre-process",
+                    tool,
+                    args: args || {},
+                });
+                if (result.passed) {
+                    if (result.processors?.ran) {
+                        this.hermesStats.preProcessorRuns++;
+                    }
+                    return { allowed: true, bridgeResult: result };
+                }
+                else {
+                    // Quality gate blocked
+                    this.hermesStats.qualityGateBlocks++;
+                    const blockEvent = {
+                        tool,
+                        args: args || {},
+                        violations: result.qualityGate?.violations || [],
+                        toolId,
+                        timestamp: Date.now(),
+                    };
+                    this.getEventEmitter().emit("quality-gate-block", blockEvent);
+                    return {
+                        allowed: false,
+                        nudge: `Quality gate blocked: ${(result.qualityGate?.violations || []).join(", ")}`,
+                        bridgeResult: result,
+                    };
+                }
+            }
+            catch (error) {
+                // Bridge failure — allow tool but log
+                this.hermesStats.bridgeErrors++;
+                this.recordError(error instanceof Error ? error : new Error(String(error)));
+                return { allowed: true };
+            }
+        }
+        // Other native tools — no bridge
+        this.hermesStats.nativeToolCalls++;
+        return { allowed: true };
+    }
+    /**
+     * Post-tool-call hook
+     *
+     * Called after a tool executes. Runs post-processors
+     * for code-producing tools.
+     */
+    async onPostToolCall(tool, args, result, error, toolId) {
+        // Emit event
+        const event = {
+            tool,
+            args: args || {},
+            result,
+            error,
+            toolId,
+            timestamp: Date.now(),
+        };
+        this.getEventEmitter().emit("post-tool-call", event);
+        // Skip non-code tools and 0xRay MCP tools
+        if (!CODE_TOOLS.has(tool) || this.isStrrayMcp(tool)) {
+            return;
+        }
+        try {
+            const postResult = await this.sendToBridge({
+                command: "post-process",
+                tool,
+                args: args || {},
+                result,
+                error: error || undefined,
+            });
+            if (postResult.processors?.ran) {
+                this.hermesStats.postProcessorRuns++;
+            }
+            try {
+                const afterResult = await afterToolHook(tool, args, result, error || null);
+                if (afterResult.governanceTriggered) {
+                    await frameworkLogger.log('hermes-agent', 'post-tool-governance-triggered', 'info', { tool });
+                }
+            }
+            catch (e) {
+                // Non-blocking — enforcement hook must never crash the tool call
+            }
+        }
+        catch {
+            // Bridge failure — silent
+            this.hermesStats.bridgeErrors++;
+        }
+    }
+    // ==========================================================================
+    // Tool Methods (mirrors Python plugin tools)
+    // ==========================================================================
+    /**
+     * Run xray_validate — validate files against quality gate
+    */
+    async validate(files, operation = "validate") {
+        return this.sendToBridge({
+            command: "validate",
+            files,
+            operation,
+        });
+    }
+    /**
+     * Run xray_codex_check — check code against codex rules
+    */
+    async codexCheck(code, focusAreas) {
+        // If no code provided, fall back to health check
+        if (!code) {
+            const health = await this.checkBridgeHealth();
+            return {
+                passed: health.status === "ok",
+                violations: [],
+                checks: [],
+                focusAreas: focusAreas?.join(",") || "all",
+            };
+        }
+        return this.sendToBridge({
+            command: "codex-check",
+            code,
+            focusAreas,
+        });
+    }
+    /**
+     * Run xray_health — framework health check
+    */
+    async health() {
+        return this.checkBridgeHealth();
+    }
+    // ==========================================================================
+    // Utility Methods
+    // ==========================================================================
+    /**
+     * Check if a tool name belongs to a 0xRay MCP server
+     */
+    isStrrayMcp(tool) {
+        return tool.startsWith("mcp_xray_");
+    }
+    /**
+     * Get a nudge message for a native tool
+     */
+    getToolNudge(tool) {
+        if (tool === "terminal") {
+            return 'Tip: Consider using "execute_code" for multi-step code operations with 0xRay enforcement.';
+        }
+        if (tool === "search_files") {
+            return 'Tip: Consider using "execute_code" with hermes_tools for complex search operations.';
+        }
+        return undefined;
+    }
+    /**
+     * Create empty statistics object
+     */
+    createEmptyStats() {
+        return {
+            totalToolCalls: 0,
+            codeOperations: 0,
+            qualityGateRuns: 0,
+            qualityGateBlocks: 0,
+            preProcessorRuns: 0,
+            postProcessorRuns: 0,
+            xrayMcpCalls: 0,
+            nativeToolCalls: 0,
+            bridgeErrors: 0,
+            sessionId: generateJobId("hermes-agent"),
+            startedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Get current Hermes Agent statistics
+     */
+    getHermesStats() {
+        return { ...this.hermesStats };
+    }
+    /**
+     * Reset statistics (e.g., new session)
+     */
+    resetStats() {
+        this.hermesStats = this.createEmptyStats();
+    }
+    /**
+     * Get the bridge path
+     */
+    getBridgePath() {
+        return this.bridgePath;
+    }
+    /**
+     * Get the plugin directory path
+     */
+    getPluginDir() {
+        return this.pluginDir;
+    }
+    /**
+     * Get the project root
+     */
+    getProjectRoot() {
+        return this.projectRoot;
+    }
+    /**
+     * Check if hooks are enabled
+     */
+    isHooksEnabled() {
+        return this.hooksEnabled;
+    }
+    /**
+     * Enable or disable hooks
+     */
+    setHooksEnabled(enabled) {
+        this.hooksEnabled = enabled;
+        this.emitEvent("config-updated", { hooksEnabled: enabled });
+    }
+    /**
+     * Get the bridge stats response
+     */
+    async getBridgeStats() {
+        return this.sendToBridge({
+            command: "stats",
+        });
+    }
+}
+// ============================================================================
+// Singleton
+// ============================================================================
+let globalInstance = null;
+/**
+ * Get or create the global Hermes Agent integration instance
+ */
+export function getHermesAgentIntegration(config) {
+    if (!globalInstance) {
+        globalInstance = new HermesAgentIntegration(config);
+    }
+    return globalInstance;
+}
+/**
+ * Initialize the global Hermes Agent integration
+ */
+export async function initializeHermesAgentIntegration(config) {
+    const integration = getHermesAgentIntegration(config);
+    if (integration.status === "uninitialized") {
+        await integration.initialize();
+    }
+    return integration;
+}
+/**
+ * Shutdown the global Hermes Agent integration
+ */
+export async function shutdownHermesAgentIntegration() {
+    if (globalInstance) {
+        await globalInstance.shutdown();
+        globalInstance = null;
+    }
+}
+//# sourceMappingURL=hermes-agent-integration.js.map

package/dist/integrations/hermes-agent/hermes-agent-integration.js.map

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

package/dist/integrations/hermes-agent/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Hermes Agent Integration - Main Module
+ *
+ * Exports the TypeScript integration class that bridges 0xRay
+ * framework components to the Hermes CLI agent via bridge.mjs.
+ *
+ * @version 2.0.0
+ * @since 2026-03-27
+ */
+export { HermesAgentIntegration, getHermesAgentIntegration, initializeHermesAgentIntegration, shutdownHermesAgentIntegration, } from "./hermes-agent-integration.js";
+export type { HermesAgentConfig, HermesAgentStatistics, BridgeCommand, BridgeRequest, BridgeResponse, BridgeHealthResponse, BridgePreProcessResponse, BridgePostProcessResponse, BridgeValidateResponse, BridgeCodexCheckResponse, BridgeStatsResponse, PreToolCallEvent, PostToolCallEvent, QualityGateBlockEvent, } from "./types.js";

package/dist/integrations/hermes-agent/index.js

@@ -0,0 +1,12 @@
+/**
+ * Hermes Agent Integration - Main Module
+ *
+ * Exports the TypeScript integration class that bridges 0xRay
+ * framework components to the Hermes CLI agent via bridge.mjs.
+ *
+ * @version 2.0.0
+ * @since 2026-03-27
+ */
+// Integration class
+export { HermesAgentIntegration, getHermesAgentIntegration, initializeHermesAgentIntegration, shutdownHermesAgentIntegration, } from "./hermes-agent-integration.js";
+//# sourceMappingURL=index.js.map

package/dist/integrations/hermes-agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/hermes-agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oBAAoB;AACpB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,gCAAgC,EAChC,8BAA8B,GAC/B,MAAM,+BAA+B,CAAC"}