@bluefly/openstandardagents 0.3.6 → 0.4.1

package/dist/services/dev-server/live-validator.js

@@ -0,0 +1,301 @@
+/**
+ * Live Validator Service
+ *
+ * Validates OSSA manifests in real-time as files change
+ *
+ * Features:
+ * - Real-time validation on file changes
+ * - Detailed error messages with line numbers
+ * - Validation caching for performance
+ * - Multiple validation levels (schema, semantic, best practices)
+ *
+ * SOLID: Single Responsibility - Validation only
+ */
+import { readFile } from 'fs/promises';
+import yaml from 'yaml';
+import { ValidationService } from '../validation.service.js';
+import { container } from '../../di-container.js';
+/**
+ * Live Validator Service
+ *
+ * Validates OSSA manifests with detailed error reporting
+ */
+export class LiveValidator {
+    validationService;
+    cache = new Map();
+    options;
+    constructor(options = {}) {
+        this.validationService = container.get(ValidationService);
+        this.options = {
+            semanticValidation: true,
+            bestPractices: true,
+            caching: true,
+            ...options,
+        };
+    }
+    /**
+     * Validate a manifest file
+     */
+    async validate(filePath) {
+        const startTime = Date.now();
+        try {
+            // Read file
+            const content = await readFile(filePath, 'utf-8');
+            // Check cache
+            if (this.options.caching) {
+                const hash = this.hashContent(content);
+                const cached = this.cache.get(filePath);
+                if (cached && cached.hash === hash) {
+                    // Return cached result with updated timestamp
+                    return {
+                        ...cached.result,
+                        timestamp: new Date(),
+                    };
+                }
+            }
+            // Parse YAML
+            let manifest;
+            const errors = [];
+            const warnings = [];
+            try {
+                manifest = yaml.parse(content);
+            }
+            catch (error) {
+                const err = error;
+                errors.push({
+                    level: 'error',
+                    message: `YAML parse error: ${err.message}`,
+                    line: err.linePos?.[0]?.line,
+                    column: err.linePos?.[0]?.col,
+                    code: 'YAML_PARSE_ERROR',
+                });
+                return this.createResult(filePath, false, errors, warnings, undefined, startTime);
+            }
+            // Schema validation
+            const schemaErrors = await this.validateSchema(manifest, content);
+            errors.push(...schemaErrors);
+            // Semantic validation
+            if (this.options.semanticValidation && errors.length === 0) {
+                const semanticIssues = await this.validateSemantic(manifest);
+                errors.push(...semanticIssues.errors);
+                warnings.push(...semanticIssues.warnings);
+            }
+            // Best practices
+            if (this.options.bestPractices && errors.length === 0) {
+                const practiceWarnings = await this.validateBestPractices(manifest);
+                warnings.push(...practiceWarnings);
+            }
+            const valid = errors.length === 0;
+            const result = this.createResult(filePath, valid, errors, warnings, valid ? manifest : undefined, startTime);
+            // Cache result
+            if (this.options.caching) {
+                this.cache.set(filePath, {
+                    hash: this.hashContent(content),
+                    result,
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            // Unexpected error
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return this.createResult(filePath, false, [
+                {
+                    level: 'error',
+                    message: `Validation error: ${errorMessage}`,
+                    code: 'VALIDATION_ERROR',
+                },
+            ], [], undefined, startTime);
+        }
+    }
+    /**
+     * Clear validation cache
+     */
+    clearCache(filePath) {
+        if (filePath) {
+            this.cache.delete(filePath);
+        }
+        else {
+            this.cache.clear();
+        }
+    }
+    /**
+     * Validate against JSON schema
+     */
+    async validateSchema(manifest, content) {
+        const errors = [];
+        try {
+            const result = await this.validationService.validate(manifest);
+            if (!result.valid && result.errors) {
+                for (const error of result.errors) {
+                    // Try to find line number in YAML
+                    const lineInfo = this.findLineNumber(content, error.instancePath);
+                    errors.push({
+                        level: 'error',
+                        message: error.message || 'Schema validation error',
+                        path: error.instancePath,
+                        line: lineInfo?.line,
+                        column: lineInfo?.column,
+                        code: 'SCHEMA_VALIDATION_ERROR',
+                    });
+                }
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            errors.push({
+                level: 'error',
+                message: `Schema validation failed: ${errorMessage}`,
+                code: 'SCHEMA_VALIDATION_FAILED',
+            });
+        }
+        return errors;
+    }
+    /**
+     * Validate semantic correctness
+     */
+    async validateSemantic(manifest) {
+        const errors = [];
+        const warnings = [];
+        // Check required fields
+        if (!manifest.metadata?.name) {
+            errors.push({
+                level: 'error',
+                message: 'Agent name is required',
+                path: '/metadata/name',
+                code: 'MISSING_NAME',
+            });
+        }
+        if (!manifest.spec?.role) {
+            errors.push({
+                level: 'error',
+                message: 'Agent role is required',
+                path: '/spec/role',
+                code: 'MISSING_ROLE',
+            });
+        }
+        // Check LLM configuration
+        if (!manifest.spec?.llm) {
+            warnings.push({
+                level: 'warning',
+                message: 'No LLM configuration specified',
+                path: '/spec/llm',
+                suggestion: 'Add LLM configuration with provider and model',
+            });
+        }
+        return { errors, warnings };
+    }
+    /**
+     * Validate best practices
+     */
+    async validateBestPractices(manifest) {
+        const warnings = [];
+        // Check description
+        if (!manifest.metadata?.description ||
+            manifest.metadata.description.length < 10) {
+            warnings.push({
+                level: 'warning',
+                message: 'Agent description should be descriptive (at least 10 characters)',
+                path: '/metadata/description',
+                suggestion: 'Add a clear description of what this agent does',
+            });
+        }
+        // Check role length
+        if (manifest.spec?.role && manifest.spec.role.length < 20) {
+            warnings.push({
+                level: 'warning',
+                message: 'Agent role should be detailed (at least 20 characters)',
+                path: '/spec/role',
+                suggestion: 'Provide a detailed role description for better agent behavior',
+            });
+        }
+        // Check tags
+        if (!manifest.metadata?.tags || manifest.metadata.tags.length === 0) {
+            warnings.push({
+                level: 'warning',
+                message: 'No tags specified',
+                path: '/metadata/tags',
+                suggestion: 'Add tags to help categorize and discover this agent',
+            });
+        }
+        // Check tools
+        if (manifest.spec?.tools && manifest.spec.tools.length > 10) {
+            warnings.push({
+                level: 'warning',
+                message: 'Large number of tools (>10) may impact performance',
+                path: '/spec/tools',
+                suggestion: 'Consider splitting into multiple agents or reducing tool count',
+            });
+        }
+        return warnings;
+    }
+    /**
+     * Find line number for JSON path in YAML content
+     */
+    findLineNumber(content, jsonPath) {
+        if (!jsonPath)
+            return undefined;
+        try {
+            // Parse YAML with line info
+            const doc = yaml.parseDocument(content);
+            // Navigate to path
+            const parts = jsonPath.split('/').filter(Boolean);
+            let node = doc.contents;
+            for (const part of parts) {
+                if (!node)
+                    break;
+                if (typeof node === 'object' &&
+                    node !== null &&
+                    'get' in node &&
+                    typeof node.get === 'function') {
+                    node = node.get(part);
+                }
+                else if (typeof node === 'object' && node !== null && part in node) {
+                    node = node[part];
+                }
+            }
+            if (typeof node === 'object' &&
+                node !== null &&
+                'range' in node &&
+                Array.isArray(node.range)) {
+                const range = node.range;
+                const lines = content.substring(0, range[0]).split('\n');
+                return {
+                    line: lines.length,
+                    column: lines[lines.length - 1].length + 1,
+                };
+            }
+        }
+        catch {
+            // Ignore parse errors
+        }
+        return undefined;
+    }
+    /**
+     * Create validation result
+     */
+    createResult(filePath, valid, errors, warnings, manifest, startTime) {
+        return {
+            valid,
+            filePath,
+            timestamp: new Date(),
+            errors,
+            warnings,
+            manifest,
+            duration: Date.now() - startTime,
+        };
+    }
+    /**
+     * Simple hash for caching
+     */
+    hashContent(content) {
+        let hash = 0;
+        for (let i = 0; i < content.length; i++) {
+            const char = content.charCodeAt(i);
+            hash = (hash << 5) - hash + char;
+            hash = hash & hash; // Convert to 32-bit integer
+        }
+        return hash.toString(36);
+    }
+}
+//# sourceMappingURL=live-validator.js.map

package/dist/services/dev-server/live-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-validator.js","sourceRoot":"","sources":["../../../src/services/dev-server/live-validator.ts"],"names":[],"mappings":"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"}

package/dist/services/dev-server/websocket-server.d.ts

@@ -0,0 +1,137 @@
+/**
+ * WebSocket Server for Dev Mode
+ *
+ * Pushes real-time updates to connected clients
+ *
+ * Features:
+ * - File change notifications
+ * - Validation results
+ * - Hot reload triggers
+ * - Client management
+ *
+ * SOLID: Single Responsibility - WebSocket communication
+ */
+import type { Server } from 'http';
+import type { FileChangeEvent } from './file-watcher.js';
+import type { ValidationResult } from './live-validator.js';
+export interface WebSocketServerOptions {
+    /**
+     * HTTP server to attach to
+     */
+    server?: Server;
+    /**
+     * Port to listen on (if no server provided)
+     * @default 8080
+     */
+    port?: number;
+    /**
+     * WebSocket path
+     * @default '/ws'
+     */
+    path?: string;
+}
+export interface DevServerMessage {
+    /**
+     * Message type
+     */
+    type: 'file_change' | 'validation' | 'reload' | 'error' | 'connected';
+    /**
+     * Message timestamp
+     */
+    timestamp: Date;
+    /**
+     * Message data
+     */
+    data?: unknown;
+}
+export interface FileChangeMessage extends DevServerMessage {
+    type: 'file_change';
+    data: {
+        event: FileChangeEvent;
+    };
+}
+export interface ValidationMessage extends DevServerMessage {
+    type: 'validation';
+    data: {
+        result: ValidationResult;
+    };
+}
+export interface ReloadMessage extends DevServerMessage {
+    type: 'reload';
+    data: {
+        filePath: string;
+        reason: string;
+    };
+}
+export interface ErrorMessage extends DevServerMessage {
+    type: 'error';
+    data: {
+        message: string;
+        details?: unknown;
+    };
+}
+export interface ConnectedMessage extends DevServerMessage {
+    type: 'connected';
+    data: {
+        serverVersion: string;
+        watchedFiles: string[];
+    };
+}
+/**
+ * WebSocket Server for Development Mode
+ *
+ * Manages WebSocket connections and broadcasts updates
+ */
+export declare class DevWebSocketServer {
+    private wss?;
+    private clients;
+    private options;
+    private messageQueue;
+    private readonly MAX_QUEUE_SIZE;
+    constructor(options?: WebSocketServerOptions);
+    /**
+     * Start WebSocket server
+     */
+    start(): Promise<void>;
+    /**
+     * Stop WebSocket server
+     */
+    stop(): Promise<void>;
+    /**
+     * Broadcast file change event
+     */
+    broadcastFileChange(event: FileChangeEvent): void;
+    /**
+     * Broadcast validation result
+     */
+    broadcastValidation(result: ValidationResult): void;
+    /**
+     * Broadcast reload request
+     */
+    broadcastReload(filePath: string, reason: string): void;
+    /**
+     * Broadcast error
+     */
+    broadcastError(errorMessage: string, details?: unknown): void;
+    /**
+     * Get number of connected clients
+     */
+    getClientCount(): number;
+    /**
+     * Handle new WebSocket connection
+     */
+    private handleConnection;
+    /**
+     * Handle message from client
+     */
+    private handleClientMessage;
+    /**
+     * Broadcast message to all connected clients
+     */
+    private broadcast;
+    /**
+     * Send message to specific client
+     */
+    private sendMessage;
+}
+//# sourceMappingURL=websocket-server.d.ts.map

package/dist/services/dev-server/websocket-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-server.d.ts","sourceRoot":"","sources":["../../../src/services/dev-server/websocket-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,aAAa,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;IAEtE;;OAEG;IACH,SAAS,EAAE,IAAI,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE;QACJ,KAAK,EAAE,eAAe,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE;QACJ,MAAM,EAAE,gBAAgB,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE;QACJ,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;CACH;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,GAAG,CAAC,CAAkB;IAC9B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAO;gBAE1B,OAAO,GAAE,sBAA2B;IAShD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IASjD;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IASnD;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IASvD;;OAEG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAY7D;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2CxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;OAEG;IACH,OAAO,CAAC,SAAS;IA8BjB;;OAEG;IACH,OAAO,CAAC,WAAW;CASpB"}

package/dist/services/dev-server/websocket-server.js

@@ -0,0 +1,229 @@
+/**
+ * WebSocket Server for Dev Mode
+ *
+ * Pushes real-time updates to connected clients
+ *
+ * Features:
+ * - File change notifications
+ * - Validation results
+ * - Hot reload triggers
+ * - Client management
+ *
+ * SOLID: Single Responsibility - WebSocket communication
+ */
+import { WebSocketServer, WebSocket } from 'ws';
+/**
+ * WebSocket Server for Development Mode
+ *
+ * Manages WebSocket connections and broadcasts updates
+ */
+export class DevWebSocketServer {
+    wss;
+    clients = new Set();
+    options;
+    messageQueue = [];
+    MAX_QUEUE_SIZE = 100;
+    constructor(options = {}) {
+        this.options = {
+            server: undefined,
+            port: 8080,
+            path: '/ws',
+            ...options,
+        };
+    }
+    /**
+     * Start WebSocket server
+     */
+    async start() {
+        if (this.wss) {
+            throw new Error('WebSocket server is already running');
+        }
+        const wsOptions = {
+            path: this.options.path,
+        };
+        if (this.options.server) {
+            wsOptions.server = this.options.server;
+        }
+        else {
+            wsOptions.port = this.options.port;
+        }
+        this.wss = new WebSocketServer(wsOptions);
+        this.wss.on('connection', (ws) => {
+            this.handleConnection(ws);
+        });
+        this.wss.on('error', (error) => {
+            console.error('WebSocket server error:', error);
+        });
+        console.log(`WebSocket server started on ${this.options.server ? 'attached server' : `port ${this.options.port}`}`);
+    }
+    /**
+     * Stop WebSocket server
+     */
+    async stop() {
+        if (!this.wss) {
+            return;
+        }
+        // Close all client connections
+        for (const client of this.clients) {
+            client.close();
+        }
+        this.clients.clear();
+        // Close server
+        await new Promise((resolve, reject) => {
+            this.wss.close((error) => {
+                if (error)
+                    reject(error);
+                else
+                    resolve();
+            });
+        });
+        this.wss = undefined;
+        console.log('WebSocket server stopped');
+    }
+    /**
+     * Broadcast file change event
+     */
+    broadcastFileChange(event) {
+        const message = {
+            type: 'file_change',
+            timestamp: new Date(),
+            data: { event },
+        };
+        this.broadcast(message);
+    }
+    /**
+     * Broadcast validation result
+     */
+    broadcastValidation(result) {
+        const message = {
+            type: 'validation',
+            timestamp: new Date(),
+            data: { result },
+        };
+        this.broadcast(message);
+    }
+    /**
+     * Broadcast reload request
+     */
+    broadcastReload(filePath, reason) {
+        const message = {
+            type: 'reload',
+            timestamp: new Date(),
+            data: { filePath, reason },
+        };
+        this.broadcast(message);
+    }
+    /**
+     * Broadcast error
+     */
+    broadcastError(errorMessage, details) {
+        const message = {
+            type: 'error',
+            timestamp: new Date(),
+            data: {
+                message: errorMessage,
+                details,
+            },
+        };
+        this.broadcast(message);
+    }
+    /**
+     * Get number of connected clients
+     */
+    getClientCount() {
+        return this.clients.size;
+    }
+    /**
+     * Handle new WebSocket connection
+     */
+    handleConnection(ws) {
+        console.log('New WebSocket client connected');
+        this.clients.add(ws);
+        // Send connection confirmation
+        const message = {
+            type: 'connected',
+            timestamp: new Date(),
+            data: {
+                serverVersion: process.env.npm_package_version || '0.4.1',
+                watchedFiles: [],
+            },
+        };
+        this.sendMessage(ws, message);
+        // Send queued messages
+        for (const queuedMessage of this.messageQueue) {
+            this.sendMessage(ws, queuedMessage);
+        }
+        // Handle messages from client
+        ws.on('message', (data) => {
+            try {
+                const message = JSON.parse(data.toString());
+                this.handleClientMessage(ws, message);
+            }
+            catch (error) {
+                console.error('Error parsing client message:', error);
+            }
+        });
+        // Handle disconnection
+        ws.on('close', () => {
+            console.log('WebSocket client disconnected');
+            this.clients.delete(ws);
+        });
+        // Handle errors
+        ws.on('error', (error) => {
+            console.error('WebSocket client error:', error);
+            this.clients.delete(ws);
+        });
+    }
+    /**
+     * Handle message from client
+     */
+    handleClientMessage(ws, message) {
+        // Echo back for now (can add commands later)
+        console.log('Received message from client:', message);
+    }
+    /**
+     * Broadcast message to all connected clients
+     */
+    broadcast(message) {
+        // Add to queue for new connections
+        this.messageQueue.push(message);
+        if (this.messageQueue.length > this.MAX_QUEUE_SIZE) {
+            this.messageQueue.shift(); // Remove oldest
+        }
+        // Send to all connected clients
+        const json = JSON.stringify(message);
+        const deadClients = [];
+        for (const client of this.clients) {
+            if (client.readyState === WebSocket.OPEN) {
+                try {
+                    client.send(json);
+                }
+                catch (error) {
+                    console.error('Error sending message to client:', error);
+                    deadClients.push(client);
+                }
+            }
+            else {
+                deadClients.push(client);
+            }
+        }
+        // Clean up dead clients
+        for (const client of deadClients) {
+            this.clients.delete(client);
+        }
+    }
+    /**
+     * Send message to specific client
+     */
+    sendMessage(ws, message) {
+        if (ws.readyState === WebSocket.OPEN) {
+            try {
+                ws.send(JSON.stringify(message));
+            }
+            catch (error) {
+                console.error('Error sending message:', error);
+            }
+        }
+    }
+}
+//# sourceMappingURL=websocket-server.js.map