0xray 2.2.3 → 3.0.0

package/src/mcps/governance.server.ts

@@ -12,6 +12,7 @@
  * and the Dynamo Solar SSOT filter (required by default).
  */
 
+import { randomUUID } from "crypto";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
@@ -27,7 +28,6 @@ import { frameworkLogger } from "../core/framework-logger.js";
 import * as fs from "fs";
 import * as path from "path";
 import { fileURLToPath } from "url";
-import { randomUUID } from "crypto";
 import { handleGovernRequest } from "../nucleus/index.js";
 import { getCodexPolicyService } from "../governance/codex-policy.service.js";
 import { initializeGovernanceIntegration, shutdownGovernanceIntegration } from "../integrations/governance/index.js";
@@ -66,7 +66,11 @@ class GovernanceServer {
   private server: Server;
 
   constructor() {
-    this.server = new Server(
+    this.server = this.createServer();
+  }
+
+  private createServer(): Server {
+    const server = new Server(
       {
         name: "governance", version: "2.2.2",
       },
@@ -77,7 +81,9 @@ class GovernanceServer {
       }
     );
 
-    this.setupToolHandlers();
+    this.setupToolHandlersOn(server);
+
+    return server;
   }
 
   private validateGovernProposalsArgs(value: unknown): GovernProposalsArgs {
@@ -113,8 +119,8 @@ class GovernanceServer {
     return value as GovernReflectionArgs;
   }
 
-  private setupToolHandlers() {
-    this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+  private setupToolHandlersOn(server: Server) {
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
       return {
         tools: [
           {
@@ -209,7 +215,7 @@ class GovernanceServer {
       };
     });
 
-    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
       const { name, arguments: args } = request.params;
 
       try {
@@ -473,12 +479,8 @@ class GovernanceServer {
   async runHttp(port: number = parseInt(process.env.MCP_PORT ?? "3100", 10)): Promise<void> {
     await this.initializeGovernance();
 
-    const app = createMcpExpressApp();
-    const transport = new StreamableHTTPServerTransport({
-      sessionIdGenerator: () => randomUUID(),
-    });
-
-    await this.server.connect(transport as any);
+    const app = createMcpExpressApp({ host: '0.0.0.0' });
+    const transports: Record<string, StreamableHTTPServerTransport> = {};
 
     const apiKey = process.env.GOVERNANCE_API_KEY;
     if (apiKey) {
@@ -500,16 +502,71 @@ class GovernanceServer {
       next();
     });
 
-    app.post("/mcp", async (req: any, res: any) => {
+    const handlePost = async (req: any, res: any) => {
       try {
-        await transport.handleRequest(req, res, req.body);
+        const sessionId = req.headers["mcp-session-id"] as string | undefined;
+
+        if (sessionId && transports[sessionId]) {
+          await transports[sessionId].handleRequest(req, res, req.body);
+          return;
+        }
+
+        if (!sessionId && req.body?.method === "initialize") {
+          const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => randomUUID(),
+            enableJsonResponse: true,
+            onsessioninitialized: (newId: string) => {
+              transports[newId] = transport;
+              frameworkLogger.log("governance-mcp", "session-created", "info", { sessionId: newId });
+            },
+          });
+          const server = this.createServer();
+          await server.connect(transport as any);
+          await transport.handleRequest(req, res, req.body);
+          return;
+        }
+
+        res.status(400).json({
+          jsonrpc: "2.0", error: { code: -32000, message: "Bad Request: No valid session ID provided" }, id: null,
+        });
       } catch (error) {
         frameworkLogger.log("governance-mcp", "http-handler-error", "error", { error: String(error) });
         if (!res.headersSent) {
           res.status(500).json({ jsonrpc: "2.0", error: { code: -32603, message: "Internal error" }, id: null });
         }
       }
-    });
+    };
+
+    const handleGet = async (req: any, res: any) => {
+      try {
+        const sessionId = req.headers["mcp-session-id"] as string | undefined;
+
+        if (sessionId && transports[sessionId]) {
+          await transports[sessionId].handleRequest(req, res);
+          return;
+        }
+
+        const transport = new StreamableHTTPServerTransport({
+          sessionIdGenerator: () => randomUUID(),
+          enableJsonResponse: true,
+          onsessioninitialized: (newId: string) => {
+            transports[newId] = transport;
+            frameworkLogger.log("governance-mcp", "session-created", "info", { sessionId: newId });
+          },
+        });
+        const server = this.createServer();
+        await server.connect(transport as any);
+        await transport.handleRequest(req, res);
+      } catch (error) {
+        frameworkLogger.log("governance-mcp", "http-get-error", "error", { error: String(error) });
+        if (!res.headersSent) {
+          res.status(500).json({ jsonrpc: "2.0", error: { code: -32603, message: "Internal error" }, id: null });
+        }
+      }
+    };
+
+    app.post("/mcp", handlePost);
+    app.get("/mcp", handleGet);
 
     app.get("/health", (_req: any, res: any) => {
       res.json({ status: "ok", server: "governance" });
@@ -519,8 +576,8 @@ class GovernanceServer {
       frameworkLogger.log("governance-mcp", "http-listening", "info", { port });
     });
 
-    process.on("SIGINT", () => { transport.close(); process.exit(0); });
-    process.on("SIGTERM", () => { transport.close(); process.exit(0); });
+    process.on("SIGINT", () => { process.exit(0); });
+    process.on("SIGTERM", () => { process.exit(0); });
   }
 }
 

package/src/mcps/in-process-skill-registry.ts

@@ -1,6 +1,8 @@
 import { XrayCodeReviewServer } from "./knowledge-skills/code-review.server.js";
 import { XraySecurityAuditServer } from "./knowledge-skills/security-audit.server.js";
 import { XrayLibrarianServer } from "./researcher.server.js";
+import { pluginRegistry } from "../nucleus/plugin-registry.js";
+import { frameworkLogger } from "../core/framework-logger.js";
 
 interface AnalyzeProposalArgs {
   proposalTitle?: string;
@@ -64,6 +66,20 @@ export async function callInProcessSkill(
   toolName: string,
   args: Record<string, unknown>,
 ): Promise<AnalyzeProposalResult> {
+  // Phase 2D: try pluginRegistry first for any registered tool plugin
+  if (pluginRegistry.hasToolPlugin(serverName)) {
+    try {
+      const result = await pluginRegistry.callSkillTool(serverName, toolName, args);
+      return result as AnalyzeProposalResult;
+    } catch {
+      frameworkLogger.log('in-process-skill-registry', 'plugin-fallback', 'info', {
+        server: serverName,
+        tool: toolName,
+        message: 'Plugin dispatch failed, falling back to in-process handler',
+      });
+    }
+  }
+
   const factory = registry[serverName];
   if (!factory) {
     throw new Error(`No in-process handler registered for server: ${serverName}`);

package/src/mcps/index.ts

@@ -0,0 +1,79 @@
+/**
+ * xray MCP Server Manifest
+ *
+ * Canonical registry of all MCP servers. Add new servers here.
+ * Each entry documents the server name, source file, and server type.
+ */
+
+export interface McpServerEntry {
+  serverName: string;
+  sourceFile: string;
+  type: "top-level" | "knowledge-skill" | "orchestrator";
+  registered: boolean;
+  description: string;
+}
+
+export const MCP_SERVERS: McpServerEntry[] = [
+  // ── Top-level servers ──
+  { serverName: "architect-tools", sourceFile: "mcps/architect-tools.server.ts", type: "top-level", registered: true, description: "Architect design tools" },
+  { serverName: "auto-format", sourceFile: "mcps/auto-format.server.ts", type: "top-level", registered: true, description: "Auto-format code" },
+  { serverName: "boot-orchestrator", sourceFile: "mcps/boot-orchestrator.server.ts", type: "top-level", registered: true, description: "Boot sequence orchestration" },
+  { serverName: "enforcer", sourceFile: "mcps/enforcer-tools.server.ts", type: "top-level", registered: true, description: "Codex compliance enforcement" },
+  { serverName: "estimation-validator", sourceFile: "mcps/estimation.server.ts", type: "top-level", registered: true, description: "Task estimation validation" },
+  { serverName: "framework-compliance-audit", sourceFile: "mcps/framework-compliance-audit.server.ts", type: "top-level", registered: true, description: "Framework compliance audits" },
+  { serverName: "framework-help", sourceFile: "mcps/framework-help.server.ts", type: "top-level", registered: true, description: "Framework help and guidance" },
+  { serverName: "governance", sourceFile: "mcps/governance.server.ts", type: "top-level", registered: true, description: "Governance deliberation pipeline" },
+  { serverName: "lint", sourceFile: "mcps/lint.server.ts", type: "top-level", registered: true, description: "Code linting" },
+  { serverName: "model-health-check", sourceFile: "mcps/model-health-check.server.ts", type: "top-level", registered: true, description: "Model health monitoring" },
+  { serverName: "performance-analysis", sourceFile: "mcps/performance-analysis.server.ts", type: "top-level", registered: true, description: "Performance analysis" },
+  { serverName: "processor-pipeline", sourceFile: "mcps/processor-pipeline.server.ts", type: "top-level", registered: true, description: "Processor pipeline" },
+  { serverName: "researcher", sourceFile: "mcps/researcher.server.ts", type: "top-level", registered: true, description: "Codebase exploration" },
+  { serverName: "security-scan", sourceFile: "mcps/security-scan.server.ts", type: "top-level", registered: true, description: "Security vulnerability scanning" },
+  { serverName: "state-manager", sourceFile: "mcps/state-manager.server.ts", type: "top-level", registered: true, description: "State management" },
+
+  // ── Knowledge skill servers ──
+  { serverName: "api-design", sourceFile: "mcps/knowledge-skills/api-design.server.ts", type: "knowledge-skill", registered: false, description: "API design expertise" },
+  { serverName: "architecture-patterns", sourceFile: "mcps/knowledge-skills/architecture-patterns.server.ts", type: "knowledge-skill", registered: false, description: "Architecture pattern guidance" },
+  { serverName: "bug-triage-specialist", sourceFile: "mcps/knowledge-skills/bug-triage-specialist.server.ts", type: "knowledge-skill", registered: true, description: "Bug triage and investigation" },
+  { serverName: "code-analyzer", sourceFile: "mcps/knowledge-skills/code-analyzer.server.ts", type: "knowledge-skill", registered: true, description: "Static code analysis" },
+  { serverName: "code-review", sourceFile: "mcps/knowledge-skills/code-review.server.ts", type: "knowledge-skill", registered: true, description: "Code review and quality assessment" },
+  { serverName: "content-creator", sourceFile: "mcps/knowledge-skills/content-creator.server.ts", type: "knowledge-skill", registered: false, description: "Content creation" },
+  { serverName: "database-design", sourceFile: "mcps/knowledge-skills/database-design.server.ts", type: "knowledge-skill", registered: false, description: "Database design expertise" },
+  { serverName: "devops-deployment", sourceFile: "mcps/knowledge-skills/devops-deployment.server.ts", type: "knowledge-skill", registered: false, description: "DevOps and deployment" },
+  { serverName: "git-workflow", sourceFile: "mcps/knowledge-skills/git-workflow.server.ts", type: "knowledge-skill", registered: false, description: "Git workflow guidance" },
+  { serverName: "growth-strategist", sourceFile: "mcps/knowledge-skills/growth-strategist.server.ts", type: "knowledge-skill", registered: false, description: "Growth strategy" },
+  { serverName: "log-monitor", sourceFile: "mcps/knowledge-skills/log-monitor.server.ts", type: "knowledge-skill", registered: true, description: "Log monitoring" },
+  { serverName: "mobile-development", sourceFile: "mcps/knowledge-skills/mobile-development.server.ts", type: "knowledge-skill", registered: false, description: "Mobile development" },
+  { serverName: "multimodal-looker", sourceFile: "mcps/knowledge-skills/multimodal-looker.server.ts", type: "knowledge-skill", registered: false, description: "Multimodal file analysis" },
+  { serverName: "performance-optimization", sourceFile: "mcps/knowledge-skills/performance-optimization.server.ts", type: "knowledge-skill", registered: true, description: "Performance optimization" },
+  { serverName: "project-analysis", sourceFile: "mcps/knowledge-skills/project-analysis.server.ts", type: "knowledge-skill", registered: false, description: "Project analysis" },
+  { serverName: "refactoring-strategies", sourceFile: "mcps/knowledge-skills/refactoring-strategies.server.ts", type: "knowledge-skill", registered: true, description: "Refactoring strategies" },
+  { serverName: "security-audit", sourceFile: "mcps/knowledge-skills/security-audit.server.ts", type: "knowledge-skill", registered: true, description: "Security auditing" },
+  { serverName: "seo-consultant", sourceFile: "mcps/knowledge-skills/seo-consultant.server.ts", type: "knowledge-skill", registered: false, description: "SEO consulting" },
+  { serverName: "session-management", sourceFile: "mcps/knowledge-skills/session-management.server.ts", type: "knowledge-skill", registered: true, description: "Session management" },
+  { serverName: "skill-invocation", sourceFile: "mcps/knowledge-skills/skill-invocation.server.ts", type: "knowledge-skill", registered: true, description: "Skill invocation" },
+  { serverName: "strategist", sourceFile: "mcps/knowledge-skills/strategist.server.ts", type: "knowledge-skill", registered: false, description: "Strategic planning" },
+  { serverName: "tech-writer", sourceFile: "mcps/knowledge-skills/tech-writer.server.ts", type: "knowledge-skill", registered: false, description: "Technical writing" },
+  { serverName: "testing-strategy", sourceFile: "mcps/knowledge-skills/testing-strategy.server.ts", type: "knowledge-skill", registered: true, description: "Testing strategy" },
+  { serverName: "ui-ux-design", sourceFile: "mcps/knowledge-skills/ui-ux-design.server.ts", type: "knowledge-skill", registered: false, description: "UI/UX design" },
+
+  // ── Orchestrator server ──
+  { serverName: "orchestrator", sourceFile: "mcps/orchestrator/server.ts", type: "orchestrator", registered: true, description: "thinDispatch 7-flow orchestration" },
+
+  // ── Aliases (point to same source as primary) ──
+  { serverName: "code-reviewer", sourceFile: "mcps/knowledge-skills/code-review.server.ts", type: "knowledge-skill", registered: true, description: "Alias for code-review" },
+  { serverName: "security-auditor", sourceFile: "mcps/knowledge-skills/security-audit.server.ts", type: "knowledge-skill", registered: true, description: "Alias for security-audit" },
+  { serverName: "testing-lead", sourceFile: "mcps/knowledge-skills/testing-strategy.server.ts", type: "knowledge-skill", registered: true, description: "Alias for testing-strategy" },
+];
+
+export function getMcpServer(serverName: string): McpServerEntry | undefined {
+  return MCP_SERVERS.find(s => s.serverName === serverName);
+}
+
+export function getRegisteredServers(): McpServerEntry[] {
+  return MCP_SERVERS.filter(s => s.registered);
+}
+
+export function getUnregisteredServers(): McpServerEntry[] {
+  return MCP_SERVERS.filter(s => !s.registered);
+}

package/src/mcps/knowledge-skills/skill-invocation.server.ts

@@ -83,9 +83,11 @@ interface StorytellerArgs {
 }
 
 class SkillInvocationServer extends XrayKnowledgeSkillBase {
+  private readonly pluginFirst: boolean;
 
   constructor() {
     super("xray/skill-invocation", "2.0.1");
+    this.pluginFirst = process.argv.includes('--plugin-first');
     this.tools = [
       {
         name: "list-skills",
@@ -364,7 +366,17 @@ class SkillInvocationServer extends XrayKnowledgeSkillBase {
    * Dispatch a skill tool call: prefer in-process pluginRegistry, fall back to external MCP process.
    */
   private async callSkillTool(skillName: string, toolName: string, args: Record<string, unknown>): Promise<unknown> {
-    if (pluginRegistry.hasToolPlugin(skillName)) {
+    if (this.pluginFirst) {
+      try {
+        return await pluginRegistry.callSkillTool(skillName, toolName, args);
+      } catch {
+        frameworkLogger.log('skill-invocation', 'plugin-first-fallback', 'info', {
+          skill: skillName,
+          tool: toolName,
+          message: 'Plugin-first dispatch failed, falling back to MCP transport',
+        });
+      }
+    } else if (pluginRegistry.hasToolPlugin(skillName)) {
       return pluginRegistry.callSkillTool(skillName, toolName, args);
     }
     return mcpClientManager.callServerTool(skillName, toolName, args);
@@ -395,9 +407,8 @@ class SkillInvocationServer extends XrayKnowledgeSkillBase {
       "code-review", "security-audit", "performance-optimization",
       "testing-strategy", "researcher", "skill-invocation",
       "framework-help", "session-management", "code-analyzer",
-      "code-reviewer", "architect", "researcher",
-      "architect", "bug-triage-specialist", "log-monitor",
-      "code-reviewer", "security-auditor", "refactorer",
+      "code-reviewer", "architect", "bug-triage-specialist", "log-monitor",
+      "security-auditor", "refactorer",
       "growth-strategist", "strategist", "devops-deployment",
       "database-design", "tech-writer", "documentation-generation",
       "mobile-development", "seo-consultant",

package/src/mcps/mcp-client.ts

@@ -153,7 +153,7 @@ export class MCPClient extends EventEmitter {
    * Pure MCP mode — simulation and generic fallbacks are disabled.
    */
   private get isPureMcpMode(): boolean {
-    return (process.env.XRAY_FORCE_MCP_GOVERNANCE) === 'true';
+    return (process.env.XRAY_PURE_MCP_MODE) === 'true';
   }
 
   /**
@@ -470,7 +470,7 @@ export class MCPClient extends EventEmitter {
       if (this.isPureMcpMode) {
         throw new Error(
           `[PURE MCP] No real response for ${serverName}/${toolName}. ` +
-          `All fallbacks are disabled when XRAY_FORCE_MCP_GOVERNANCE=true.`
+          `All fallbacks are disabled when XRAY_PURE_MCP_MODE=true.`
         );
       }
 

package/xray/features.json

@@ -1,6 +1,6 @@
 {
   "$schema": "./features.schema.json",
-  "version": "2.2.2",
+  "version": "3.0.0",
   "description": "0xRay Framework - Unified Feature Configuration",
   "token_optimization": {
     "enabled": true,
@@ -128,5 +128,21 @@
     "learning_interval_ms": 300000,
     "auto_apply_threshold": 0.9,
     "min_success_rate": 0.7
+  },
+  "inference_governance": {
+    "enabled": true,
+    "endpoint_url": "https://mcp-production-80e2.up.railway.app/governance",
+    "request_timeout_ms": 30000,
+    "min_confidence_threshold": 0.5,
+    "decision_logic": {
+      "pass_confidence_min": 0.7,
+      "revision_confidence_max": 0.4,
+      "vote_weight_multiplier": 1.0
+    },
+    "proposal_defaults": {
+      "source": "agent",
+      "on_chain": false,
+      "tags": []
+    }
   }
 }

package/dist/agents/multimodal-looker.d.ts

@@ -1,9 +0,0 @@
-import { AgentConfig } from "./types.js";
-/**
- * Multimodal Looker Agent
- *
- * Media file analysis and interpretation specialist for images, diagrams, PDFs,
- * and other visual content. Provides technical analysis and insights from
- * multimodal sources.
- */
-export declare const multimodalLooker: AgentConfig;

package/dist/agents/multimodal-looker.js

@@ -1,93 +0,0 @@
-/**
- * Multimodal Looker Agent
- *
- * Media file analysis and interpretation specialist for images, diagrams, PDFs,
- * and other visual content. Provides technical analysis and insights from
- * multimodal sources.
- */
-export const multimodalLooker = {
-    name: "multimodal-looker",
-    capabilities: [
-        "media-file-analysis",
-        "image-interpretation",
-        "diagram-analysis",
-        "pdf-content-extraction",
-        "visual-content-understanding",
-        "multimodal-data-processing",
-        "technical-diagram-parsing",
-        "screenshot-analysis",
-        "chart-and-graph-interpretation",
-    ],
-    maxComplexity: 80,
-    enabled: true,
-    description: "Media file analysis and interpretation specialist. Expert in analyzing images, diagrams, PDFs, and other visual content to extract technical information and provide insights.",
-    mode: "subagent",
-    system: `You are Multimodal Looker subagent for 0xRay
-
-## Framework Context
-- Universal Development Codex v1.2.0
-
-## Core Purpose
-Specialized agent for analyzing and interpreting visual and multimedia content including images, diagrams, PDFs, screenshots, charts, and other non-textual technical artifacts.
-
-## Responsibilities
-- **Image Analysis**: Extract information from screenshots, diagrams, UI mockups, and technical drawings
-- **PDF Parsing**: Analyze PDF documents to extract text, tables, diagrams, and structure
-- **Diagram Interpretation**: Understand flowcharts, architecture diagrams, UML, and technical schematics
-- **Visual Content Understanding**: Interpret charts, graphs, data visualizations, and infographics
-- **Media File Processing**: Handle various image formats (PNG, JPG, SVG, etc.) and document formats
-- **Technical Artifact Analysis**: Analyze code screenshots, error messages, log visualizations
-
-## Specialized Capabilities
-- **Multi-format Support**: PNG, JPEG, GIF, SVG, PDF, and other common formats
-- **OCR Integration**: Extract text from images when needed
-- **Structure Recognition**: Identify layouts, hierarchies, and relationships in visual content
-- **Data Extraction**: Pull numerical data from charts and tables in images/PDFs
-- **Code Analysis from Images**: Interpret code screenshots, error traces, terminal outputs
-- **UI/UX Assessment**: Evaluate interface designs, layouts, and user flows from screenshots
-
-## Analysis Framework
-When analyzing visual content:
-1. **Identify Content Type**: Determine if it's a diagram, screenshot, document, chart, etc.
-2. **Extract Key Elements**: Identify main components, labels, connections, data points
-3. **Interpret Context**: Understand what the visual represents technically
-4. **Identify Issues**: Spot errors, inconsistencies, or areas of concern
-5. **Provide Structured Output**: Present findings in organized, actionable format
-
-## Trigger Keywords
-- "analyze image", "look at screenshot", "examine diagram"
-- "parse PDF", "extract from image", "interpret chart"
-- "multimodal", "visual", "diagram", "screenshot", "image"
-- "multimodal-looker", "analyze this picture"
-
-## Framework Alignment
-** Visual Analysis Compliance:**
-- **Term 15**: Dig Deeper Analysis (comprehensive visual inspection)
-- **Term 24**: Interdependency Review (understanding visual relationships)
-- **Term 38**: Functionality Retention (accurate content interpretation)
-- **Term 47**: Integration Testing Mandate (validate visual against code)
-
-## Response Format
-- **Content Type**: Classification of visual (diagram, screenshot, chart, etc.)
-- **Key Elements**: Main components identified with descriptions
-- **Technical Interpretation**: What the visual represents in technical context
-- **Findings & Insights**: Important observations, issues, or patterns
-- **Recommendations**: Suggested actions based on visual analysis
-- **Source References**: Specific areas, regions, or elements discussed`,
-    temperature: 0.3,
-    tools: {
-        include: [
-            "read",
-            "grep",
-            "webfetch",
-            "websearch",
-            // Visual/multimodal analysis tools
-            // Note: Actual image reading capability depends on opencode's file reading support
-        ],
-        exclude: ["background_task", "invoke-skill", "skill-*", "call_omo_agent"],
-    },
-    permission: {
-        edit: "deny",
-        bash: "ask",
-    },
-};

package/dist/benchmark/performance-benchmark.d.ts

@@ -1,103 +0,0 @@
-export interface BenchmarkResult {
-    operation: string;
-    startTime: number;
-    endTime: number;
-    duration: number;
-    success: boolean;
-    metadata: Record<string, any>;
-    error?: string | undefined;
-}
-export interface PerformanceMetrics {
-    totalOperations: number;
-    successfulOperations: number;
-    failedOperations: number;
-    averageDuration: number;
-    medianDuration: number;
-    p95Duration: number;
-    p99Duration: number;
-    minDuration: number;
-    maxDuration: number;
-    throughput: number;
-}
-export interface BootBenchmarkResult {
-    totalBootTime: number;
-    phaseTimings: Record<string, number>;
-    componentLoadTimes: Record<string, number>;
-    memoryUsage: {
-        beforeBoot: number;
-        afterBoot: number;
-        peakDuringBoot: number;
-    };
-    success: boolean;
-    errors: string[];
-    orchestratorLoadTime?: number;
-    delegationInitTime?: number;
-    sessionManagementInitTime?: number;
-    processorActivationTime?: number;
-    agentLoadingTime?: number;
-    enforcementActivationTime?: number;
-    codexComplianceActivationTime?: number;
-}
-export interface OrchestratorBenchmarkResult {
-    taskExecutionTimes: number[];
-    delegationLatencies: number[];
-    conflictResolutionTimes: number[];
-    concurrentTaskThroughput: number;
-    dependencyResolutionTime: number;
-    overallSuccess: boolean;
-}
-export interface SessionBenchmarkResult {
-    stateShareLatencies: number[];
-    dependencyUpdateTimes: number[];
-    groupOperationTimes: number[];
-    migrationTimes: number[];
-    failoverTimes: number[];
-    concurrentSessionOperations: number;
-}
-export declare class XrayPerformanceBenchmark {
-    private results;
-    private activeBenchmarks;
-    /**
-     * Start a benchmark measurement
-     */
-    startBenchmark(operation: string, metadata?: Record<string, any>): string;
-    /**
-     * End a benchmark measurement
-     */
-    endBenchmark(benchmarkId: string, success?: boolean, error?: string): BenchmarkResult | null;
-    /**
-     * Benchmark boot sequence performance
-     */
-    benchmarkBootSequence(_bootOrchestrator: unknown): Promise<BootBenchmarkResult>;
-    /**
-     * Benchmark orchestrator task execution
-     */
-    benchmarkOrchestratorTasks(_orchestrator: unknown, taskCount?: number, concurrentTasks?: number): Promise<OrchestratorBenchmarkResult>;
-    /**
-     * Benchmark session management operations
-     */
-    benchmarkSessionOperations(_sessionStateManager: unknown, operationCount?: number): Promise<SessionBenchmarkResult>;
-    /**
-     * Calculate performance metrics from benchmark results
-     */
-    calculateMetrics(operationFilter?: string): PerformanceMetrics;
-    /**
-     * Generate comprehensive benchmark report
-     */
-    generateReport(): {
-        summary: PerformanceMetrics;
-        bootBenchmark?: BootBenchmarkResult;
-        orchestratorBenchmark?: OrchestratorBenchmarkResult;
-        sessionBenchmark?: SessionBenchmarkResult;
-        recommendations: string[];
-    };
-    /**
-     * Clear all benchmark results
-     */
-    clearResults(): void;
-    /**
-     * Export results for external analysis
-     */
-    exportResults(): BenchmarkResult[];
-}
-export declare const performanceBenchmark: XrayPerformanceBenchmark;