strray-ai 1.22.21 → 1.22.23

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

@@ -0,0 +1,427 @@
+/**
+ * OpenClaw Integration Types
+ *
+ * TypeScript interfaces for OpenClaw Gateway Protocol v3
+ * and 0xRay integration components.
+ *
+ * @version 1.0.0
+ * @since 2026-03-14
+ */
+/**
+ * OpenClaw WebSocket connection handshake parameters
+ */
+export interface OpenClawConnectParams {
+    minProtocol: number;
+    maxProtocol: number;
+    client: {
+        id: string;
+        version: string;
+        platform: string;
+        mode: 'operator' | 'node';
+    };
+    role: 'operator' | 'node';
+    scopes: string[];
+    caps: string[];
+    commands: string[];
+    permissions?: Record<string, boolean>;
+    auth?: {
+        token?: string;
+    };
+    device?: {
+        id: string;
+        publicKey: string;
+        signature: string;
+        signedAt: number;
+        nonce: string;
+    };
+    locale?: string;
+    userAgent: string;
+}
+/**
+ * OpenClaw WebSocket frame - Request (client → server)
+ */
+export interface OpenClawFrameRequest {
+    type: 'req';
+    id: string;
+    method: string;
+    params: Record<string, unknown>;
+}
+/**
+ * OpenClaw WebSocket frame - Response (server → client)
+ */
+export interface OpenClawFrameResponse {
+    type: 'res';
+    id: string;
+    ok: boolean;
+    result?: unknown;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * OpenClaw WebSocket frame - Event (server → client)
+ */
+export interface OpenClawFrameEvent {
+    type: 'event';
+    event: string;
+    data?: Record<string, unknown>;
+    seq?: number;
+    stateVersion?: string;
+}
+/**
+ * Union type for all OpenClaw frame types
+ */
+export type OpenClawFrame = OpenClawFrameRequest | OpenClawFrameResponse | OpenClawFrameEvent;
+/**
+ * OpenClaw client connection states
+ */
+export type OpenClawClientState = 'disconnected' | 'connecting' | 'connected' | 'authenticating' | 'authorized' | 'reconnecting' | 'error';
+/**
+ * Pending request for request/response handling
+ */
+export interface PendingRequest {
+    resolve: (value: unknown) => void;
+    reject: (reason: Error) => void;
+    timeout: NodeJS.Timeout;
+    timestamp: number;
+}
+/**
+ * Client configuration options
+ */
+export interface OpenClawClientConfig {
+    gatewayUrl: string;
+    authToken?: string | undefined;
+    deviceId?: string | undefined;
+    deviceKeyPair?: {
+        publicKey: string;
+        privateKey: string;
+    } | undefined;
+    reconnect?: boolean;
+    reconnectAttempts?: number;
+    reconnectDelay?: number;
+    pingInterval?: number;
+    requestTimeout?: number;
+}
+/**
+ * 0xRay API server configuration
+ */
+export interface StringRayAPIServerConfig {
+    port: number;
+    host?: string;
+    apiKey?: string;
+    cors?: boolean;
+    rateLimit?: {
+        windowMs: number;
+        maxRequests: number;
+    };
+}
+/**
+ * Agent invocation request from OpenClaw skill
+ */
+export interface AgentInvokeRequest {
+    command: string;
+    args?: Record<string, unknown>;
+    sessionId?: string;
+    agent?: string;
+    timeout?: number;
+}
+/**
+ * Agent invocation response
+ */
+export interface AgentInvokeResponse {
+    success: boolean;
+    result?: unknown;
+    error?: string;
+    sessionId?: string;
+    executionTime?: number;
+}
+/**
+ * Health check response
+ */
+export interface HealthCheckResponse {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    version: string;
+    uptime: number;
+    openclaw?: {
+        connected: boolean;
+        state: OpenClawClientState;
+    };
+}
+/**
+ * API route definitions
+ */
+export interface APIRoute {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    path: string;
+    handler: (req: Request, res: Response) => Promise<void>;
+    requiresAuth?: boolean;
+}
+/**
+ * OpenClaw Skill metadata (SKILL.md frontmatter)
+ */
+export interface OpenClawSkillMetadata {
+    name: string;
+    description: string;
+    version?: string;
+    metadata?: {
+        openclaw?: {
+            requires?: {
+                bins?: string[];
+                env?: string[];
+                config?: string[];
+            };
+            primaryEnv?: string;
+            emoji?: string;
+        };
+        author?: string;
+        tags?: string[];
+    };
+    userInvocable?: boolean;
+    commands?: SkillCommand[];
+}
+/**
+ * Skill command definition
+ */
+export interface SkillCommand {
+    name: string;
+    description: string;
+    usage?: string;
+    examples?: string[];
+    requiresAuth?: boolean;
+}
+/**
+ * Skill command execution request
+ */
+export interface SkillExecutionRequest {
+    command: string;
+    args: Record<string, unknown>;
+    userId?: string;
+    sessionId?: string;
+    channel?: string;
+}
+/**
+ * Skill command execution response
+ */
+export interface SkillExecutionResponse {
+    success: boolean;
+    output?: string;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Tool execution event from 0xRay
+ */
+export interface ToolExecutionEvent {
+    toolName: string;
+    toolId: string;
+    args: Record<string, unknown>;
+    result?: unknown;
+    error?: string;
+    duration: number;
+    timestamp: number;
+    sessionId?: string;
+    agent?: string;
+}
+/**
+ * Tool before execution event
+ */
+export interface ToolBeforeEvent extends ToolExecutionEvent {
+    eventType: 'tool.before';
+}
+/**
+ * Tool after execution event
+ */
+export interface ToolAfterEvent extends ToolExecutionEvent {
+    eventType: 'tool.after';
+    success: boolean;
+}
+/**
+ * Tool event subscription options
+ */
+export interface ToolEventSubscription {
+    toolNames?: string[];
+    includeArgs?: boolean;
+    includeResult?: boolean;
+    includeMetadata?: boolean;
+}
+/**
+ * Complete OpenClaw integration configuration
+ */
+export interface OpenClawIntegrationConfig {
+    gatewayUrl: string;
+    authToken?: string;
+    deviceId?: string;
+    deviceKeyPair?: {
+        publicKey: string;
+        privateKey: string;
+    };
+    autoReconnect: boolean;
+    maxReconnectAttempts: number;
+    reconnectDelay: number;
+    apiServer: {
+        enabled: boolean;
+        port: number;
+        host?: string;
+        apiKey?: string;
+    };
+    hooks: {
+        enabled: boolean;
+        toolBefore: boolean;
+        toolAfter: boolean;
+        includeArgs: boolean;
+        includeResult: boolean;
+        toolFilter?: string[];
+    };
+    enabled: boolean;
+    debug: boolean;
+    logLevel?: 'error' | 'warn' | 'info' | 'debug';
+}
+/**
+ * Configuration validation result
+ */
+export interface ConfigValidationResult {
+    valid: boolean;
+    errors: ConfigValidationError[];
+    warnings: ConfigValidationWarning[];
+}
+export interface ConfigValidationError {
+    field: string;
+    message: string;
+    code: string;
+}
+export interface ConfigValidationWarning {
+    field: string;
+    message: string;
+}
+/**
+ * OpenClaw integration error codes
+ */
+export declare enum OpenClawErrorCode {
+    CONNECTION_FAILED = "CONNECTION_FAILED",
+    CONNECTION_TIMEOUT = "CONNECTION_TIMEOUT",
+    AUTH_FAILED = "AUTH_FAILED",
+    TOKEN_MISMATCH = "TOKEN_MISMATCH",
+    DEVICE_NOT_PAIRED = "DEVICE_NOT_PAIRED",
+    INVALID_FRAME = "INVALID_FRAME",
+    UNSUPPORTED_METHOD = "UNSUPPORTED_METHOD",
+    OUT_OF_SCOPE = "OUT_OF_SCOPE",
+    PROTOCOL_VERSION_MISMATCH = "PROTOCOL_VERSION_MISMATCH",
+    REQUEST_TIMEOUT = "REQUEST_TIMEOUT",
+    REQUEST_CANCELLED = "REQUEST_CANCELLED",
+    SERVER_ERROR = "SERVER_ERROR",
+    SERVER_UNAVAILABLE = "SERVER_UNAVAILABLE",
+    SKILL_NOT_FOUND = "SKILL_NOT_FOUND",
+    SKILL_LOAD_FAILED = "SKILL_LOAD_FAILED",
+    SKILL_EXECUTION_FAILED = "SKILL_EXECUTION_FAILED",
+    STRINGRAY_UNAVAILABLE = "STRINGRAY_UNAVAILABLE",
+    STRINGRAY_TIMEOUT = "STRINGRAY_TIMEOUT",
+    STRINGRAY_ERROR = "STRINGRAY_ERROR",
+    CONFIG_INVALID = "CONFIG_INVALID",
+    CONFIG_MISSING = "CONFIG_MISSING",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+/**
+ * Base error class for OpenClaw integration
+ */
+export declare class OpenClawError extends Error {
+    code: OpenClawErrorCode;
+    recoverable: boolean;
+    context?: Record<string, unknown> | undefined;
+    constructor(message: string, code: OpenClawErrorCode, recoverable: boolean, context?: Record<string, unknown> | undefined);
+}
+/**
+ * Connection error
+ */
+export declare class OpenClawConnectionError extends OpenClawError {
+    originalError?: Error | undefined;
+    constructor(message: string, originalError?: Error | undefined);
+}
+/**
+ * Authentication error
+ */
+export declare class OpenClawAuthError extends OpenClawError {
+    authType?: "token" | "device" | undefined;
+    constructor(message: string, authType?: "token" | "device" | undefined);
+}
+/**
+ * Request timeout error
+ */
+export declare class OpenClawTimeoutError extends OpenClawError {
+    method: string;
+    timeout: number;
+    constructor(method: string, timeout: number);
+}
+/**
+ * Configuration error
+ */
+export declare class OpenClawConfigError extends OpenClawError {
+    field?: string | undefined;
+    constructor(message: string, field?: string | undefined);
+}
+/**
+ * Check if frame is a request frame
+ */
+export declare function isOpenClawRequest(frame: unknown): frame is OpenClawFrameRequest;
+/**
+ * Check if frame is a response frame
+ */
+export declare function isOpenClawResponse(frame: unknown): frame is OpenClawFrameResponse;
+/**
+ * Check if frame is an event frame
+ */
+export declare function isOpenClawEvent(frame: unknown): frame is OpenClawFrameEvent;
+/**
+ * Check if error is recoverable
+ */
+export declare function isRecoverableError(error: OpenClawError): boolean;
+/**
+ * Client statistics
+ */
+export interface ClientStatistics {
+    connectedAt?: number;
+    lastMessageAt?: number;
+    messagesSent: number;
+    messagesReceived: number;
+    requestsSent: number;
+    requestsSucceeded: number;
+    requestsFailed: number;
+    reconnects: number;
+    errors: number;
+}
+/**
+ * API server statistics
+ */
+export interface APIServerStatistics {
+    startedAt: number;
+    requestsTotal: number;
+    requestsByEndpoint: Record<string, number>;
+    requestsByStatus: Record<number, number>;
+    averageResponseTime: number;
+    errors: number;
+}
+/**
+ * Integration statistics
+ */
+export interface IntegrationStatistics {
+    client: ClientStatistics;
+    apiServer: APIServerStatistics;
+    uptime: number;
+}
+/**
+ * OpenClaw client events
+ */
+export type OpenClawClientEvent = 'connecting' | 'connected' | 'disconnected' | 'authorized' | 'reconnecting' | 'error' | 'frame' | 'event';
+/**
+ * Client event listener type
+ */
+export type OpenClawEventListener = (data?: unknown) => void | Promise<void>;
+/**
+ * State change event
+ */
+export interface StateChangeEvent {
+    previousState: OpenClawClientState;
+    newState: OpenClawClientState;
+    timestamp: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/integrations/openclaw/types.js

@@ -0,0 +1,154 @@
+/**
+ * OpenClaw Integration Types
+ *
+ * TypeScript interfaces for OpenClaw Gateway Protocol v3
+ * and 0xRay integration components.
+ *
+ * @version 1.0.0
+ * @since 2026-03-14
+ */
+// ============================================================================
+// Error Types
+// ============================================================================
+/**
+ * OpenClaw integration error codes
+ */
+export var OpenClawErrorCode;
+(function (OpenClawErrorCode) {
+    // Connection errors
+    OpenClawErrorCode["CONNECTION_FAILED"] = "CONNECTION_FAILED";
+    OpenClawErrorCode["CONNECTION_TIMEOUT"] = "CONNECTION_TIMEOUT";
+    OpenClawErrorCode["AUTH_FAILED"] = "AUTH_FAILED";
+    OpenClawErrorCode["TOKEN_MISMATCH"] = "TOKEN_MISMATCH";
+    OpenClawErrorCode["DEVICE_NOT_PAIRED"] = "DEVICE_NOT_PAIRED";
+    // Protocol errors
+    OpenClawErrorCode["INVALID_FRAME"] = "INVALID_FRAME";
+    OpenClawErrorCode["UNSUPPORTED_METHOD"] = "UNSUPPORTED_METHOD";
+    OpenClawErrorCode["OUT_OF_SCOPE"] = "OUT_OF_SCOPE";
+    OpenClawErrorCode["PROTOCOL_VERSION_MISMATCH"] = "PROTOCOL_VERSION_MISMATCH";
+    // Request errors
+    OpenClawErrorCode["REQUEST_TIMEOUT"] = "REQUEST_TIMEOUT";
+    OpenClawErrorCode["REQUEST_CANCELLED"] = "REQUEST_CANCELLED";
+    // Server errors
+    OpenClawErrorCode["SERVER_ERROR"] = "SERVER_ERROR";
+    OpenClawErrorCode["SERVER_UNAVAILABLE"] = "SERVER_UNAVAILABLE";
+    // Skill errors
+    OpenClawErrorCode["SKILL_NOT_FOUND"] = "SKILL_NOT_FOUND";
+    OpenClawErrorCode["SKILL_LOAD_FAILED"] = "SKILL_LOAD_FAILED";
+    OpenClawErrorCode["SKILL_EXECUTION_FAILED"] = "SKILL_EXECUTION_FAILED";
+    // 0xRay errors
+    OpenClawErrorCode["STRINGRAY_UNAVAILABLE"] = "STRINGRAY_UNAVAILABLE";
+    OpenClawErrorCode["STRINGRAY_TIMEOUT"] = "STRINGRAY_TIMEOUT";
+    OpenClawErrorCode["STRINGRAY_ERROR"] = "STRINGRAY_ERROR";
+    // Configuration errors
+    OpenClawErrorCode["CONFIG_INVALID"] = "CONFIG_INVALID";
+    OpenClawErrorCode["CONFIG_MISSING"] = "CONFIG_MISSING";
+    // Unknown
+    OpenClawErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+})(OpenClawErrorCode || (OpenClawErrorCode = {}));
+/**
+ * Base error class for OpenClaw integration
+ */
+export class OpenClawError extends Error {
+    code;
+    recoverable;
+    context;
+    constructor(message, code, recoverable, context) {
+        super(message);
+        this.code = code;
+        this.recoverable = recoverable;
+        this.context = context;
+        this.name = 'OpenClawError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+/**
+ * Connection error
+ */
+export class OpenClawConnectionError extends OpenClawError {
+    originalError;
+    constructor(message, originalError) {
+        super(message, OpenClawErrorCode.CONNECTION_FAILED, true, {
+            originalError: originalError?.message,
+        });
+        this.originalError = originalError;
+        this.name = 'OpenClawConnectionError';
+    }
+}
+/**
+ * Authentication error
+ */
+export class OpenClawAuthError extends OpenClawError {
+    authType;
+    constructor(message, authType) {
+        super(message, OpenClawErrorCode.AUTH_FAILED, false, { authType });
+        this.authType = authType;
+        this.name = 'OpenClawAuthError';
+    }
+}
+/**
+ * Request timeout error
+ */
+export class OpenClawTimeoutError extends OpenClawError {
+    method;
+    timeout;
+    constructor(method, timeout) {
+        super(`Request to ${method} timed out after ${timeout}ms`, OpenClawErrorCode.REQUEST_TIMEOUT, true, {
+            method,
+            timeout,
+        });
+        this.method = method;
+        this.timeout = timeout;
+        this.name = 'OpenClawTimeoutError';
+    }
+}
+/**
+ * Configuration error
+ */
+export class OpenClawConfigError extends OpenClawError {
+    field;
+    constructor(message, field) {
+        super(message, OpenClawErrorCode.CONFIG_INVALID, false, { field });
+        this.field = field;
+        this.name = 'OpenClawConfigError';
+    }
+}
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Check if frame is a request frame
+ */
+export function isOpenClawRequest(frame) {
+    return (typeof frame === 'object' &&
+        frame !== null &&
+        frame.type === 'req' &&
+        typeof frame.id === 'string' &&
+        typeof frame.method === 'string');
+}
+/**
+ * Check if frame is a response frame
+ */
+export function isOpenClawResponse(frame) {
+    return (typeof frame === 'object' &&
+        frame !== null &&
+        frame.type === 'res' &&
+        typeof frame.id === 'string' &&
+        typeof frame.ok === 'boolean');
+}
+/**
+ * Check if frame is an event frame
+ */
+export function isOpenClawEvent(frame) {
+    return (typeof frame === 'object' &&
+        frame !== null &&
+        frame.type === 'event' &&
+        typeof frame.event === 'string');
+}
+/**
+ * Check if error is recoverable
+ */
+export function isRecoverableError(error) {
+    return error.recoverable;
+}
+//# sourceMappingURL=types.js.map

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

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

package/dist/mcps/architect-tools.server.js

@@ -14,7 +14,7 @@ class StringRayArchitectToolsServer {
     server;
     constructor() {
         this.server = new Server({
-            name: "architect-tools", version: "1.22.13",
+            name: "architect-tools", version: "1.22.22",
         }, {
             capabilities: {
                 tools: {},

package/dist/mcps/auto-format.server.js

@@ -13,7 +13,7 @@ class StringRayAutoFormatServer {
     server;
     constructor() {
         this.server = new Server({
-            name: "auto-format", version: "1.22.13",
+            name: "auto-format", version: "1.22.22",
         }, {
             capabilities: {
                 tools: {},

package/dist/mcps/boot-orchestrator.server.js

@@ -30,7 +30,7 @@ class StringRayBootOrchestratorServer {
     ];
     constructor() {
         this.server = new Server({
-            name: "boot-orchestrator", version: "1.22.13",
+            name: "boot-orchestrator", version: "1.22.22",
         }, {
             capabilities: {
                 tools: {},

package/dist/mcps/enforcer-tools.server.js

@@ -16,7 +16,7 @@ class StringRayEnforcerToolsServer {
     server;
     constructor() {
         this.server = new Server({
-            name: "enforcer", version: "1.22.13",
+            name: "enforcer", version: "1.22.22",
         }, {
             capabilities: {
                 tools: {},

package/dist/mcps/estimation.server.js

@@ -17,7 +17,7 @@ class EstimationServer {
     validator = getEstimationValidator();
     constructor() {
         this.server = new Server({
-            name: "estimation-validator", version: "1.22.13",
+            name: "estimation-validator", version: "1.22.22",
         }, {
             capabilities: { tools: {} },
         });

package/dist/mcps/framework-compliance-audit.server.js

@@ -12,7 +12,7 @@ class StringRayFrameworkComplianceAuditServer {
     server;
     constructor() {
         this.server = new Server({
-            name: "framework-compliance-audit", version: "1.22.13",
+            name: "framework-compliance-audit", version: "1.22.22",
         }, {
             capabilities: {
                 tools: {},

package/dist/mcps/framework-help.server.js

@@ -7,7 +7,7 @@ class FrameworkHelpServer {
     server;
     constructor() {
         this.server = new Server({
-            name: "strray/framework-help", version: "1.22.13",
+            name: "strray/framework-help", version: "1.22.22",
         }, {
             capabilities: {
                 tools: {},

package/dist/mcps/knowledge-skills/api-design.server.js

@@ -12,7 +12,7 @@ class StringRayApiDesignServer {
     server;
     constructor() {
         this.server = new Server({
-            name: "api-design", version: "1.22.13",
+            name: "api-design", version: "1.22.22",
         }, {
             capabilities: {
                 tools: {},