@bluefly/openstandardagents 0.2.9 → 0.3.0

package/dist/services/messaging/example.js

@@ -0,0 +1,260 @@
+/**
+ * OSSA Messaging Runtime - Usage Example
+ * Demonstrates agent-to-agent messaging with pub/sub and commands
+ */
+import { MessagingService, DeliveryGuarantee, MessagePriority } from './index.js';
+/**
+ * Example: Security Scanner and Remediation Agent
+ *
+ * This example shows:
+ * 1. Agent publishes vulnerability findings to a channel
+ * 2. Another agent subscribes to vulnerabilities and processes them
+ * 3. Command (RPC) pattern for requesting remediation actions
+ */
+async function main() {
+    console.log('🚀 OSSA Messaging Runtime Example\n');
+    // ============================================================
+    // Agent 1: Security Scanner
+    // ============================================================
+    const securityScanner = new MessagingService({
+        agentId: 'security-scanner',
+        agentName: 'Security Scanner',
+        messaging: {
+            publishes: [
+                {
+                    channel: 'security.vulnerabilities',
+                    description: 'Security vulnerability findings',
+                    schema: {
+                        type: 'object',
+                        properties: {
+                            severity: {
+                                type: 'string',
+                                enum: ['low', 'medium', 'high', 'critical'],
+                            },
+                            cve: { type: 'string' },
+                            affectedPackage: { type: 'string' },
+                            description: { type: 'string' },
+                        },
+                        required: ['severity', 'cve', 'affectedPackage'],
+                    },
+                },
+                {
+                    channel: 'code.commits',
+                    description: 'Code commit events for testing',
+                    schema: {
+                        type: 'object',
+                        properties: {
+                            repo: { type: 'string' },
+                            commit: { type: 'string' },
+                            author: { type: 'string' },
+                            files: {
+                                type: 'array',
+                                items: { type: 'string' },
+                            },
+                        },
+                    },
+                },
+            ],
+            subscribes: [
+                {
+                    channel: 'code.commits',
+                    description: 'Listen for code commits to scan',
+                    handler: 'scanCommit',
+                    priority: 'high',
+                },
+            ],
+        },
+        enableMetrics: true,
+        enableValidation: true,
+        defaultDeliveryGuarantee: DeliveryGuarantee.AT_LEAST_ONCE,
+    });
+    await securityScanner.start();
+    // Subscribe to code commits
+    await securityScanner.subscribe('code.commits', async (message) => {
+        console.log('🔍 [Security Scanner] Scanning commit:', message.payload);
+        // Simulate vulnerability scanning
+        const commit = message.payload;
+        const vulnerabilities = await simulateScan(commit.files);
+        // Publish findings
+        for (const vuln of vulnerabilities) {
+            await securityScanner.publish('security.vulnerabilities', vuln, {
+                priority: vuln.severity === 'critical'
+                    ? MessagePriority.CRITICAL
+                    : MessagePriority.NORMAL,
+                correlationId: message.id,
+            });
+            console.log(`  ⚠️  Found ${vuln.severity} vulnerability: ${vuln.cve}`);
+        }
+    });
+    console.log('✅ Security Scanner agent started\n');
+    // ============================================================
+    // Agent 2: Remediation Agent
+    // ============================================================
+    const remediationAgent = new MessagingService({
+        agentId: 'remediation-agent',
+        agentName: 'Remediation Agent',
+        messaging: {
+            subscribes: [
+                {
+                    channel: 'security.vulnerabilities',
+                    description: 'Process security vulnerabilities',
+                    handler: 'remediateVulnerability',
+                    priority: 'high',
+                    maxConcurrency: 5,
+                },
+            ],
+            commands: [
+                {
+                    name: 'apply_patch',
+                    description: 'Apply a security patch',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            cve: { type: 'string' },
+                            package: { type: 'string' },
+                        },
+                        required: ['cve', 'package'],
+                    },
+                    outputSchema: {
+                        type: 'object',
+                        properties: {
+                            success: { type: 'boolean' },
+                            patchedVersion: { type: 'string' },
+                        },
+                        required: ['success'],
+                    },
+                },
+            ],
+        },
+    });
+    await remediationAgent.start();
+    // Subscribe to vulnerabilities
+    await remediationAgent.subscribe('security.vulnerabilities', async (message) => {
+        const vuln = message.payload;
+        console.log(`🔧 [Remediation Agent] Processing ${vuln.severity} vulnerability: ${vuln.cve}`);
+        if (vuln.severity === 'critical' || vuln.severity === 'high') {
+            // Auto-remediate critical/high vulnerabilities
+            console.log(`  🚨 Auto-remediating critical vulnerability...`);
+            const result = await simulateRemediation(vuln);
+            console.log(`  ✅ Remediation ${result.success ? 'successful' : 'failed'}`);
+        }
+        else {
+            console.log(`  📋 Created ticket for manual review`);
+        }
+    });
+    // Register command handler
+    await remediationAgent.registerCommandHandler('apply_patch', async (input) => {
+        console.log(`\n🔧 [Remediation Agent] Received command: apply_patch for ${input.cve}`);
+        const result = await simulatePatch(input.package);
+        console.log(`  ✅ Patch applied: ${input.package} → ${result.patchedVersion}`);
+        return result;
+    });
+    console.log('✅ Remediation Agent started\n');
+    // ============================================================
+    // Simulate Events
+    // ============================================================
+    console.log('📡 Simulating events...\n');
+    // Simulate a code commit event
+    await securityScanner.publish('code.commits', {
+        repo: 'myapp',
+        commit: 'abc123',
+        author: 'developer',
+        files: ['package.json', 'src/auth.ts'],
+    });
+    // Wait for async processing
+    await new Promise((resolve) => setTimeout(resolve, 500));
+    // Send a command to remediation agent
+    console.log('\n📤 Sending command to Remediation Agent...');
+    const commandResult = await securityScanner.sendCommand('remediation-agent', 'apply_patch', {
+        cve: 'CVE-2024-9999',
+        package: 'lodash',
+    }, { timeoutSeconds: 5 });
+    console.log('📥 Command response:', commandResult);
+    // ============================================================
+    // Metrics and Health
+    // ============================================================
+    await new Promise((resolve) => setTimeout(resolve, 500));
+    console.log('\n📊 Metrics:\n');
+    const scannerMetrics = securityScanner.getMetrics();
+    console.log('Security Scanner:');
+    console.log('  Published:', scannerMetrics.published);
+    console.log('  Delivered:', scannerMetrics.delivered);
+    console.log('  Failed:', scannerMetrics.failed);
+    console.log('  Avg Latency:', scannerMetrics.avgLatencyMs.toFixed(2), 'ms');
+    const remediationMetrics = remediationAgent.getMetrics();
+    console.log('\nRemediation Agent:');
+    console.log('  Published:', remediationMetrics.published);
+    console.log('  Delivered:', remediationMetrics.delivered);
+    console.log('  Failed:', remediationMetrics.failed);
+    console.log('  Avg Latency:', remediationMetrics.avgLatencyMs.toFixed(2), 'ms');
+    const health = await securityScanner.getHealth();
+    console.log('\n🏥 Broker Health:');
+    console.log('  Status:', health.status);
+    console.log('  Channels:', health.channels);
+    console.log('  Subscriptions:', health.subscriptions);
+    console.log('  Uptime:', (health.uptimeMs / 1000).toFixed(1), 's');
+    const channelStats = await securityScanner.getChannelStats('security.vulnerabilities');
+    console.log('\n📈 Channel Stats (security.vulnerabilities):');
+    console.log('  Published:', channelStats.messagesPublished);
+    console.log('  Consumed:', channelStats.messagesConsumed);
+    console.log('  Pending:', channelStats.messagesPending);
+    console.log('  Subscriptions:', channelStats.subscriptions);
+    // ============================================================
+    // Graceful Shutdown
+    // ============================================================
+    console.log('\n🛑 Shutting down...');
+    await securityScanner.stop();
+    await remediationAgent.stop();
+    console.log('✅ Shutdown complete\n');
+}
+/**
+ * Simulate vulnerability scanning
+ */
+async function simulateScan(files) {
+    // Simulate async scanning
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    if (files.includes('package.json')) {
+        return [
+            {
+                severity: 'high',
+                cve: 'CVE-2024-1234',
+                affectedPackage: 'lodash@4.17.20',
+                description: 'Prototype pollution vulnerability',
+            },
+            {
+                severity: 'low',
+                cve: 'CVE-2024-5678',
+                affectedPackage: 'express@4.17.1',
+                description: 'Outdated dependency',
+            },
+        ];
+    }
+    return [];
+}
+/**
+ * Simulate remediation
+ */
+async function simulateRemediation(vuln) {
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    return {
+        success: true,
+        action: 'updated_dependency',
+        newVersion: '4.18.0',
+    };
+}
+/**
+ * Simulate applying a patch
+ */
+async function simulatePatch(packageName) {
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    return {
+        success: true,
+        patchedVersion: '4.18.0',
+    };
+}
+// Run the example
+main().catch((error) => {
+    console.error('❌ Error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=example.js.map

package/dist/services/messaging/example.js.map

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

package/dist/services/messaging/index.d.ts

@@ -0,0 +1,81 @@
+/**
+ * OSSA Messaging Runtime
+ * Production-quality agent-to-agent messaging
+ *
+ * @fileoverview Pub/sub messaging, routing, and agent coordination
+ * @module @ossa/messaging
+ */
+export { MessagingService } from './messaging.service.js';
+export type { AgentMessagingConfig } from './messaging.service.js';
+export { MemoryBroker } from './memory-broker.js';
+export { MessageEnvelope, PublishedChannel, Subscription, Command, ReliabilityConfig, DeliveryGuarantee, MessagePriority, AcknowledgmentMode, BackoffStrategy, MessageState, Channel, ActiveSubscription, MessageHandler, MessageAcknowledgment, SubscriptionFilter, MessageBroker, SubscriptionOptions, BrokerHealth, ChannelStats, RoutingContext, DeadLetterEntry, MessageMetrics, ValidationResult, } from './messaging.types.js';
+/**
+ * Usage Example:
+ *
+ * ```typescript
+ * import { MessagingService } from '@ossa/messaging';
+ *
+ * // Create messaging service for an agent
+ * const messaging = new MessagingService({
+ *   agentId: 'security-scanner',
+ *   agentName: 'Security Scanner',
+ *   messaging: {
+ *     publishes: [{
+ *       channel: 'security.vulnerabilities',
+ *       schema: {
+ *         type: 'object',
+ *         properties: {
+ *           severity: { type: 'string', enum: ['low', 'medium', 'high', 'critical'] },
+ *           cve: { type: 'string' },
+ *           affectedPackage: { type: 'string' }
+ *         },
+ *         required: ['severity', 'cve', 'affectedPackage']
+ *       }
+ *     }],
+ *     subscribes: [{
+ *       channel: 'code.commits',
+ *       handler: 'handleCommit'
+ *     }]
+ *   }
+ * });
+ *
+ * // Start the service
+ * await messaging.start();
+ *
+ * // Subscribe to a channel
+ * await messaging.subscribe('code.commits', async (message) => {
+ *   console.log('Received commit:', message.payload);
+ *
+ *   // Scan for vulnerabilities
+ *   const vulnerabilities = await scanCommit(message.payload);
+ *
+ *   // Publish findings
+ *   for (const vuln of vulnerabilities) {
+ *     await messaging.publish('security.vulnerabilities', vuln);
+ *   }
+ * });
+ *
+ * // Publish a message
+ * await messaging.publish('security.vulnerabilities', {
+ *   severity: 'high',
+ *   cve: 'CVE-2024-1234',
+ *   affectedPackage: 'lodash@4.17.20'
+ * });
+ *
+ * // Send a command to another agent
+ * const result = await messaging.sendCommand(
+ *   'remediation-agent',
+ *   'apply_patch',
+ *   { cve: 'CVE-2024-1234', package: 'lodash' }
+ * );
+ *
+ * // Get metrics
+ * const metrics = messaging.getMetrics();
+ * console.log('Messages published:', metrics.published);
+ * console.log('Average latency:', metrics.avgLatencyMs, 'ms');
+ *
+ * // Graceful shutdown
+ * await messaging.stop();
+ * ```
+ */
+//# sourceMappingURL=index.d.ts.map

package/dist/services/messaging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/messaging/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAEL,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,iBAAiB,EAGjB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,OAAO,EACP,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAGlB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,YAAY,EAGZ,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG"}

package/dist/services/messaging/index.js

@@ -0,0 +1,85 @@
+/**
+ * OSSA Messaging Runtime
+ * Production-quality agent-to-agent messaging
+ *
+ * @fileoverview Pub/sub messaging, routing, and agent coordination
+ * @module @ossa/messaging
+ */
+// Core service
+export { MessagingService } from './messaging.service.js';
+// Message broker implementations
+export { MemoryBroker } from './memory-broker.js';
+// Types
+export { 
+// Extended types
+DeliveryGuarantee, MessagePriority, AcknowledgmentMode, BackoffStrategy, MessageState, } from './messaging.types.js';
+/**
+ * Usage Example:
+ *
+ * ```typescript
+ * import { MessagingService } from '@ossa/messaging';
+ *
+ * // Create messaging service for an agent
+ * const messaging = new MessagingService({
+ *   agentId: 'security-scanner',
+ *   agentName: 'Security Scanner',
+ *   messaging: {
+ *     publishes: [{
+ *       channel: 'security.vulnerabilities',
+ *       schema: {
+ *         type: 'object',
+ *         properties: {
+ *           severity: { type: 'string', enum: ['low', 'medium', 'high', 'critical'] },
+ *           cve: { type: 'string' },
+ *           affectedPackage: { type: 'string' }
+ *         },
+ *         required: ['severity', 'cve', 'affectedPackage']
+ *       }
+ *     }],
+ *     subscribes: [{
+ *       channel: 'code.commits',
+ *       handler: 'handleCommit'
+ *     }]
+ *   }
+ * });
+ *
+ * // Start the service
+ * await messaging.start();
+ *
+ * // Subscribe to a channel
+ * await messaging.subscribe('code.commits', async (message) => {
+ *   console.log('Received commit:', message.payload);
+ *
+ *   // Scan for vulnerabilities
+ *   const vulnerabilities = await scanCommit(message.payload);
+ *
+ *   // Publish findings
+ *   for (const vuln of vulnerabilities) {
+ *     await messaging.publish('security.vulnerabilities', vuln);
+ *   }
+ * });
+ *
+ * // Publish a message
+ * await messaging.publish('security.vulnerabilities', {
+ *   severity: 'high',
+ *   cve: 'CVE-2024-1234',
+ *   affectedPackage: 'lodash@4.17.20'
+ * });
+ *
+ * // Send a command to another agent
+ * const result = await messaging.sendCommand(
+ *   'remediation-agent',
+ *   'apply_patch',
+ *   { cve: 'CVE-2024-1234', package: 'lodash' }
+ * );
+ *
+ * // Get metrics
+ * const metrics = messaging.getMetrics();
+ * console.log('Messages published:', metrics.published);
+ * console.log('Average latency:', metrics.avgLatencyMs, 'ms');
+ *
+ * // Graceful shutdown
+ * await messaging.stop();
+ * ```
+ */
+//# sourceMappingURL=index.js.map

package/dist/services/messaging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/messaging/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,iCAAiC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,QAAQ;AACR,OAAO;AAQL,iBAAiB;AACjB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,YAAY,GAkBb,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG"}

package/dist/services/messaging/memory-broker.d.ts

@@ -0,0 +1,103 @@
+/**
+ * OSSA Messaging Runtime - In-Memory Message Broker
+ * Production-quality in-memory pub/sub broker for local development and testing
+ *
+ * @fileoverview Simple, fast in-memory message broker with full feature support
+ * @module @ossa/messaging/memory-broker
+ */
+import { MessageBroker, MessageEnvelope, MessageHandler, SubscriptionOptions, BrokerHealth, ChannelStats } from './messaging.types.js';
+/**
+ * In-memory message broker for local development
+ *
+ * Features:
+ * - Pub/sub with wildcard channel matching
+ * - Message queuing with TTL
+ * - Acknowledgment tracking
+ * - Retry with exponential backoff
+ * - Dead letter queue
+ * - Concurrency control
+ * - Message ordering per channel
+ * - Metrics and observability
+ *
+ * Limitations:
+ * - Single process only (no distributed support)
+ * - Messages lost on restart
+ * - Limited to available memory
+ */
+export declare class MemoryBroker implements MessageBroker {
+    private readonly eventBus;
+    private readonly subscriptions;
+    private readonly messageQueues;
+    private readonly deadLetterQueue;
+    private readonly pendingAcks;
+    private readonly channelMetrics;
+    private connected;
+    private readonly startTime;
+    private processingInterval?;
+    /**
+     * Default reliability configuration
+     */
+    private readonly defaultReliability;
+    constructor();
+    /**
+     * Connect to the broker (no-op for in-memory)
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the broker
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Publish a message to a channel
+     */
+    publish(channel: string, message: MessageEnvelope): Promise<void>;
+    /**
+     * Subscribe to a channel
+     */
+    subscribe(channel: string, handler: MessageHandler, options?: SubscriptionOptions): Promise<string>;
+    /**
+     * Unsubscribe from a channel
+     */
+    unsubscribe(subscriptionId: string): Promise<void>;
+    /**
+     * Acknowledge message processing
+     */
+    acknowledge(messageId: string, success: boolean): Promise<void>;
+    /**
+     * Get broker health status
+     */
+    getHealth(): Promise<BrokerHealth>;
+    /**
+     * Get channel statistics
+     */
+    getChannelStats(channel: string): Promise<ChannelStats>;
+    /**
+     * Handle message delivery to subscription
+     */
+    private handleMessage;
+    /**
+     * Process message queue for a channel
+     */
+    private processQueue;
+    /**
+     * Process retry queue for failed messages
+     */
+    private processRetries;
+    /**
+     * Clean up expired messages and acknowledgments
+     */
+    private cleanupExpiredMessages;
+    /**
+     * Handle failed message (retry or dead letter)
+     */
+    private handleFailedMessage;
+    /**
+     * Calculate backoff delay for retry
+     */
+    private calculateBackoff;
+    /**
+     * Create initial channel statistics
+     */
+    private createChannelStats;
+}
+//# sourceMappingURL=memory-broker.d.ts.map

package/dist/services/messaging/memory-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-broker.d.ts","sourceRoot":"","sources":["../../../src/services/messaging/memory-broker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACL,aAAa,EACb,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,YAAY,EAKb,MAAM,sBAAsB,CAAC;AA8B9B;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoC;IAClE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+B;IAC7D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAE3D,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAO;IACjC,OAAO,CAAC,kBAAkB,CAAC,CAAiB;IAE5C;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAejC;;IAaF;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BjC;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCvE;;OAEG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC;IAgDlB;;OAEG;IACG,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCxD;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBrE;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAmBxC;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAQ7D;;OAEG;YACW,aAAa;IAkE3B;;OAEG;YACW,YAAY;IAe1B;;OAEG;YACW,cAAc;IAkB5B;;OAEG;YACW,sBAAsB;IAmCpC;;OAEG;YACW,mBAAmB;IA2BjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAa3B"}