@bluefly/openstandardagents 0.2.9 → 0.3.1

package/dist/mesh/discovery.js

@@ -0,0 +1,288 @@
+/**
+ * Agent Mesh - Service Discovery
+ * Implements agent discovery through registry-based, broadcast, and multicast mechanisms
+ */
+/**
+ * In-Memory Agent Registry Implementation
+ */
+export class InMemoryAgentRegistry {
+    cleanupIntervalMs;
+    agents = new Map();
+    cleanupInterval = null;
+    constructor(cleanupIntervalMs = 60000) {
+        this.cleanupIntervalMs = cleanupIntervalMs;
+        this.startCleanup();
+    }
+    async register(agentCard, ttl = 60) {
+        this.agents.set(agentCard.uri, {
+            card: {
+                ...agentCard,
+                lastHeartbeat: new Date().toISOString(),
+                status: 'healthy',
+            },
+            lastHeartbeat: new Date(),
+            ttl,
+        });
+    }
+    async unregister(agentUri) {
+        this.agents.delete(agentUri);
+    }
+    async heartbeat(agentUri) {
+        const entry = this.agents.get(agentUri);
+        if (entry) {
+            entry.lastHeartbeat = new Date();
+            entry.card.lastHeartbeat = new Date().toISOString();
+            entry.card.status = 'healthy';
+        }
+    }
+    async findByCapability(capability) {
+        const agents = [];
+        for (const entry of this.agents.values()) {
+            if (entry.card.capabilities.includes(capability) && this.isHealthy(entry)) {
+                agents.push(entry.card);
+            }
+        }
+        return agents;
+    }
+    async findByUri(uri) {
+        const entry = this.agents.get(uri);
+        return entry ? entry.card : null;
+    }
+    async listAll() {
+        return Array.from(this.agents.values()).map((entry) => entry.card);
+    }
+    async findHealthy() {
+        const agents = [];
+        for (const entry of this.agents.values()) {
+            if (this.isHealthy(entry)) {
+                agents.push(entry.card);
+            }
+        }
+        return agents;
+    }
+    isHealthy(entry) {
+        const now = new Date();
+        const elapsedSeconds = (now.getTime() - entry.lastHeartbeat.getTime()) / 1000;
+        return elapsedSeconds <= entry.ttl;
+    }
+    startCleanup() {
+        this.cleanupInterval = setInterval(() => {
+            const now = new Date();
+            for (const [uri, entry] of this.agents.entries()) {
+                const elapsedSeconds = (now.getTime() - entry.lastHeartbeat.getTime()) / 1000;
+                if (elapsedSeconds > entry.ttl) {
+                    entry.card.status = 'unavailable';
+                    // Remove after 2x TTL
+                    if (elapsedSeconds > entry.ttl * 2) {
+                        this.agents.delete(uri);
+                    }
+                }
+                else if (elapsedSeconds > entry.ttl * 0.8) {
+                    entry.card.status = 'degraded';
+                }
+            }
+        }, this.cleanupIntervalMs);
+    }
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        this.agents.clear();
+    }
+}
+/**
+ * Discovery Service
+ * Provides agent discovery across multiple discovery methods
+ */
+export class DiscoveryService {
+    registry;
+    localAgent;
+    heartbeatInterval;
+    constructor(registry) {
+        this.registry = registry || new InMemoryAgentRegistry();
+    }
+    /**
+     * Register this agent with the discovery service
+     */
+    async registerSelf(agentCard, heartbeatIntervalMs = 30000) {
+        this.localAgent = agentCard;
+        await this.registry.register(agentCard);
+        // Start automatic heartbeat
+        this.heartbeatInterval = setInterval(async () => {
+            if (this.localAgent) {
+                await this.registry.heartbeat(this.localAgent.uri);
+            }
+        }, heartbeatIntervalMs);
+    }
+    /**
+     * Unregister this agent from the discovery service
+     */
+    async unregisterSelf() {
+        if (this.localAgent) {
+            await this.registry.unregister(this.localAgent.uri);
+            this.localAgent = undefined;
+        }
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = undefined;
+        }
+    }
+    /**
+     * Discover agents by capability
+     */
+    async discoverByCapability(capability) {
+        return await this.registry.findByCapability(capability);
+    }
+    /**
+     * Discover agent by URI
+     */
+    async discoverByUri(uri) {
+        return await this.registry.findByUri(uri);
+    }
+    /**
+     * List all registered agents
+     */
+    async listAgents() {
+        return await this.registry.listAll();
+    }
+    /**
+     * Find healthy agents only
+     */
+    async findHealthyAgents() {
+        return await this.registry.findHealthy();
+    }
+    /**
+     * Check if an agent is available
+     */
+    async isAgentAvailable(uri) {
+        const agent = await this.registry.findByUri(uri);
+        return agent !== null && agent.status === 'healthy';
+    }
+    /**
+     * Get the local agent card
+     */
+    getLocalAgent() {
+        return this.localAgent;
+    }
+    /**
+     * Destroy the discovery service
+     */
+    destroy() {
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+        }
+        if (this.registry instanceof InMemoryAgentRegistry) {
+            this.registry.destroy();
+        }
+    }
+}
+/**
+ * Agent URI Parser
+ * Utility for parsing and validating agent URIs
+ */
+export class AgentUriParser {
+    static URI_PATTERN = /^agent:\/\/([a-z0-9-]+)\/([a-z0-9-]+)$/;
+    /**
+     * Parse an agent URI into namespace and name
+     */
+    static parse(uri) {
+        const match = uri.match(this.URI_PATTERN);
+        if (!match) {
+            return null;
+        }
+        return {
+            namespace: match[1],
+            name: match[2],
+        };
+    }
+    /**
+     * Build an agent URI from namespace and name
+     */
+    static build(namespace, name) {
+        return `agent://${namespace}/${name}`;
+    }
+    /**
+     * Validate an agent URI
+     */
+    static isValid(uri) {
+        return this.URI_PATTERN.test(uri);
+    }
+    /**
+     * Extract namespace from URI
+     */
+    static getNamespace(uri) {
+        const parsed = this.parse(uri);
+        return parsed ? parsed.namespace : null;
+    }
+    /**
+     * Extract name from URI
+     */
+    static getName(uri) {
+        const parsed = this.parse(uri);
+        return parsed ? parsed.name : null;
+    }
+}
+/**
+ * Topic URI Parser
+ * Utility for parsing and validating topic URIs
+ */
+export class TopicUriParser {
+    static TOPIC_PATTERN = /^topic:\/\/([a-z0-9.-]+)$/;
+    static BROADCAST_PATTERN = /^broadcast:\/\/([a-z0-9-]+)\/\*$/;
+    /**
+     * Parse a topic URI
+     */
+    static parseTopic(uri) {
+        const match = uri.match(this.TOPIC_PATTERN);
+        return match ? match[1] : null;
+    }
+    /**
+     * Parse a broadcast URI
+     */
+    static parseBroadcast(uri) {
+        const match = uri.match(this.BROADCAST_PATTERN);
+        return match ? match[1] : null;
+    }
+    /**
+     * Check if URI is a topic
+     */
+    static isTopic(uri) {
+        return this.TOPIC_PATTERN.test(uri);
+    }
+    /**
+     * Check if URI is a broadcast
+     */
+    static isBroadcast(uri) {
+        return this.BROADCAST_PATTERN.test(uri);
+    }
+    /**
+     * Build a topic URI
+     */
+    static buildTopic(topic) {
+        return `topic://${topic}`;
+    }
+    /**
+     * Build a broadcast URI
+     */
+    static buildBroadcast(namespace) {
+        return `broadcast://${namespace}/*`;
+    }
+    /**
+     * Check if a channel matches a subscription pattern
+     * Supports wildcards (e.g., security.* matches security.vulnerabilities)
+     */
+    static matchesPattern(channel, pattern) {
+        if (pattern === channel) {
+            return true;
+        }
+        // Convert pattern to regex
+        const regexPattern = pattern
+            .split('.')
+            .map((part) => (part === '*' ? '[^.]+' : part))
+            .join('\\.');
+        const regex = new RegExp(`^${regexPattern}$`);
+        return regex.test(channel);
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/mesh/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/mesh/discovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkDH;;GAEG;AACH,MAAM,OAAO,qBAAqB;IAIH;IAHrB,MAAM,GAAuE,IAAI,GAAG,EAAE,CAAC;IACvF,eAAe,GAA0B,IAAI,CAAC;IAEtD,YAA6B,oBAA4B,KAAK;QAAjC,sBAAiB,GAAjB,iBAAiB,CAAgB;QAC5D,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAoB,EAAE,MAAc,EAAE;QACnD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YAC7B,IAAI,EAAE;gBACJ,GAAG,SAAS;gBACZ,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACvC,MAAM,EAAE,SAAS;aAClB;YACD,aAAa,EAAE,IAAI,IAAI,EAAE;YACzB,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAgB;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,aAAa,GAAG,IAAI,IAAI,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QAChC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAkB;QACvC,MAAM,MAAM,GAAgB,EAAE,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1E,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,MAAM,GAAgB,EAAE,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,SAAS,CAAC,KAA4D;QAC5E,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;QAC9E,OAAO,cAAc,IAAI,KAAK,CAAC,GAAG,CAAC;IACrC,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;YACtC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;gBACjD,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;gBAC9E,IAAI,cAAc,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;oBAC/B,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC;oBAClC,sBAAsB;oBACtB,IAAI,cAAc,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;wBACnC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBAC1B,CAAC;gBACH,CAAC;qBAAM,IAAI,cAAc,GAAG,KAAK,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC;oBAC5C,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;gBACjC,CAAC;YACH,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACpC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACnB,QAAQ,CAAgB;IACxB,UAAU,CAAa;IACvB,iBAAiB,CAAkB;IAE3C,YAAY,QAAwB;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,IAAI,qBAAqB,EAAE,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,SAAoB,EAAE,sBAA8B,KAAK;QAC1E,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAExC,4BAA4B;QAC5B,IAAI,CAAC,iBAAiB,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9C,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACrD,CAAC;QACH,CAAC,EAAE,mBAAmB,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc;QAClB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACpD,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC9B,CAAC;QAED,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,aAAa,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YACtC,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;QACrC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CAAC,UAAkB;QAC3C,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,GAAW;QAC7B,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB;QACrB,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,GAAW;QAChC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACjD,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,aAAa,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,YAAY,qBAAqB,EAAE,CAAC;YACnD,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,cAAc;IACjB,MAAM,CAAU,WAAW,GAAG,wCAAwC,CAAC;IAE/E;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,GAAW;QACtB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;YACnB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;SACf,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,SAAiB,EAAE,IAAY;QAC1C,OAAO,WAAW,SAAS,IAAI,IAAI,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,GAAW;QACxB,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,GAAW;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,GAAW;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACrC,CAAC;;AAGH;;;GAGG;AACH,MAAM,OAAO,cAAc;IACjB,MAAM,CAAU,aAAa,GAAG,2BAA2B,CAAC;IAC5D,MAAM,CAAU,iBAAiB,GAAG,kCAAkC,CAAC;IAE/E;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAW;QAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,GAAW;QAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAChD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,GAAW;QACxB,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,GAAW;QAC5B,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,KAAa;QAC7B,OAAO,WAAW,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,SAAiB;QACrC,OAAO,eAAe,SAAS,IAAI,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,OAAe,EAAE,OAAe;QACpD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,2BAA2B;QAC3B,MAAM,YAAY,GAAG,OAAO;aACzB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aAC9C,IAAI,CAAC,KAAK,CAAC,CAAC;QAEf,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC"}

package/dist/mesh/index.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Agent Mesh Communication Layer
+ *
+ * A complete implementation of the OSSA Agent-to-Agent (A2A) protocol for inter-agent communication.
+ *
+ * Features:
+ * - Service discovery (registry-based, broadcast, multicast)
+ * - Message routing (direct, broadcast, topic-based, request/response)
+ * - Multiple transport mechanisms (HTTP, gRPC, WebSocket, MQTT)
+ * - Reliability patterns (retry, circuit breaker, dead letter queue)
+ * - Observability (tracing, metrics, logging)
+ * - Security (mTLS, bearer tokens, OIDC)
+ *
+ * @example
+ * ```typescript
+ * import { AgentMeshClientBuilder, DiscoveryService, InMemoryAgentRegistry } from '@bluefly/openstandardagents/mesh';
+ *
+ * // Create discovery service
+ * const registry = new InMemoryAgentRegistry();
+ * const discovery = new DiscoveryService(registry);
+ *
+ * // Define local agent
+ * const localAgent = {
+ *   uri: 'agent://team-a/my-agent',
+ *   name: 'My Agent',
+ *   version: '1.0.0',
+ *   ossaVersion: '0.3.0',
+ *   capabilities: ['task-execution', 'data-processing'],
+ *   endpoints: { http: 'http://localhost:8080' },
+ *   transport: ['http'],
+ *   authentication: ['bearer'],
+ *   encryption: { tlsRequired: true, minTlsVersion: '1.3' },
+ * };
+ *
+ * // Register agent
+ * await discovery.registerSelf(localAgent);
+ *
+ * // Create mesh client
+ * const client = new AgentMeshClientBuilder()
+ *   .withLocalAgent(localAgent)
+ *   .withDiscovery(discovery)
+ *   .enableStats()
+ *   .build();
+ *
+ * // Subscribe to events
+ * client.subscribe(
+ *   {
+ *     channel: 'security.vulnerabilities',
+ *     handler: 'handleVulnerability',
+ *   },
+ *   async (message) => {
+ *     console.log('Received vulnerability:', message.payload);
+ *   }
+ * );
+ *
+ * // Publish events
+ * await client.publish('security.vulnerabilities', {
+ *   vulnerability_id: 'vuln-123',
+ *   severity: 'critical',
+ *   cve_id: 'CVE-2024-1234',
+ * });
+ *
+ * // Request/response
+ * const response = await client.request(
+ *   'agent://team-b/analyzer',
+ *   { action: 'analyze', data: 'sample' }
+ * );
+ *
+ * // Register commands
+ * client.registerCommand(
+ *   {
+ *     name: 'scan_package',
+ *     inputSchema: { type: 'object', properties: { package: { type: 'string' } } },
+ *   },
+ *   async (input) => {
+ *     // Perform scan
+ *     return { vulnerabilities: [], status: 'success' };
+ *   }
+ * );
+ * ```
+ *
+ * @packageDocumentation
+ */
+export * from './types.js';
+export { AgentRegistry, InMemoryAgentRegistry, DiscoveryService, AgentUriParser, TopicUriParser, type DiscoveryMethod, } from './discovery.js';
+export { MessageRouter, SubscriptionManager, DefaultMessageRouter, DefaultSubscriptionManager, MessagePriorityQueue, MessageFilter, MessageTransform, RoutingStatsCollector, type RoutingStats, } from './routing.js';
+export { Transport, HttpTransport, AgentMeshClient, AgentMeshClientBuilder, type AgentMeshClientConfig, } from './client.js';
+export type { MessageEnvelope, AgentCard, MessageType, MessagePriority, TaskState, A2AErrorCode, MessageHandler, CommandHandler, Subscription, Command, PublishedChannel, RoutingRule, MessagingExtension, AgentMeshConfig, ReliabilityConfig, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mesh/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mesh/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkFG;AAGH,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,SAAS,EACT,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,eAAe,EACf,SAAS,EACT,WAAW,EACX,eAAe,EACf,SAAS,EACT,YAAY,EACZ,cAAc,EACd,cAAc,EACd,YAAY,EACZ,OAAO,EACP,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/mesh/index.js

@@ -0,0 +1,92 @@
+/**
+ * Agent Mesh Communication Layer
+ *
+ * A complete implementation of the OSSA Agent-to-Agent (A2A) protocol for inter-agent communication.
+ *
+ * Features:
+ * - Service discovery (registry-based, broadcast, multicast)
+ * - Message routing (direct, broadcast, topic-based, request/response)
+ * - Multiple transport mechanisms (HTTP, gRPC, WebSocket, MQTT)
+ * - Reliability patterns (retry, circuit breaker, dead letter queue)
+ * - Observability (tracing, metrics, logging)
+ * - Security (mTLS, bearer tokens, OIDC)
+ *
+ * @example
+ * ```typescript
+ * import { AgentMeshClientBuilder, DiscoveryService, InMemoryAgentRegistry } from '@bluefly/openstandardagents/mesh';
+ *
+ * // Create discovery service
+ * const registry = new InMemoryAgentRegistry();
+ * const discovery = new DiscoveryService(registry);
+ *
+ * // Define local agent
+ * const localAgent = {
+ *   uri: 'agent://team-a/my-agent',
+ *   name: 'My Agent',
+ *   version: '1.0.0',
+ *   ossaVersion: '0.3.0',
+ *   capabilities: ['task-execution', 'data-processing'],
+ *   endpoints: { http: 'http://localhost:8080' },
+ *   transport: ['http'],
+ *   authentication: ['bearer'],
+ *   encryption: { tlsRequired: true, minTlsVersion: '1.3' },
+ * };
+ *
+ * // Register agent
+ * await discovery.registerSelf(localAgent);
+ *
+ * // Create mesh client
+ * const client = new AgentMeshClientBuilder()
+ *   .withLocalAgent(localAgent)
+ *   .withDiscovery(discovery)
+ *   .enableStats()
+ *   .build();
+ *
+ * // Subscribe to events
+ * client.subscribe(
+ *   {
+ *     channel: 'security.vulnerabilities',
+ *     handler: 'handleVulnerability',
+ *   },
+ *   async (message) => {
+ *     console.log('Received vulnerability:', message.payload);
+ *   }
+ * );
+ *
+ * // Publish events
+ * await client.publish('security.vulnerabilities', {
+ *   vulnerability_id: 'vuln-123',
+ *   severity: 'critical',
+ *   cve_id: 'CVE-2024-1234',
+ * });
+ *
+ * // Request/response
+ * const response = await client.request(
+ *   'agent://team-b/analyzer',
+ *   { action: 'analyze', data: 'sample' }
+ * );
+ *
+ * // Register commands
+ * client.registerCommand(
+ *   {
+ *     name: 'scan_package',
+ *     inputSchema: { type: 'object', properties: { package: { type: 'string' } } },
+ *   },
+ *   async (input) => {
+ *     // Perform scan
+ *     return { vulnerabilities: [], status: 'success' };
+ *   }
+ * );
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Types
+export * from './types.js';
+// Discovery
+export { InMemoryAgentRegistry, DiscoveryService, AgentUriParser, TopicUriParser, } from './discovery.js';
+// Routing
+export { DefaultMessageRouter, DefaultSubscriptionManager, MessagePriorityQueue, MessageFilter, MessageTransform, RoutingStatsCollector, } from './routing.js';
+// Client
+export { HttpTransport, AgentMeshClient, AgentMeshClientBuilder, } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/mesh/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mesh/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkFG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,YAAY;AACZ,OAAO,EAEL,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,cAAc,GAEf,MAAM,gBAAgB,CAAC;AAExB,UAAU;AACV,OAAO,EAGL,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,GAEtB,MAAM,cAAc,CAAC;AAEtB,SAAS;AACT,OAAO,EAEL,aAAa,EACb,eAAe,EACf,sBAAsB,GAEvB,MAAM,aAAa,CAAC"}

package/dist/mesh/routing.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Agent Mesh - Message Routing
+ * Implements direct, broadcast, topic-based, and request/response routing patterns
+ */
+import { MessageEnvelope, MessageHandler, RoutingRule, MessagePriority, Subscription } from './types.js';
+/**
+ * Message Router Interface
+ */
+export interface MessageRouter {
+    /**
+     * Route a message to its destination(s)
+     */
+    route(message: MessageEnvelope): Promise<string[]>;
+    /**
+     * Add a routing rule
+     */
+    addRule(rule: RoutingRule): void;
+    /**
+     * Remove a routing rule
+     */
+    removeRule(ruleId: string): void;
+    /**
+     * Get all routing rules
+     */
+    getRules(): RoutingRule[];
+}
+/**
+ * Subscription Manager Interface
+ */
+export interface SubscriptionManager {
+    /**
+     * Subscribe to a channel
+     */
+    subscribe(subscription: Subscription, handler: MessageHandler): void;
+    /**
+     * Unsubscribe from a channel
+     */
+    unsubscribe(channel: string, handler: MessageHandler): void;
+    /**
+     * Get handlers for a channel
+     */
+    getHandlers(channel: string): MessageHandler[];
+    /**
+     * Check if there are any subscribers for a channel
+     */
+    hasSubscribers(channel: string): boolean;
+}
+/**
+ * Message Filter
+ * Evaluates whether a message matches filter criteria
+ */
+export declare class MessageFilter {
+    /**
+     * Check if message matches filter
+     */
+    static matches(message: MessageEnvelope, filter?: {
+        expression?: string;
+        fields?: Record<string, unknown>;
+    }): boolean;
+    private static getNestedValue;
+    private static evaluateExpression;
+}
+/**
+ * Default Message Router Implementation
+ */
+export declare class DefaultMessageRouter implements MessageRouter {
+    private rules;
+    route(message: MessageEnvelope): Promise<string[]>;
+    addRule(rule: RoutingRule): void;
+    removeRule(ruleId: string): void;
+    getRules(): RoutingRule[];
+    private generateRuleId;
+}
+/**
+ * Default Subscription Manager Implementation
+ */
+export declare class DefaultSubscriptionManager implements SubscriptionManager {
+    private subscriptions;
+    subscribe(subscription: Subscription, handler: MessageHandler): void;
+    unsubscribe(channel: string, handler: MessageHandler): void;
+    getHandlers(channel: string): MessageHandler[];
+    hasSubscribers(channel: string): boolean;
+    /**
+     * Get all subscriptions
+     */
+    getAllSubscriptions(): Subscription[];
+    /**
+     * Clear all subscriptions
+     */
+    clear(): void;
+}
+/**
+ * Priority Queue for Message Processing
+ */
+export declare class MessagePriorityQueue {
+    private queues;
+    private readonly priorityOrder;
+    /**
+     * Enqueue a message based on its priority
+     */
+    enqueue(message: MessageEnvelope): void;
+    /**
+     * Dequeue the highest priority message
+     */
+    dequeue(): MessageEnvelope | undefined;
+    /**
+     * Peek at the next message without removing it
+     */
+    peek(): MessageEnvelope | undefined;
+    /**
+     * Get the total number of messages in all queues
+     */
+    size(): number;
+    /**
+     * Check if the queue is empty
+     */
+    isEmpty(): boolean;
+    /**
+     * Clear all messages from all queues
+     */
+    clear(): void;
+    /**
+     * Get the number of messages for a specific priority
+     */
+    sizeForPriority(priority: MessagePriority): number;
+}
+/**
+ * Message Transform
+ * Applies transformations to messages based on routing rules
+ */
+export declare class MessageTransform {
+    /**
+     * Apply a transformation to a message
+     */
+    static transform(message: MessageEnvelope, transformExpression?: string): MessageEnvelope;
+}
+/**
+ * Routing Statistics
+ */
+export interface RoutingStats {
+    totalMessages: number;
+    messagesByPriority: Record<MessagePriority, number>;
+    messagesByType: Record<string, number>;
+    routingErrors: number;
+    averageRoutingTimeMs: number;
+}
+/**
+ * Routing Statistics Collector
+ */
+export declare class RoutingStatsCollector {
+    private stats;
+    private routingTimes;
+    recordMessage(message: MessageEnvelope, routingTimeMs: number): void;
+    recordError(): void;
+    getStats(): RoutingStats;
+    reset(): void;
+}
+//# sourceMappingURL=routing.d.ts.map

package/dist/mesh/routing.d.ts.map

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