@bluefly/openstandardagents 0.4.3 → 0.4.5

package/dist/adapters/a2a/mcp-transport.js

@@ -0,0 +1,287 @@
+/**
+ * MCP Transport Manager
+ *
+ * Manages MCP client connections using @modelcontextprotocol/sdk
+ * Supports stdio, HTTP (SSE), and WebSocket transports
+ *
+ * @module adapters/a2a/mcp-transport
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
+import { z } from 'zod';
+/**
+ * MCP Transport Type
+ */
+export var MCPTransportType;
+(function (MCPTransportType) {
+    MCPTransportType["STDIO"] = "stdio";
+    MCPTransportType["HTTP"] = "http";
+    MCPTransportType["HTTPS"] = "https";
+    MCPTransportType["WEBSOCKET"] = "ws";
+    MCPTransportType["WEBSOCKET_SECURE"] = "wss";
+})(MCPTransportType || (MCPTransportType = {}));
+/**
+ * MCP Transport Manager
+ * Manages MCP client connections and connection pooling
+ */
+export class MCPTransportManager {
+    clients = new Map();
+    connectionAttempts = new Map();
+    maxRetries = 3;
+    connectionTimeout = 30000; // 30 seconds
+    requestTimeout = 30000; // 30 seconds
+    /**
+     * Get or create MCP client for URI
+     */
+    async getClient(uri) {
+        // Check if client already exists
+        const existingClient = this.clients.get(uri);
+        if (existingClient) {
+            existingClient.lastActivity = new Date();
+            return existingClient;
+        }
+        // Parse URI and create new client
+        const config = this.parseURI(uri);
+        const client = await this.createClient(config);
+        const wrapper = {
+            id: crypto.randomUUID(),
+            client,
+            config,
+            connectedAt: new Date(),
+            lastActivity: new Date(),
+            requestCount: 0,
+        };
+        this.clients.set(uri, wrapper);
+        return wrapper;
+    }
+    /**
+     * Create MCP client based on transport config
+     */
+    async createClient(config) {
+        const timeout = config.timeout || this.connectionTimeout;
+        // Create transport based on type
+        let transport;
+        switch (config.type) {
+            case MCPTransportType.STDIO: {
+                if (!config.command) {
+                    throw new Error('STDIO transport requires command');
+                }
+                transport = new StdioClientTransport({
+                    command: config.command,
+                    args: config.args || [],
+                });
+                break;
+            }
+            case MCPTransportType.HTTP:
+            case MCPTransportType.HTTPS: {
+                if (!config.url) {
+                    throw new Error('HTTP transport requires URL');
+                }
+                transport = new SSEClientTransport(new URL(config.url));
+                break;
+            }
+            case MCPTransportType.WEBSOCKET:
+            case MCPTransportType.WEBSOCKET_SECURE: {
+                throw new Error('WebSocket transport not yet implemented');
+            }
+            default: {
+                throw new Error(`Unsupported transport type: ${config.type}`);
+            }
+        }
+        // Create client
+        const client = new Client({
+            name: 'OSSA A2A Client',
+            version: '0.4.5',
+        }, {
+            capabilities: {
+                roots: { listChanged: false },
+                sampling: {},
+            },
+        });
+        // Connect with timeout
+        try {
+            await this.withTimeout(client.connect(transport), timeout, `Connection timeout after ${timeout}ms`);
+        }
+        catch (error) {
+            throw new Error(`Failed to connect to MCP server: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return client;
+    }
+    /**
+     * Send request to MCP server
+     */
+    async sendRequest(uri, method, params) {
+        const wrapper = await this.getClient(uri);
+        wrapper.requestCount++;
+        wrapper.lastActivity = new Date();
+        const timeout = wrapper.config.requestTimeout || this.requestTimeout;
+        try {
+            // Type assertion for generic MCP SDK requests - runtime behavior is correct
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const requestPromise = wrapper.client.request;
+            const response = await this.withTimeout(requestPromise.call(wrapper.client, { method, params }, z.unknown()), timeout, `Request timeout after ${timeout}ms`);
+            return response;
+        }
+        catch (error) {
+            // Handle connection errors - try to reconnect
+            if (this.isConnectionError(error)) {
+                await this.reconnect(uri);
+                throw new Error(`Connection lost, reconnecting: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Parse URI to extract transport config
+     */
+    parseURI(uri) {
+        try {
+            const url = new URL(uri);
+            switch (url.protocol) {
+                case 'stdio:': {
+                    // stdio://command/path?arg1=val1&arg2=val2
+                    const command = url.hostname;
+                    const args = [];
+                    // Parse query params as command arguments
+                    url.searchParams.forEach((value, key) => {
+                        args.push(`--${key}=${value}`);
+                    });
+                    // Add path segments as positional args
+                    if (url.pathname && url.pathname !== '/') {
+                        args.push(...url.pathname.split('/').filter(Boolean));
+                    }
+                    return {
+                        type: MCPTransportType.STDIO,
+                        command,
+                        args,
+                    };
+                }
+                case 'http:': {
+                    return {
+                        type: MCPTransportType.HTTP,
+                        url: uri,
+                    };
+                }
+                case 'https:': {
+                    return {
+                        type: MCPTransportType.HTTPS,
+                        url: uri,
+                    };
+                }
+                case 'ws:': {
+                    return {
+                        type: MCPTransportType.WEBSOCKET,
+                        url: uri,
+                    };
+                }
+                case 'wss:': {
+                    return {
+                        type: MCPTransportType.WEBSOCKET_SECURE,
+                        url: uri,
+                    };
+                }
+                default: {
+                    throw new Error(`Unsupported protocol: ${url.protocol}`);
+                }
+            }
+        }
+        catch (error) {
+            throw new Error(`Invalid MCP URI: ${uri} - ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Check if error is a connection error
+     */
+    isConnectionError(error) {
+        if (error instanceof Error) {
+            const message = error.message.toLowerCase();
+            return (message.includes('econnrefused') ||
+                message.includes('enotfound') ||
+                message.includes('etimedout') ||
+                message.includes('connection') ||
+                message.includes('disconnect'));
+        }
+        return false;
+    }
+    /**
+     * Reconnect to MCP server
+     */
+    async reconnect(uri) {
+        const attempts = this.connectionAttempts.get(uri) || 0;
+        if (attempts >= this.maxRetries) {
+            this.connectionAttempts.delete(uri);
+            throw new Error(`Max reconnection attempts (${this.maxRetries}) reached for ${uri}`);
+        }
+        // Close existing connection
+        await this.disconnect(uri);
+        // Increment retry counter
+        this.connectionAttempts.set(uri, attempts + 1);
+        // Wait before reconnecting (exponential backoff)
+        const delay = Math.min(1000 * Math.pow(2, attempts), 10000);
+        await new Promise((resolve) => setTimeout(resolve, delay));
+        // Attempt reconnection
+        try {
+            await this.getClient(uri);
+            this.connectionAttempts.delete(uri);
+        }
+        catch (error) {
+            throw new Error(`Reconnection failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Disconnect from MCP server
+     */
+    async disconnect(uri) {
+        const wrapper = this.clients.get(uri);
+        if (!wrapper) {
+            return;
+        }
+        try {
+            await wrapper.client.close();
+        }
+        catch (error) {
+            console.error(`Error closing MCP connection to ${uri}:`, error instanceof Error ? error.message : String(error));
+        }
+        this.clients.delete(uri);
+    }
+    /**
+     * Disconnect all clients
+     */
+    async disconnectAll() {
+        const disconnectPromises = Array.from(this.clients.keys()).map((uri) => this.disconnect(uri));
+        await Promise.all(disconnectPromises);
+    }
+    /**
+     * Get active connections
+     */
+    getConnections() {
+        return Array.from(this.clients.values());
+    }
+    /**
+     * Get connection stats
+     */
+    getStats() {
+        const connections = Array.from(this.clients.entries()).map(([uri, wrapper]) => ({
+            uri,
+            connectedAt: wrapper.connectedAt,
+            requestCount: wrapper.requestCount,
+            lastActivity: wrapper.lastActivity,
+        }));
+        return {
+            totalConnections: this.clients.size,
+            totalRequests: connections.reduce((sum, conn) => sum + conn.requestCount, 0),
+            connections,
+        };
+    }
+    /**
+     * Helper to wrap promise with timeout
+     */
+    withTimeout(promise, timeoutMs, errorMessage) {
+        return Promise.race([
+            promise,
+            new Promise((_, reject) => setTimeout(() => reject(new Error(errorMessage)), timeoutMs)),
+        ]);
+    }
+}
+//# sourceMappingURL=mcp-transport.js.map

package/dist/adapters/a2a/mcp-transport.js.map

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

package/dist/adapters/a2a/swarm-orchestration.d.ts

@@ -0,0 +1,278 @@
+/**
+ * Swarm Intelligence Orchestration
+ *
+ * Multi-agent swarm coordination for complex task decomposition
+ * and distributed execution
+ *
+ * @module adapters/a2a/swarm-orchestration
+ */
+import type { AgentIdentity, MessagePriority } from './a2a-protocol.js';
+/**
+ * Complex Task Definition
+ */
+export interface ComplexTask {
+    /** Task ID */
+    id: string;
+    /** Task name */
+    name: string;
+    /** Task description */
+    description: string;
+    /** Task requirements */
+    requirements: TaskRequirements;
+    /** Task constraints */
+    constraints: TaskConstraints;
+    /** Task priority */
+    priority: MessagePriority;
+    /** Task deadline (ISO 8601) */
+    deadline?: string;
+    /** Task metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Task Requirements
+ */
+export interface TaskRequirements {
+    /** Required capabilities */
+    capabilities: string[];
+    /** Minimum number of agents */
+    minAgents?: number;
+    /** Maximum number of agents */
+    maxAgents?: number;
+    /** Required resources */
+    resources?: {
+        /** CPU cores */
+        cpu?: number;
+        /** Memory in MB */
+        memory?: number;
+        /** Disk space in MB */
+        disk?: number;
+        /** GPU required */
+        gpu?: boolean;
+    };
+}
+/**
+ * Task Constraints
+ */
+export interface TaskConstraints {
+    /** Maximum execution time (milliseconds) */
+    maxExecutionTime?: number;
+    /** Maximum cost (arbitrary units) */
+    maxCost?: number;
+    /** Required SLA (0-1) */
+    requiredSLA?: number;
+    /** Affinity rules (must co-locate) */
+    affinity?: string[];
+    /** Anti-affinity rules (must not co-locate) */
+    antiAffinity?: string[];
+}
+/**
+ * Agent Task (Subtask)
+ */
+export interface AgentTask {
+    /** Task ID */
+    id: string;
+    /** Parent task ID */
+    parentId: string;
+    /** Task name */
+    name: string;
+    /** Task description */
+    description: string;
+    /** Required capabilities */
+    capabilities: string[];
+    /** Task input data */
+    input: unknown;
+    /** Expected output schema */
+    outputSchema?: Record<string, unknown>;
+    /** Task dependencies (must complete first) */
+    dependencies: string[];
+    /** Estimated execution time (milliseconds) */
+    estimatedDuration: number;
+    /** Task priority */
+    priority: MessagePriority;
+}
+/**
+ * Agent (for task assignment)
+ */
+export interface Agent {
+    /** Agent identity */
+    identity: AgentIdentity;
+    /** Agent capabilities */
+    capabilities: string[];
+    /** Current load (0-1) */
+    load: number;
+    /** Available capacity (0-1) */
+    capacity: number;
+    /** Agent status */
+    status: 'available' | 'busy' | 'offline';
+    /** Performance metrics */
+    metrics: {
+        /** Average task completion time (milliseconds) */
+        avgCompletionTime: number;
+        /** Success rate (0-1) */
+        successRate: number;
+        /** Total tasks completed */
+        tasksCompleted: number;
+    };
+}
+/**
+ * Task Assignment
+ */
+export interface TaskAssignment {
+    /** Task ID */
+    taskId: string;
+    /** Assigned agent */
+    agent: Agent;
+    /** Assignment timestamp */
+    assignedAt: string;
+    /** Expected completion time */
+    expectedCompletion: string;
+    /** Assignment score (0-1, higher is better) */
+    score: number;
+}
+/**
+ * Proposal (for consensus)
+ */
+export interface Proposal {
+    /** Proposal ID */
+    id: string;
+    /** Proposer agent */
+    proposer: AgentIdentity;
+    /** Proposal type */
+    type: 'task-assignment' | 'resource-allocation' | 'strategy-change';
+    /** Proposal data */
+    data: unknown;
+    /** Votes received */
+    votes: Vote[];
+    /** Proposal status */
+    status: 'pending' | 'accepted' | 'rejected';
+    /** Created timestamp */
+    createdAt: string;
+}
+/**
+ * Vote
+ */
+export interface Vote {
+    /** Voter agent */
+    voter: AgentIdentity;
+    /** Vote value */
+    value: 'approve' | 'reject' | 'abstain';
+    /** Vote weight (for weighted voting) */
+    weight?: number;
+    /** Vote reasoning */
+    reasoning?: string;
+    /** Vote timestamp */
+    votedAt: string;
+}
+/**
+ * Consensus Result
+ */
+export interface ConsensusResult {
+    /** Proposal ID */
+    proposalId: string;
+    /** Consensus reached */
+    reached: boolean;
+    /** Final decision */
+    decision: 'accepted' | 'rejected';
+    /** Vote summary */
+    votes: {
+        approve: number;
+        reject: number;
+        abstain: number;
+    };
+    /** Participating agents */
+    participants: AgentIdentity[];
+    /** Consensus timestamp */
+    timestamp: string;
+}
+/**
+ * Swarm Metrics
+ */
+export interface SwarmMetrics {
+    /** Total agents in swarm */
+    totalAgents: number;
+    /** Active agents */
+    activeAgents: number;
+    /** Average load across swarm (0-1) */
+    avgLoad: number;
+    /** Total tasks in progress */
+    tasksInProgress: number;
+    /** Total tasks completed */
+    tasksCompleted: number;
+    /** Average task completion time (milliseconds) */
+    avgCompletionTime: number;
+    /** Success rate (0-1) */
+    successRate: number;
+    /** Timestamp */
+    timestamp: string;
+}
+/**
+ * Swarm Configuration
+ */
+export interface SwarmConfiguration {
+    /** Maximum swarm size */
+    maxSize: number;
+    /** Minimum swarm size */
+    minSize: number;
+    /** Auto-scaling enabled */
+    autoScaling: boolean;
+    /** Load threshold for scaling up (0-1) */
+    scaleUpThreshold: number;
+    /** Load threshold for scaling down (0-1) */
+    scaleDownThreshold: number;
+    /** Task queue size limit */
+    maxQueueSize: number;
+    /** Coordination strategy */
+    coordinationStrategy: 'centralized' | 'decentralized' | 'hybrid';
+}
+/**
+ * Swarm Orchestrator
+ * Coordinates multi-agent swarms for complex task execution
+ */
+export declare class SwarmOrchestrator {
+    private agents;
+    private tasks;
+    private assignments;
+    private config;
+    constructor(config?: Partial<SwarmConfiguration>);
+    /**
+     * Decompose complex task into agent subtasks
+     */
+    decomposeTask(task: ComplexTask): AgentTask[];
+    /**
+     * Load balance tasks across agent pool
+     */
+    balanceLoad(tasks: AgentTask[], agents: Agent[]): TaskAssignment[];
+    /**
+     * Build consensus among agents
+     */
+    buildConsensus(proposals: Proposal[]): Promise<ConsensusResult[]>;
+    /**
+     * Adapt swarm based on metrics
+     */
+    adaptSwarm(metrics: SwarmMetrics): SwarmConfiguration;
+    /**
+     * Register agent in swarm
+     */
+    registerAgent(agent: Agent): void;
+    /**
+     * Unregister agent from swarm
+     */
+    unregisterAgent(agentId: string): void;
+    /**
+     * Get swarm metrics
+     */
+    getMetrics(): SwarmMetrics;
+    private analyzeComplexity;
+    private selectDecompositionStrategy;
+    private decomposeSequential;
+    private decomposeParallel;
+    private decomposeHierarchical;
+    private decomposePipeline;
+    private findSuitableAgents;
+    private selectBestAgent;
+    private calculateAssignmentScore;
+    private calculateExpectedCompletion;
+    private processProposal;
+    private priorityToNumber;
+}
+//# sourceMappingURL=swarm-orchestration.d.ts.map

package/dist/adapters/a2a/swarm-orchestration.d.ts.map

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