0xray 2.0.0 → 2.1.0

package/dist/session/session-state-manager.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Session State Manager
+ *
+ * Manages cross-session state sharing, dependency tracking,
+ * and coordination for complex workflows.
+ *
+ * @version 1.0.0
+ * @since 2026-01-07
+ */
+import { XrayStateManager } from "../state/state-manager.js";
+import { SessionCoordinator } from "../delegation/session-coordinator.js";
+export interface SessionDependency {
+    sessionId: string;
+    dependsOn: string[];
+    dependedBy: string[];
+    state: "pending" | "active" | "completed" | "failed";
+    priority: number;
+    metadata: Record<string, unknown>;
+}
+export interface SessionGroup {
+    groupId: string;
+    sessionIds: string[];
+    coordinatorSession: string;
+    state: "forming" | "active" | "completing" | "completed" | "failed";
+    sharedState: Map<string, {
+        value: unknown;
+        fromSessionId: string;
+        timestamp: number;
+    }>;
+    createdAt: number;
+    completedAt?: number;
+}
+export interface MigrationPlan {
+    sessionId: string;
+    targetCoordinator: string;
+    stateTransfer: Map<string, unknown>;
+    migrationSteps: string[];
+    rollbackSteps: string[];
+}
+export interface FailoverConfig {
+    sessionId: string;
+    backupCoordinators: string[];
+    failoverThreshold: number;
+    autoFailover: boolean;
+}
+export declare class SessionStateManager {
+    private stateManager;
+    private sessionCoordinator;
+    private dependencies;
+    private sessionGroups;
+    private failoverConfigs;
+    constructor(stateManager: XrayStateManager, sessionCoordinator: SessionCoordinator);
+    /**
+     * Share state between sessions
+     */
+    shareState(fromSessionId: string, toSessionId: string, key: string, value: unknown): boolean;
+    /**
+     * Broadcast state to multiple sessions
+     */
+    broadcastState(fromSessionId: string, targetSessionIds: string[], key: string, value: unknown): number;
+    /**
+     * Register session dependency
+     */
+    registerDependency(sessionId: string, dependsOn: string[], metadata?: Record<string, unknown>): void;
+    /**
+     * Update dependency state
+     */
+    updateDependencyState(sessionId: string, state: SessionDependency["state"]): void;
+    /**
+     * Get dependency chain for a session
+     */
+    getDependencyChain(sessionId: string): {
+        dependencies: string[];
+        dependents: string[];
+        canStart: boolean;
+    };
+    /**
+     * Create session group for complex workflows
+     */
+    createSessionGroup(groupId: string, sessionIds: string[], coordinatorSession: string): SessionGroup;
+    /**
+     * Update session group state
+     */
+    updateSessionGroupState(groupId: string, state: SessionGroup["state"]): void;
+    /**
+     * Share state within a session group
+     */
+    shareGroupState(groupId: string, key: string, value: unknown, fromSessionId: string): boolean;
+    /**
+     * Get session group state
+     */
+    getGroupState(groupId: string, key: string): unknown;
+    /**
+     * Plan session migration
+     */
+    planMigration(sessionId: string, targetCoordinator: string): MigrationPlan;
+    /**
+     * Validate migration plan before execution
+     */
+    validateMigrationPlan(plan: MigrationPlan): Promise<{
+        valid: boolean;
+        errors: string[];
+        warnings: string[];
+    }>;
+    /**
+     * Validate rollback capability for a migration plan
+     */
+    validateRollbackCapability(plan: MigrationPlan): {
+        canRollback: boolean;
+        reason?: string;
+    };
+    /**
+     * Find orphaned agents in dependency graph
+     */
+    findOrphanedAgents(allAgents: string[], dependencies: Record<string, string[]>): string[];
+    /**
+     * Execute session migration
+     */
+    executeMigration(plan: MigrationPlan): Promise<boolean>;
+    /**
+     * Configure failover for a session
+     */
+    configureFailover(sessionId: string, backupCoordinators: string[], failoverThreshold: number, autoFailover: boolean): void;
+    /**
+     * Execute failover for a session
+     */
+    executeFailover(sessionId: string): Promise<boolean>;
+    /**
+     * Get coordination statistics
+     */
+    getCoordinationStats(): {
+        totalDependencies: number;
+        activeDependencies: number;
+        totalGroups: number;
+        activeGroups: number;
+        failoverConfigs: number;
+    };
+    private propagateDependencyUpdate;
+    private rollbackMigration;
+    private persistDependencies;
+    private persistSessionGroups;
+    private persistFailoverConfigs;
+    shutdown(): void;
+}
+export declare const createSessionStateManager: (stateManager: XrayStateManager, sessionCoordinator: SessionCoordinator) => SessionStateManager;

package/dist/skills/hermes-agent/SKILL.md

@@ -1,21 +1,21 @@
 ---
 name: hermes-agent
-description: Manage StringRay framework from Hermes Agent via the native strray-hermes plugin. Covers the 4 plugin tools (validate, codex_check, health, hooks), lifecycle hooks, slash commands, bridge architecture, and CLI fallback.
+description: Manage 0xRay framework from Hermes Agent via the native strray-hermes plugin. Covers the 4 plugin tools (validate, codex_check, health, hooks), lifecycle hooks, slash commands, bridge architecture, and CLI fallback.
 version: 2.1.0
-author: StringRay AI
+author: 0xRay AI
 metadata:
   hermes:
-    tags: [StringRay, Plugin, Validation, Codex, GitHooks, Bridge]
+    tags: [0xRay, Plugin, Validation, Codex, GitHooks, Bridge]
     related_skills: []
 ---
 
-# StringRay Hermes Plugin (strray-hermes)
+# 0xRay Hermes Plugin (strray-hermes)
 
-Native Hermes plugin providing StringRay framework integration — quality gates, codex enforcement, git hooks, and full pre/post processing pipeline. Runs via a Node.js bridge to compiled framework components.
+Native Hermes plugin providing 0xRay framework integration — quality gates, codex enforcement, git hooks, and full pre/post processing pipeline. Runs via a Node.js bridge to compiled framework components.
 
 ## When to Use
 
-- User asks about StringRay health, validation, or codex checks
+- User asks about 0xRay health, validation, or codex checks
 - User wants to install/manage git hooks for automated enforcement
 - User asks about the plugin's tools, hooks, or slash commands
 - User asks about bridge errors or framework not loading
@@ -28,7 +28,7 @@ Native Hermes plugin providing StringRay framework integration — quality gates
 ├── __init__.py         # Plugin registration, hooks, slash commands
 ├── tools.py            # 4 tool handlers (validate, codex_check, health, hooks)
 ├── schemas.py          # JSON schemas the LLM sees
-├── bridge.mjs          # Node.js bridge to compiled StringRay framework
+├── bridge.mjs          # Node.js bridge to compiled 0xRay framework
 ├── plugin.yaml         # Plugin metadata (name, version, tools, hooks)
 ├── types.py            # TypeScript-equivalent type definitions
 ├── after-install.md    # Post-install instructions
@@ -43,7 +43,7 @@ Native Hermes plugin providing StringRay framework integration — quality gates
 
 **Fallback:** When bridge is unavailable, tools fall back to `npx 0xray` CLI commands.
 
-**Config path resolution:** `STRRAY_CONFIG_DIR/` > `.strray/` > `.opencode/strray/` > built-in defaults.
+**Config path resolution:** `STRRAY_CONFIG_DIR/` > `.xray/` > `.opencode/xray/` > built-in defaults.
 
 ## 4 Tools
 
@@ -90,7 +90,7 @@ Returns: framework status, version, component availability, node version.
 
 ### strray_hooks
 
-Manage StringRay git hooks (install, uninstall, list, status).
+Manage 0xRay git hooks (install, uninstall, list, status).
 
 ```
 strray_hooks(action="install")
@@ -122,7 +122,7 @@ Fires before ANY tool executes:
 1. Tracks session stats
 2. Logs tool-start event to `logs/framework/plugin-tool-events.log`
 3. For code-producing tools (write_file, patch, execute_code, write, edit): runs quality gate + pre-processors via bridge
-4. For other tools: nudges when a StringRay MCP alternative exists (e.g., grep → search_codebase, eslint → strray_lint)
+4. For other tools: nudges when a 0xRay MCP alternative exists (e.g., grep → search_codebase, eslint → strray_lint)
 
 ### post_tool_call
 
@@ -164,7 +164,7 @@ All logs go to `logs/framework/` in the project root:
 
 | User Says | Tool / Command |
 |----------|---------------|
-| "Is StringRay working?" | `strray_health()` or `/strray status` |
+| "Is 0xRay working?" | `strray_health()` or `/strray status` |
 | "Check these files before I commit" | `strray_validate(files=[...], operation="commit")` |
 | "Is this code codex compliant?" | `strray_codex_check(code=..., operation="create")` |
 | "Set up git hooks" | `strray_hooks(action="install")` |

package/dist/skills/registry.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.22.67",
+  "version": "2.0.0",
   "description": "0xRay Skills Registry - recommended skill sources for consumers",
   "sources": [
     {

package/dist/skills/storyteller/SKILL.md

@@ -96,7 +96,7 @@ codex_terms: [5, 7, 32]  # Related Codex term numbers
 ```markdown
 ## What Next?
 
-- Related Codex terms: [codex.json](../../.opencode/strray/codex.json)
+- Related Codex terms: [codex.json](../../.opencode/xray/codex.json)
 - Next story to write: [suggestion]
 ```
 

package/dist/skills/xray-orchestrator/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: xray-orchestrator
+description: |
+  Main orchestration skill for xray agents.
+  Provides commands to coordinate agent work and invoke xray APIs
+  through the local HTTP API server.
+metadata:
+  openclaw:
+    primaryEnv: XRAY_API_KEY
+    emoji: 🤖
+  author: xray
+  tags:
+    - ai
+    - orchestration
+    - agent
+user-invocable: true
+---
+
+# xray Orchestrator Commands
+
+## /xray
+
+Display xray status and available commands.
+
+**Usage:** `/xray`
+
+**Example:**
+```
+/xray
+```
+
+## /xray-status
+
+Get detailed status of xray integration including connection status.
+
+**Usage:** `/xray-status`
+
+**Example:**
+```
+/xray-status
+```
+
+## /xray-analyze
+
+Analyze code using xray code analysis capabilities.
+
+**Usage:** `/xray-analyze <file-path>`
+
+**Arguments:**
+- `file-path`: Path to file to analyze (required)
+
+**Example:**
+```
+/xray-analyze src/index.ts
+```
+
+## /xray-code
+
+Perform code review on a file.
+
+**Usage:** `/xray-code <file-path> [options]`
+
+**Arguments:**
+- `file-path`: Path to file to review (required)
+- `--fix`: Attempt to fix issues automatically (optional)
+
+**Example:**
+```
+/xray-code src/utils/helper.ts
+/xray-code src/utils/helper.ts --fix
+```
+
+## /xray-file
+
+Read file using xray file tools.
+
+**Usage:** `/xray-file <file-path> [line-start:line-end]`
+
+**Arguments:**
+- `file-path`: Path to file to read (required)
+- `line-start:line-end`: Line range to read (optional)
+
+**Example:**
+```
+/xray-file src/index.ts
+/xray-file src/index.ts 1:50
+```
+
+## /xray-exec
+
+Execute arbitrary xray command or script.
+
+**Usage:** `/xray-exec <command>`
+
+**Arguments:**
+- `command`: Command to execute (required)
+
+**Example:**
+```
+/xray-exec list files src/
+```
+
+## /xray-help
+
+Show this help message.
+
+**Usage:** `/xray-help [command]`
+
+**Arguments:**
+- `command`: Specific command to get help for (optional)
+
+**Example:**
+```
+/xray-help
+/xray-help xray-analyze
+```
+
+# Implementation Notes
+
+This skill acts as the main interface between OpenClaw channels and xray agents.
+It processes user commands and forwards them to the xray API server running on localhost:18431.
+
+## API Endpoints
+
+- `POST /api/agent/invoke` - Invoke xray agent
+- `GET /api/agent/status` - Get agent status
+- `GET /health` - Health check
+
+## Authentication
+
+The skill reads the `XRAY_API_KEY` environment variable for authentication.
+
+## Error Handling
+
+All errors are caught and formatted as user-friendly messages.
+Detailed error information is logged for debugging.
+
+# Dependencies
+
+- xray API server running on localhost:18431
+- XRAY_API_KEY environment variable

package/dist/skills/xray-orchestrator/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * xray Orchestrator Skill
+ *
+ * OpenClaw skill that provides xray orchestration commands.
+ *
+ * @version 1.0.0
+ * @since 2026-03-14
+ */
+export declare function handleSkill(input: string): Promise<string>;
+declare const _default: {
+    handleSkill: typeof handleSkill;
+};
+export default _default;

package/dist/skills/xray-orchestrator/index.js

@@ -0,0 +1,224 @@
+/**
+ * xray Orchestrator Skill
+ *
+ * OpenClaw skill that provides xray orchestration commands.
+ *
+ * @version 1.0.0
+ * @since 2026-03-14
+ */
+const API_BASE = process.env.XRAY_API_URL || 'http://localhost:18431';
+const API_KEY = process.env.XRAY_API_KEY;
+function parseArgs(input) {
+    const parts = input.trim().split(/\s+/);
+    const command = parts[0] || '';
+    const args = {};
+    for (const part of parts.slice(1)) {
+        if (part.startsWith('--')) {
+            const key = part.slice(2);
+            args[key] = true;
+        }
+        else if (part.includes(':')) {
+            const colonIdx = part.indexOf(':');
+            const key = part.slice(0, colonIdx);
+            const value = part.slice(colonIdx + 1);
+            if (key && value)
+                args[key] = value;
+        }
+        else if (!args._) {
+            args._ = [];
+            args._.push(part);
+        }
+        else {
+            args._.push(part);
+        }
+    }
+    return { command, args };
+}
+async function callAPI(endpoint, data) {
+    const headers = {
+        'Content-Type': 'application/json',
+    };
+    if (API_KEY) {
+        headers['Authorization'] = `Bearer ${API_KEY}`;
+    }
+    const response = await fetch(`${API_BASE}${endpoint}`, {
+        method: data ? 'POST' : 'GET',
+        headers,
+        body: data ? JSON.stringify(data) : null,
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+        throw new Error(error.error || `HTTP ${response.status}`);
+    }
+    return response.json();
+}
+export async function handleSkill(input) {
+    const { command, args } = parseArgs(input);
+    try {
+        switch (command.toLowerCase()) {
+            // xray primary
+            case 'xray':
+            case 'xray-status':
+                return await handleStatus();
+            case 'xray-analyze':
+                return await handleAnalyze(args);
+            case 'xray-code':
+                return await handleCodeReview(args);
+            case 'xray-file':
+                return await handleFileRead(args);
+            case 'xray-exec':
+                return await handleExec(args);
+            case 'xray-help':
+                return handleHelp(args._);
+            default:
+                return formatHelp();
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return `❌ Error: ${message}`;
+    }
+}
+async function handleStatus() {
+    const health = await callAPI('/health');
+    return `🤖 xray Status
+
+• Status: ${health.status}
+• Version: ${health.version}
+• Uptime: ${formatUptime(health.uptime)}
+
+Use /xray-help for available commands.`;
+}
+async function handleAnalyze(args) {
+    const filePath = args._?.[0];
+    if (!filePath) {
+        return '❌ Usage: /xray-analyze <file-path>';
+    }
+    const result = await callAPI('/api/agent/invoke', {
+        command: 'analyze',
+        args: { filePath },
+    });
+    if (!result.success) {
+        return `❌ Analysis failed: ${result.error}`;
+    }
+    return `✅ Analysis complete for ${filePath}\n\n${JSON.stringify(result.result, null, 2)}`;
+}
+async function handleCodeReview(args) {
+    const filePath = args._?.[0];
+    const fix = args.fix === true;
+    if (!filePath) {
+        return '❌ Usage: /xray-code <file-path> [--fix]';
+    }
+    const result = await callAPI('/api/agent/invoke', {
+        command: 'code-review',
+        args: { filePath, fix },
+    });
+    if (!result.success) {
+        return `❌ Code review failed: ${result.error}`;
+    }
+    return `✅ Code review complete for ${filePath}\n\n${JSON.stringify(result.result, null, 2)}`;
+}
+async function handleFileRead(args) {
+    const rest = args._;
+    const filePath = rest?.[0];
+    const range = rest?.[1];
+    if (!filePath) {
+        return '❌ Usage: /xray-file <file-path> [line-start:line-end]';
+    }
+    let lineRange;
+    if (range?.includes(':')) {
+        const [rawStart, rawEnd] = range.split(':');
+        lineRange = {};
+        if (rawStart)
+            lineRange.start = Number(rawStart);
+        if (rawEnd)
+            lineRange.end = Number(rawEnd);
+    }
+    const result = await callAPI('/api/agent/invoke', {
+        command: 'read',
+        args: { filePath, ...lineRange },
+    });
+    if (!result.success) {
+        return `❌ File read failed: ${result.error}`;
+    }
+    return `📄 ${filePath}\n\`\`\`\n${result.result}\n\`\`\``;
+}
+async function handleExec(args) {
+    const command = args._?.[0];
+    if (!command) {
+        return '❌ Usage: /xray-exec <command>';
+    }
+    const result = await callAPI('/api/agent/invoke', {
+        command: 'exec',
+        args: { command },
+    });
+    if (!result.success) {
+        return `❌ Execution failed: ${result.error}`;
+    }
+    return `✅ Command executed\n\n${JSON.stringify(result.result, null, 2)}`;
+}
+function handleHelp(command) {
+    if (command) {
+        switch (command) {
+            case 'xray-analyze':
+                return `📖 /xray-analyze <file-path>
+
+Analyze code in a file.
+
+Example: /xray-analyze src/index.ts`;
+            case 'xray-code':
+                return `📖 /xray-code <file-path> [--fix]
+
+Perform code review on a file.
+Use --fix to attempt automatic fixes.
+
+Example: /xray-code src/utils/helper.ts
+Example: /xray-code src/utils/helper.ts --fix`;
+            case 'xray-file':
+                return `📖 /xray-file <file-path> [line-start:line-end]
+
+Read a file.
+Optionally specify line range.
+
+Example: /xray-file src/index.ts
+Example: /xray-file src/index.ts 1:50`;
+            case 'xray-exec':
+                return `📖 /xray-exec <command>
+
+Execute an arbitrary command.
+
+Example: /xray-exec list files src/`;
+            default:
+                return `Unknown command: ${command}`;
+        }
+    }
+    return formatHelp();
+}
+function formatHelp() {
+    return `🤖 xray Orchestrator
+
+Available Commands:
+• /xray - Show status
+• /xray-analyze <file> - Analyze code
+• /xray-code <file> [--fix] - Code review
+• /xray-file <file> [lines] - Read file
+• /xray-exec <command> - Execute command
+• /xray-help [command] - Show help
+
+Use /xray-help <command> for detailed usage.`;
+}
+function formatUptime(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0)
+        return `${days}d ${hours % 24}h`;
+    if (hours > 0)
+        return `${hours}h ${minutes % 60}m`;
+    if (minutes > 0)
+        return `${minutes}m`;
+    return `${seconds}s`;
+}
+// Export for OpenClaw
+export default { handleSkill };

package/dist/state/context-providers.d.ts

@@ -0,0 +1,4 @@
+export interface ContextProviders {
+    createProvider: <T>(value: T) => unknown;
+    useContext: <T>() => T;
+}

package/dist/state/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./state-manager.js";
+export * from "./context-providers.js";
+export * from "./state-types.js";
+export { XrayStateManager } from "./state-manager.js";
+export { XrayStateManager as StringRayStateManager } from "./state-manager.js";

package/dist/state/index.js

@@ -4,4 +4,5 @@ export * from "./state-manager.js";
 export * from "./context-providers.js";
 export * from "./state-types.js";
 // Re-export commonly used state utilities
-export { StringRayStateManager } from "./state-manager.js";
+export { XrayStateManager } from "./state-manager.js";
+export { XrayStateManager as StringRayStateManager } from "./state-manager.js";

package/dist/state/state-manager.d.ts

@@ -0,0 +1,42 @@
+export interface StateManager {
+    get: <T>(key: string) => T | undefined;
+    set: <T>(key: string, value: T) => void;
+    clear: (key: string) => void;
+}
+export declare class XrayStateManager implements StateManager {
+    private store;
+    private persistencePath;
+    private persistenceEnabled;
+    private writeQueue;
+    private initialized;
+    private earlyOperationsQueue;
+    static readonly VERSION = "1.5.2";
+    constructor(persistencePath?: string | undefined, persistenceEnabled?: boolean);
+    private initializePersistence;
+    private persistToDisk;
+    private isSerializable;
+    private schedulePersistence;
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, value: T): void;
+    clear(key: string): void;
+    clearAll(): void;
+    isPersistenceEnabled(): boolean;
+    getPersistenceStats(): {
+        enabled: boolean;
+        initialized: boolean;
+        keysInMemory: number;
+        pendingWrites: number;
+    };
+    getStateVersion(): string;
+    getAuditLog(): Array<{
+        timestamp: Date;
+        operation: string;
+        key: string;
+    }>;
+    resolveConflict(conflict: {
+        key: string;
+        value1: unknown;
+        value2: unknown;
+    }): unknown;
+}
+export { XrayStateManager as StringRayStateManager, XrayStateManager as StrRayStateManager };