openclaw-protocol-bridge 1.0.0

package/dist/core/types.d.ts

@@ -0,0 +1,257 @@
+/**
+ * Protocol Bridge - Core Type Definitions
+ * The TCP/IP of Agent Standards
+ */
+/**
+ * Supported protocol types
+ */
+export type ProtocolType = 'mcp' | 'a2a' | 'acp' | 'langchain' | 'autogpt' | 'crewai' | 'custom';
+/**
+ * Message types
+ */
+export type MessageType = 'request' | 'response' | 'event' | 'error' | 'heartbeat';
+/**
+ * Routing strategies
+ */
+export type RoutingStrategy = 'capability-based' | 'round-robin' | 'least-loaded' | 'priority' | 'custom';
+/**
+ * Authentication methods
+ */
+export type AuthMethod = 'none' | 'jwt' | 'oauth' | 'apikey' | 'mtls';
+/**
+ * Agent identity
+ */
+export interface AgentIdentity {
+    id: string;
+    protocol: ProtocolType;
+    name?: string;
+    version?: string;
+}
+/**
+ * Agent capabilities
+ */
+export interface AgentCapability {
+    name: string;
+    description?: string;
+    inputSchema?: any;
+    outputSchema?: any;
+    cost?: number;
+    latency?: number;
+}
+/**
+ * Agent registration info
+ */
+export interface AgentInfo extends AgentIdentity {
+    capabilities: AgentCapability[];
+    endpoint: string;
+    transport: 'http' | 'websocket' | 'grpc';
+    metadata?: Record<string, any>;
+    status: 'active' | 'inactive' | 'degraded';
+    lastSeen?: Date;
+}
+/**
+ * Universal message format
+ * All protocols are translated to/from this format
+ */
+export interface UniversalMessage {
+    id: string;
+    timestamp: Date;
+    from: AgentIdentity;
+    to: AgentIdentity;
+    type: MessageType;
+    action: string;
+    payload: any;
+    metadata?: MessageMetadata;
+}
+/**
+ * Message metadata
+ */
+export interface MessageMetadata {
+    correlationId?: string;
+    priority?: 'low' | 'normal' | 'high' | 'critical';
+    timeout?: number;
+    retry?: boolean;
+    maxRetries?: number;
+    ttl?: number;
+    headers?: Record<string, string>;
+    [key: string]: any;
+}
+/**
+ * Message response
+ */
+export interface MessageResponse {
+    messageId: string;
+    status: 'success' | 'error' | 'timeout' | 'rejected';
+    data?: any;
+    error?: {
+        code: string;
+        message: string;
+        details?: any;
+    };
+    metadata?: Record<string, any>;
+}
+/**
+ * Protocol adapter configuration
+ */
+export interface ProtocolConfig {
+    enabled: boolean;
+    version?: string;
+    adapters?: string[];
+    options?: Record<string, any>;
+}
+/**
+ * Bridge configuration
+ */
+export interface BridgeConfig {
+    server?: {
+        port: number;
+        host: string;
+        cors?: {
+            enabled: boolean;
+            origins: string[];
+        };
+    };
+    protocols: {
+        [key in ProtocolType]?: ProtocolConfig;
+    };
+    routing: {
+        strategy: RoutingStrategy;
+        fallback: boolean;
+        timeout: number;
+        retryPolicy?: RetryPolicy;
+    };
+    discovery: {
+        enabled: boolean;
+        interval?: number;
+        ttl?: number;
+    };
+    security: {
+        authentication: AuthMethod;
+        encryption?: {
+            enabled: boolean;
+            algorithm?: string;
+        };
+        allowedOrigins?: string[];
+        jwtSecret?: string;
+        apiKeys?: string[];
+    };
+    monitoring: {
+        metrics: boolean;
+        logging: LogLevel;
+        healthCheck: boolean;
+    };
+}
+/**
+ * Retry policy
+ */
+export interface RetryPolicy {
+    maxRetries: number;
+    initialDelay: number;
+    maxDelay: number;
+    backoffMultiplier: number;
+}
+/**
+ * Log levels
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Discovery query
+ */
+export interface DiscoveryQuery {
+    capabilities?: string[];
+    protocols?: ProtocolType[];
+    maxCost?: number;
+    maxLatency?: number;
+    metadata?: Record<string, any>;
+}
+/**
+ * Metrics data
+ */
+export interface BridgeMetrics {
+    totalMessages: number;
+    successRate: number;
+    averageLatency: number;
+    protocolStats: {
+        [protocol: string]: {
+            sent: number;
+            received: number;
+            errors: number;
+            averageLatency: number;
+        };
+    };
+    agentStats: {
+        registered: number;
+        active: number;
+        inactive: number;
+    };
+    uptime: number;
+}
+/**
+ * Health status
+ */
+export interface HealthStatus {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    uptime: number;
+    protocols: {
+        [protocol: string]: 'active' | 'degraded' | 'inactive';
+    };
+    agents: {
+        registered: number;
+        active: number;
+        inactive: number;
+    };
+    lastCheck: Date;
+}
+/**
+ * Route information
+ */
+export interface RouteInfo {
+    from: AgentIdentity;
+    to: AgentIdentity;
+    via?: AgentIdentity[];
+    strategy: RoutingStrategy;
+    estimatedLatency?: number;
+    cost?: number;
+}
+/**
+ * Translation context
+ */
+export interface TranslationContext {
+    sourceProtocol: ProtocolType;
+    targetProtocol: ProtocolType;
+    message: UniversalMessage;
+    options?: Record<string, any>;
+}
+/**
+ * Middleware function
+ */
+export type MiddlewareFunction = (message: UniversalMessage, next: (message: UniversalMessage) => Promise<MessageResponse>) => Promise<MessageResponse>;
+/**
+ * Event types
+ */
+export type BridgeEvent = 'agent:registered' | 'agent:unregistered' | 'agent:status_changed' | 'message:sent' | 'message:received' | 'message:routed' | 'message:failed' | 'protocol:connected' | 'protocol:disconnected' | 'bridge:started' | 'bridge:stopped';
+/**
+ * Event handler
+ */
+export type EventHandler = (event: BridgeEvent, data: any) => void | Promise<void>;
+/**
+ * Error types
+ */
+export declare class BridgeError extends Error {
+    code: string;
+    details?: any | undefined;
+    constructor(code: string, message: string, details?: any | undefined);
+}
+export declare class ProtocolError extends BridgeError {
+    constructor(protocol: ProtocolType, message: string, details?: any);
+}
+export declare class RoutingError extends BridgeError {
+    constructor(message: string, details?: any);
+}
+export declare class TranslationError extends BridgeError {
+    constructor(message: string, details?: any);
+}
+export declare class AuthenticationError extends BridgeError {
+    constructor(message: string, details?: any);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjG;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,kBAAkB,GAAG,aAAa,GAAG,cAAc,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE1G;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IAC3C,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,aAAa,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,GAAG,CAAC;IACb,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;IACrD,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,GAAG,CAAC;KACf,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE;YACL,OAAO,EAAE,OAAO,CAAC;YACjB,OAAO,EAAE,MAAM,EAAE,CAAC;SACnB,CAAC;KACH,CAAC;IACF,SAAS,EAAE;SACR,GAAG,IAAI,YAAY,CAAC,CAAC,EAAE,cAAc;KACvC,CAAC;IACF,OAAO,EAAE;QACP,QAAQ,EAAE,eAAe,CAAC;QAC1B,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,WAAW,CAAC;KAC3B,CAAC;IACF,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,QAAQ,EAAE;QACR,cAAc,EAAE,UAAU,CAAC;QAC3B,UAAU,CAAC,EAAE;YACX,OAAO,EAAE,OAAO,CAAC;YACjB,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;QACF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,UAAU,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,QAAQ,CAAC;QAClB,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE;QACb,CAAC,QAAQ,EAAE,MAAM,GAAG;YAClB,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC;YACf,cAAc,EAAE,MAAM,CAAC;SACxB,CAAC;KACH,CAAC;IACF,UAAU,EAAE;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE;QACT,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;KACxD,CAAC;IACF,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,aAAa,CAAC;IAClB,GAAG,CAAC,EAAE,aAAa,EAAE,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,YAAY,CAAC;IAC7B,cAAc,EAAE,YAAY,CAAC;IAC7B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,eAAe,CAAC,KAC1D,OAAO,CAAC,eAAe,CAAC,CAAC;AAE9B;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,kBAAkB,GAClB,oBAAoB,GACpB,sBAAsB,GACtB,cAAc,GACd,kBAAkB,GAClB,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB,GACpB,uBAAuB,GACvB,gBAAgB,GAChB,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnF;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAE3B,IAAI,EAAE,MAAM;IAEZ,OAAO,CAAC,EAAE,GAAG;gBAFb,IAAI,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,GAAG,YAAA;CAKvB;AAED,qBAAa,aAAc,SAAQ,WAAW;gBAChC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAInE;AAED,qBAAa,YAAa,SAAQ,WAAW;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED,qBAAa,gBAAiB,SAAQ,WAAW;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C"}

package/dist/core/types.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Protocol Bridge - Core Type Definitions
+ * The TCP/IP of Agent Standards
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthenticationError = exports.TranslationError = exports.RoutingError = exports.ProtocolError = exports.BridgeError = void 0;
+/**
+ * Error types
+ */
+class BridgeError extends Error {
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'BridgeError';
+    }
+}
+exports.BridgeError = BridgeError;
+class ProtocolError extends BridgeError {
+    constructor(protocol, message, details) {
+        super(`PROTOCOL_ERROR_${protocol.toUpperCase()}`, message, details);
+        this.name = 'ProtocolError';
+    }
+}
+exports.ProtocolError = ProtocolError;
+class RoutingError extends BridgeError {
+    constructor(message, details) {
+        super('ROUTING_ERROR', message, details);
+        this.name = 'RoutingError';
+    }
+}
+exports.RoutingError = RoutingError;
+class TranslationError extends BridgeError {
+    constructor(message, details) {
+        super('TRANSLATION_ERROR', message, details);
+        this.name = 'TranslationError';
+    }
+}
+exports.TranslationError = TranslationError;
+class AuthenticationError extends BridgeError {
+    constructor(message, details) {
+        super('AUTH_ERROR', message, details);
+        this.name = 'AuthenticationError';
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA8QH;;GAEG;AACH,MAAa,WAAY,SAAQ,KAAK;IACpC,YACS,IAAY,EACnB,OAAe,EACR,OAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAQ;QAEZ,YAAO,GAAP,OAAO,CAAM;QAGpB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AATD,kCASC;AAED,MAAa,aAAc,SAAQ,WAAW;IAC5C,YAAY,QAAsB,EAAE,OAAe,EAAE,OAAa;QAChE,KAAK,CAAC,kBAAkB,QAAQ,CAAC,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED,MAAa,YAAa,SAAQ,WAAW;IAC3C,YAAY,OAAe,EAAE,OAAa;QACxC,KAAK,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC;AAED,MAAa,gBAAiB,SAAQ,WAAW;IAC/C,YAAY,OAAe,EAAE,OAAa;QACxC,KAAK,CAAC,mBAAmB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AALD,4CAKC;AAED,MAAa,mBAAoB,SAAQ,WAAW;IAClD,YAAY,OAAe,EAAE,OAAa;QACxC,KAAK,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Protocol Bridge - Main Entry Point
+ * The TCP/IP of Agent Standards
+ */
+export { ProtocolBridge } from './core/bridge';
+export { BaseAdapter } from './adapters/base';
+export { MCPAdapter } from './adapters/mcp';
+export { A2AAdapter } from './adapters/a2a';
+export * from './core/types';
+export { ProtocolBridge as default } from './core/bridge';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,cAAc,IAAI,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Protocol Bridge - Main Entry Point
+ * The TCP/IP of Agent Standards
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = exports.A2AAdapter = exports.MCPAdapter = exports.BaseAdapter = exports.ProtocolBridge = void 0;
+var bridge_1 = require("./core/bridge");
+Object.defineProperty(exports, "ProtocolBridge", { enumerable: true, get: function () { return bridge_1.ProtocolBridge; } });
+var base_1 = require("./adapters/base");
+Object.defineProperty(exports, "BaseAdapter", { enumerable: true, get: function () { return base_1.BaseAdapter; } });
+var mcp_1 = require("./adapters/mcp");
+Object.defineProperty(exports, "MCPAdapter", { enumerable: true, get: function () { return mcp_1.MCPAdapter; } });
+var a2a_1 = require("./adapters/a2a");
+Object.defineProperty(exports, "A2AAdapter", { enumerable: true, get: function () { return a2a_1.A2AAdapter; } });
+__exportStar(require("./core/types"), exports);
+// Default export
+var bridge_2 = require("./core/bridge");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return bridge_2.ProtocolBridge; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,wCAA+C;AAAtC,wGAAA,cAAc,OAAA;AACvB,wCAA8C;AAArC,mGAAA,WAAW,OAAA;AACpB,sCAA4C;AAAnC,iGAAA,UAAU,OAAA;AACnB,sCAA4C;AAAnC,iGAAA,UAAU,OAAA;AAEnB,+CAA6B;AAE7B,iBAAiB;AACjB,wCAA0D;AAAjD,iGAAA,cAAc,OAAW"}

package/examples/basic-usage.ts

@@ -0,0 +1,142 @@
+/**
+ * Protocol Bridge - Basic Usage Example
+ */
+
+import { ProtocolBridge, BridgeConfig, AgentInfo } from 'openclaw-protocol-bridge';
+
+async function main() {
+  // 1. Create bridge configuration
+  const config: BridgeConfig = {
+    protocols: {
+      mcp: {
+        enabled: true,
+        version: '2025-11-25',
+      },
+      a2a: {
+        enabled: true,
+        version: '1.0',
+      },
+    },
+    routing: {
+      strategy: 'capability-based',
+      fallback: true,
+      timeout: 30000,
+    },
+    discovery: {
+      enabled: true,
+    },
+    security: {
+      authentication: 'none',
+    },
+    monitoring: {
+      metrics: true,
+      logging: 'info',
+      healthCheck: true,
+    },
+  };
+
+  // 2. Initialize the bridge
+  console.log('Initializing Protocol Bridge...');
+  const bridge = new ProtocolBridge(config);
+  await bridge.initialize();
+
+  // 3. Register an MCP agent
+  console.log('\nRegistering MCP agent...');
+  const mcpAgent: AgentInfo = {
+    id: 'research-agent',
+    protocol: 'mcp',
+    name: 'Research Agent',
+    endpoint: 'http://localhost:3001',
+    transport: 'http',
+    capabilities: [
+      {
+        name: 'search',
+        description: 'Search the web for information',
+      },
+      {
+        name: 'summarize',
+        description: 'Summarize text content',
+      },
+    ],
+    status: 'active',
+  };
+
+  await bridge.registerAgent(mcpAgent);
+  console.log('✓ MCP agent registered');
+
+  // 4. Register an A2A agent
+  console.log('\nRegistering A2A agent...');
+  const a2aAgent: AgentInfo = {
+    id: 'assistant-agent',
+    protocol: 'a2a',
+    name: 'Assistant Agent',
+    endpoint: 'http://localhost:3002',
+    transport: 'http',
+    capabilities: [
+      {
+        name: 'chat',
+        description: 'Conversational AI assistant',
+      },
+      {
+        name: 'task-planning',
+        description: 'Plan and break down complex tasks',
+      },
+    ],
+    status: 'active',
+  };
+
+  await bridge.registerAgent(a2aAgent);
+  console.log('✓ A2A agent registered');
+
+  // 5. Send a message from A2A agent to MCP agent (cross-protocol)
+  console.log('\nSending cross-protocol message (A2A → MCP)...');
+  const result = await bridge.send({
+    from: {
+      id: 'assistant-agent',
+      protocol: 'a2a',
+    },
+    to: {
+      id: 'research-agent',
+      protocol: 'mcp',
+    },
+    action: 'search',
+    params: {
+      query: 'AI agent protocols 2026',
+      maxResults: 5,
+    },
+  });
+
+  console.log('✓ Message sent successfully');
+  console.log('Response:', JSON.stringify(result, null, 2));
+
+  // 6. Discover agents by capability
+  console.log('\nDiscovering agents with "search" capability...');
+  const agents = await bridge.discover({
+    capabilities: ['search'],
+  });
+
+  console.log(`Found ${agents.length} agent(s):`);
+  agents.forEach((agent) => {
+    console.log(`  - ${agent.name} (${agent.protocol})`);
+  });
+
+  // 7. Get bridge metrics
+  console.log('\nBridge Metrics:');
+  const metrics = bridge.getMetrics();
+  console.log(JSON.stringify(metrics, null, 2));
+
+  // 8. Check health
+  console.log('\nHealth Check:');
+  const health = await bridge.getHealth();
+  console.log(JSON.stringify(health, null, 2));
+
+  // 9. Shutdown
+  console.log('\nShutting down bridge...');
+  await bridge.shutdown();
+  console.log('✓ Bridge shut down successfully');
+}
+
+main().catch((error) => {
+  console.error('Error:', error);
+  process.exit(1);
+});

package/examples/middleware-example.ts

@@ -0,0 +1,131 @@
+/**
+ * Protocol Bridge - Middleware Example
+ * Shows how to add middleware for logging, authentication, etc.
+ */
+
+import { ProtocolBridge, BridgeConfig, UniversalMessage, MessageResponse } from 'openclaw-protocol-bridge';
+
+async function main() {
+  const config: BridgeConfig = {
+    protocols: {
+      mcp: { enabled: true },
+      a2a: { enabled: true },
+    },
+    routing: {
+      strategy: 'capability-based',
+      fallback: true,
+      timeout: 30000,
+    },
+    discovery: { enabled: false },
+    security: { authentication: 'none' },
+    monitoring: {
+      metrics: true,
+      logging: 'info',
+      healthCheck: true,
+    },
+  };
+
+  const bridge = new ProtocolBridge(config);
+  await bridge.initialize();
+
+  // Middleware 1: Logging
+  bridge.use(async (message: UniversalMessage, next) => {
+    console.log(`[LOG] Message: ${message.from.id} → ${message.to.id} (${message.action})`);
+    const startTime = Date.now();
+
+    const response = await next(message);
+
+    const latency = Date.now() - startTime;
+    console.log(`[LOG] Response: ${response.status} (${latency}ms)`);
+
+    return response;
+  });
+
+  // Middleware 2: Authentication
+  bridge.use(async (message: UniversalMessage, next) => {
+    // Check if message has auth token
+    const authToken = message.metadata?.headers?.['Authorization'];
+
+    if (!authToken) {
+      console.log('[AUTH] No auth token provided');
+      return {
+        messageId: message.id,
+        status: 'error',
+        error: {
+          code: 'UNAUTHORIZED',
+          message: 'Authentication required',
+        },
+      };
+    }
+
+    console.log('[AUTH] Token validated');
+    return await next(message);
+  });
+
+  // Middleware 3: Rate Limiting
+  const requestCounts = new Map<string, number>();
+
+  bridge.use(async (message: UniversalMessage, next) => {
+    const agentId = message.from.id;
+    const count = requestCounts.get(agentId) || 0;
+
+    if (count >= 10) {
+      console.log(`[RATE LIMIT] Agent ${agentId} exceeded rate limit`);
+      return {
+        messageId: message.id,
+        status: 'error',
+        error: {
+          code: 'RATE_LIMIT_EXCEEDED',
+          message: 'Too many requests',
+        },
+      };
+    }
+
+    requestCounts.set(agentId, count + 1);
+
+    // Reset after 1 minute
+    setTimeout(() => {
+      requestCounts.delete(agentId);
+    }, 60000);
+
+    return await next(message);
+  });
+
+  // Middleware 4: Metrics Collection
+  bridge.use(async (message: UniversalMessage, next) => {
+    const response = await next(message);
+
+    // Add custom metrics
+    if (!response.metadata) {
+      response.metadata = {};
+    }
+
+    response.metadata.processedBy = 'bridge';
+    response.metadata.protocolTranslation = `${message.from.protocol}→${message.to.protocol}`;
+
+    return response;
+  });
+
+  console.log('✓ Middleware configured');
+  console.log('Bridge is ready with 4 middleware layers:');
+  console.log('  1. Logging');
+  console.log('  2. Authentication');
+  console.log('  3. Rate Limiting');
+  console.log('  4. Metrics Collection');
+
+  // Test sending a message
+  try {
+    await bridge.send({
+      from: { id: 'agent-a', protocol: 'mcp' },
+      to: { id: 'agent-b', protocol: 'a2a' },
+      action: 'test',
+      params: {},
+    });
+  } catch (error) {
+    console.error('Expected error (no agents registered):', error);
+  }
+
+  await bridge.shutdown();
+}
+
+main().catch(console.error);