@teneo-protocol/sdk 1.0.0

package/dist/managers/agent-registry.js

@@ -0,0 +1,310 @@
+"use strict";
+/**
+ * AgentRegistry - Manages agent state and lookup
+ * Handles agent caching and queries
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentRegistry = void 0;
+const eventemitter3_1 = require("eventemitter3");
+const validation_1 = require("../types/validation");
+class AgentRegistry extends eventemitter3_1.EventEmitter {
+    constructor(logger) {
+        super();
+        this.agents = new Map();
+        this.isAgentsCacheDirty = true;
+        // PERF-3: Search indices for O(1) lookups
+        this.capabilityIndex = new Map();
+        this.nameTokenIndex = new Map();
+        this.statusIndex = new Map();
+        this.logger = logger;
+    }
+    /**
+     * Gets a cached list of all available agents in the network.
+     * Uses lazy caching with dirty flag for optimal performance.
+     * Returns a read-only array with defensive copies to prevent external modification.
+     *
+     * @returns Read-only array of agent copies
+     *
+     * @example
+     * ```typescript
+     * const agents = agentRegistry.getAgents();
+     * console.log(`${agents.length} agents available`);
+     * agents.forEach(agent => console.log(agent.name));
+     * ```
+     */
+    getAgents() {
+        if (this.isAgentsCacheDirty || !this.cachedAgents) {
+            this.rebuildCache();
+        }
+        return this.cachedAgents.map((agent) => ({ ...agent }));
+    }
+    /**
+     * Gets a specific agent by its unique identifier.
+     * Performs O(1) lookup using internal Map structure.
+     * Returns a defensive copy to prevent external modification of agent state.
+     *
+     * @param agentId - The unique identifier of the agent
+     * @returns Copy of the agent object if found, undefined otherwise
+     * @throws {ValidationError} If agentId is invalid
+     *
+     * @example
+     * ```typescript
+     * const agent = agentRegistry.getAgent('weather-agent-001');
+     * if (agent) {
+     *   console.log(`Found: ${agent.name}`);
+     *   console.log(`Capabilities: ${agent.capabilities?.length}`);
+     * }
+     * ```
+     */
+    getAgent(agentId) {
+        // Validate agent ID
+        const validatedAgentId = validation_1.AgentIdSchema.parse(agentId);
+        const agent = this.agents.get(validatedAgentId);
+        return agent ? { ...agent } : undefined;
+    }
+    /**
+     * Finds all agents that have a specific capability.
+     * PERF-3: Uses O(1) capability index lookup instead of O(n) filtering.
+     *
+     * @param capabilityName - The name of the capability to search for (case-insensitive)
+     * @returns Read-only array of agents with the specified capability
+     * @throws {ValidationError} If capabilityName is invalid
+     *
+     * @example
+     * ```typescript
+     * const weatherAgents = agentRegistry.findByCapability('weather-forecast');
+     * console.log(`Found ${weatherAgents.length} agents with weather-forecast capability`);
+     * ```
+     */
+    findByCapability(capabilityName) {
+        // Validate capability name
+        const validatedCapabilityName = validation_1.SearchQuerySchema.parse(capabilityName);
+        // Ensure cache is up to date
+        if (this.isAgentsCacheDirty || !this.cachedAgents) {
+            this.rebuildCache();
+        }
+        // O(1) index lookup instead of O(n) filter
+        const normalizedCapName = validatedCapabilityName.toLowerCase();
+        const agentIds = this.capabilityIndex.get(normalizedCapName);
+        if (!agentIds || agentIds.size === 0) {
+            return [];
+        }
+        // Map agent IDs to agent objects with defensive copies
+        return Array.from(agentIds)
+            .map((id) => this.agents.get(id))
+            .filter((agent) => agent !== undefined)
+            .map((agent) => ({ ...agent }));
+    }
+    /**
+     * Finds agents by name using case-insensitive partial matching.
+     * PERF-3: Uses O(k) token index lookups instead of O(n) substring search,
+     * where k is the number of tokens in the search query.
+     *
+     * @param name - The name or partial name to search for (case-insensitive)
+     * @returns Read-only array of agents matching the name search
+     * @throws {ValidationError} If name is invalid
+     *
+     * @example
+     * ```typescript
+     * // Find all agents with "weather" in their name
+     * const weatherAgents = agentRegistry.findByName('weather');
+     * weatherAgents.forEach(agent => console.log(agent.name));
+     * ```
+     */
+    findByName(name) {
+        // Validate name
+        const validatedName = validation_1.SearchQuerySchema.parse(name);
+        // Ensure cache is up to date
+        if (this.isAgentsCacheDirty || !this.cachedAgents) {
+            this.rebuildCache();
+        }
+        // Tokenize search query
+        const searchTokens = this.tokenizeString(validatedName);
+        if (searchTokens.length === 0) {
+            return [];
+        }
+        // Find agents that match ANY token (union)
+        const matchingAgentIds = new Set();
+        for (const token of searchTokens) {
+            const agentIds = this.nameTokenIndex.get(token);
+            if (agentIds) {
+                agentIds.forEach((id) => matchingAgentIds.add(id));
+            }
+        }
+        if (matchingAgentIds.size === 0) {
+            return [];
+        }
+        // Map agent IDs to agent objects with defensive copies
+        return Array.from(matchingAgentIds)
+            .map((id) => this.agents.get(id))
+            .filter((agent) => agent !== undefined)
+            .map((agent) => ({ ...agent }));
+    }
+    /**
+     * Finds all agents with a specific status.
+     * PERF-3: Uses O(1) status index lookup instead of O(n) filtering.
+     *
+     * @param status - The status to search for: 'online' or 'offline' (case-insensitive)
+     * @returns Read-only array of agents with the specified status
+     * @throws {ValidationError} If status is invalid
+     *
+     * @example
+     * ```typescript
+     * const onlineAgents = agentRegistry.findByStatus('online');
+     * console.log(`Found ${onlineAgents.length} online agents`);
+     * ```
+     */
+    findByStatus(status) {
+        // Validate status
+        const validatedStatus = validation_1.SearchQuerySchema.parse(status);
+        // Ensure cache is up to date
+        if (this.isAgentsCacheDirty || !this.cachedAgents) {
+            this.rebuildCache();
+        }
+        // O(1) index lookup instead of O(n) filter
+        const normalizedStatus = validatedStatus.toLowerCase();
+        const agentIds = this.statusIndex.get(normalizedStatus);
+        if (!agentIds || agentIds.size === 0) {
+            return [];
+        }
+        // Map agent IDs to agent objects with defensive copies
+        return Array.from(agentIds)
+            .map((id) => this.agents.get(id))
+            .filter((agent) => agent !== undefined)
+            .map((agent) => ({ ...agent }));
+    }
+    /**
+     * Updates the registry with a new list of agents.
+     * Merges with existing agents and marks cache as dirty.
+     * Emits 'agent:list' event with the new agents.
+     *
+     * @internal This method is for internal SDK use
+     * @param agents - Array of agents to add or update in the registry
+     *
+     * @example
+     * ```typescript
+     * // Internal SDK usage
+     * agentRegistry.updateAgents(newAgentList);
+     * ```
+     */
+    updateAgents(agents) {
+        this.logger.debug("AgentRegistry: Updating agents", { count: agents.length });
+        for (const agent of agents) {
+            this.agents.set(agent.id, agent);
+        }
+        this.isAgentsCacheDirty = true;
+        this.emit("agent:list", agents);
+    }
+    /**
+     * Updates a single agent in the registry.
+     * Adds new agent or updates existing one, then marks cache as dirty.
+     *
+     * @internal This method is for internal SDK use
+     * @param agent - The agent to add or update
+     *
+     * @example
+     * ```typescript
+     * // Internal SDK usage
+     * agentRegistry.updateAgent(updatedAgent);
+     * ```
+     */
+    updateAgent(agent) {
+        this.logger.debug("AgentRegistry: Updating agent", { id: agent.id, name: agent.name });
+        this.agents.set(agent.id, agent);
+        this.isAgentsCacheDirty = true;
+    }
+    /**
+     * Clears all agents from the registry.
+     * Removes all cached agents and marks cache as dirty.
+     *
+     * @example
+     * ```typescript
+     * agentRegistry.clear();
+     * console.log('All agents cleared');
+     * ```
+     */
+    clear() {
+        this.agents.clear();
+        this.isAgentsCacheDirty = true;
+    }
+    /**
+     * Destroys the agent registry and cleans up resources.
+     * Clears all agents and removes all event listeners.
+     * After destruction, the registry cannot be reused.
+     *
+     * @example
+     * ```typescript
+     * agentRegistry.destroy();
+     * console.log('Agent registry destroyed');
+     * ```
+     */
+    destroy() {
+        this.logger.info("AgentRegistry: Destroying");
+        this.clear();
+        this.removeAllListeners();
+    }
+    /**
+     * Rebuilds the agent cache and all search indices.
+     * This is called automatically when the cache becomes dirty.
+     * PERF-3: Builds capability, name token, and status indices for O(1) lookups.
+     *
+     * @private
+     */
+    rebuildCache() {
+        // Rebuild agent array
+        this.cachedAgents = Array.from(this.agents.values()).map((agent) => ({ ...agent }));
+        // Clear indices
+        this.capabilityIndex.clear();
+        this.nameTokenIndex.clear();
+        this.statusIndex.clear();
+        // Populate indices
+        for (const agent of this.agents.values()) {
+            // Index capabilities
+            if (agent.capabilities) {
+                for (const capability of agent.capabilities) {
+                    const capName = capability.name.toLowerCase();
+                    if (!this.capabilityIndex.has(capName)) {
+                        this.capabilityIndex.set(capName, new Set());
+                    }
+                    this.capabilityIndex.get(capName).add(agent.id);
+                }
+            }
+            // Index name tokens (for partial matching)
+            const nameTokens = this.tokenizeString(agent.name);
+            for (const token of nameTokens) {
+                if (!this.nameTokenIndex.has(token)) {
+                    this.nameTokenIndex.set(token, new Set());
+                }
+                this.nameTokenIndex.get(token).add(agent.id);
+            }
+            // Index status
+            const status = agent.status.toLowerCase();
+            if (!this.statusIndex.has(status)) {
+                this.statusIndex.set(status, new Set());
+            }
+            this.statusIndex.get(status).add(agent.id);
+        }
+        this.isAgentsCacheDirty = false;
+    }
+    /**
+     * Tokenizes a string into searchable tokens.
+     * Splits on whitespace and special characters, converts to lowercase.
+     *
+     * @param str - String to tokenize
+     * @returns Array of lowercase tokens
+     * @private
+     *
+     * @example
+     * ```typescript
+     * tokenizeString("Weather API v2.0") => ["weather", "api", "v2", "0"]
+     * ```
+     */
+    tokenizeString(str) {
+        return str
+            .toLowerCase()
+            .split(/[\s\-_.,;:()[\]{}]+/)
+            .filter((token) => token.length > 0);
+    }
+}
+exports.AgentRegistry = AgentRegistry;
+//# sourceMappingURL=agent-registry.js.map

package/dist/managers/agent-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.js","sourceRoot":"","sources":["../../src/managers/agent-registry.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,iDAA6C;AAG7C,oDAAuE;AAEvE,MAAa,aAAc,SAAQ,4BAAuB;IAWxD,YAAY,MAAc;QACxB,KAAK,EAAE,CAAC;QAVO,WAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;QAE3C,uBAAkB,GAAG,IAAI,CAAC;QAElC,0CAA0C;QAClC,oBAAe,GAAG,IAAI,GAAG,EAAuB,CAAC;QACjD,mBAAc,GAAG,IAAI,GAAG,EAAuB,CAAC;QAChD,gBAAW,GAAG,IAAI,GAAG,EAAuB,CAAC;QAInD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACI,SAAS;QACd,IAAI,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClD,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC;QACD,OAAO,IAAI,CAAC,YAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACI,QAAQ,CAAC,OAAe;QAC7B,oBAAoB;QACpB,MAAM,gBAAgB,GAAG,0BAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAChD,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;;OAaG;IACI,gBAAgB,CAAC,cAAsB;QAC5C,2BAA2B;QAC3B,MAAM,uBAAuB,GAAG,8BAAiB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAExE,6BAA6B;QAC7B,IAAI,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClD,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC;QAED,2CAA2C;QAC3C,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,WAAW,EAAE,CAAC;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAE7D,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,uDAAuD;QACvD,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;aACxB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;aAChC,MAAM,CAAC,CAAC,KAAK,EAAkB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;aACtD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACI,UAAU,CAAC,IAAY;QAC5B,gBAAgB;QAChB,MAAM,aAAa,GAAG,8BAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEpD,6BAA6B;QAC7B,IAAI,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClD,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC;QAED,wBAAwB;QACxB,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;QAExD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,2CAA2C;QAC3C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;QAE3C,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAED,IAAI,gBAAgB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,uDAAuD;QACvD,OAAO,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC;aAChC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;aAChC,MAAM,CAAC,CAAC,KAAK,EAAkB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;aACtD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACI,YAAY,CAAC,MAAc;QAChC,kBAAkB;QAClB,MAAM,eAAe,GAAG,8BAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAExD,6BAA6B;QAC7B,IAAI,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClD,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC;QAED,2CAA2C;QAC3C,MAAM,gBAAgB,GAAG,eAAe,CAAC,WAAW,EAAE,CAAC;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAExD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,uDAAuD;QACvD,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;aACxB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;aAChC,MAAM,CAAC,CAAC,KAAK,EAAkB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;aACtD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACI,YAAY,CAAC,MAAe;QACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAE9E,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,WAAW,CAAC,KAAY;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;IACjC,CAAC;IAED;;;;;;;;;OASG;IACI,KAAK;QACV,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;IACjC,CAAC;IAED;;;;;;;;;;OAUG;IACI,OAAO;QACZ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;OAMG;IACK,YAAY;QAClB,sBAAsB;QACtB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;QAEpF,gBAAgB;QAChB,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QAEzB,mBAAmB;QACnB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,qBAAqB;YACrB,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;gBACvB,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;oBAC5C,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;oBAC9C,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;wBACvC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;oBAC/C,CAAC;oBACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;YAED,2CAA2C;YAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;gBAC/B,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBACpC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;gBAC5C,CAAC;gBACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAChD,CAAC;YAED,eAAe;YACf,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAC1C,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YAC1C,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC;IAClC,CAAC;IAED;;;;;;;;;;;;OAYG;IACK,cAAc,CAAC,GAAW;QAChC,OAAO,GAAG;aACP,WAAW,EAAE;aACb,KAAK,CAAC,qBAAqB,CAAC;aAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,CAAC;CACF;AAhVD,sCAgVC"}

package/dist/managers/connection-manager.d.ts

@@ -0,0 +1,134 @@
+/**
+ * ConnectionManager - Manages WebSocket connection lifecycle
+ * Handles connection, disconnection, and state management
+ */
+import { EventEmitter } from "eventemitter3";
+import { WebSocketClient } from "../core/websocket-client";
+import { ConnectionState, AuthenticationState, Logger } from "../types";
+import { SDKEvents } from "../types/events";
+export declare class ConnectionManager extends EventEmitter<SDKEvents> {
+    private readonly wsClient;
+    private readonly logger;
+    constructor(wsClient: WebSocketClient, logger: Logger);
+    /**
+     * Initiates WebSocket connection through the underlying WebSocket client.
+     * Delegates all connection logic including authentication and reconnection.
+     *
+     * @returns Promise that resolves when connection and authentication complete
+     * @throws {TimeoutError} If connection times out
+     * @throws {ConnectionError} If WebSocket connection fails
+     * @throws {AuthenticationError} If authentication fails
+     *
+     * @example
+     * ```typescript
+     * const connectionMgr = new ConnectionManager(wsClient, logger);
+     * await connectionMgr.connect();
+     * console.log('Connected via connection manager');
+     * ```
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnects from the WebSocket server through the underlying WebSocket client.
+     * Cleans up all connection resources and stops reconnection attempts.
+     *
+     * @example
+     * ```typescript
+     * connectionMgr.disconnect();
+     * console.log('Disconnected');
+     * ```
+     */
+    disconnect(): void;
+    /**
+     * Gets the current WebSocket connection state with detailed status information.
+     * Includes connection status, reconnection attempts, and error information.
+     *
+     * @returns Connection state object with status, attempts, and timestamps
+     *
+     * @example
+     * ```typescript
+     * const state = connectionMgr.getConnectionState();
+     * console.log(`Connected: ${state.connected}`);
+     * console.log(`Reconnecting: ${state.reconnecting}`);
+     * ```
+     */
+    getConnectionState(): ConnectionState;
+    /**
+     * Gets the current authentication state with wallet and room information.
+     * Includes authentication status, wallet address, and accessible rooms.
+     *
+     * @returns Authentication state object with wallet, challenge, and room access
+     *
+     * @example
+     * ```typescript
+     * const authState = connectionMgr.getAuthState();
+     * if (authState.authenticated) {
+     *   console.log(`Authenticated as: ${authState.walletAddress}`);
+     * }
+     * ```
+     */
+    getAuthState(): AuthenticationState;
+    /**
+     * Quick check for whether the WebSocket is currently connected.
+     * Convenience getter for immediate connection status.
+     *
+     * @returns True if connected, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (connectionMgr.isConnected) {
+     *   console.log('Ready to send messages');
+     * }
+     * ```
+     */
+    get isConnected(): boolean;
+    /**
+     * Quick check for whether authentication is complete.
+     * Convenience getter for immediate authentication status.
+     *
+     * @returns True if authenticated, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (connectionMgr.isAuthenticated) {
+     *   console.log('Authenticated and ready');
+     * }
+     * ```
+     */
+    get isAuthenticated(): boolean;
+    /**
+     * Gets the underlying WebSocket client instance for advanced usage.
+     * Provides direct access to low-level WebSocket operations.
+     *
+     * ⚠️ **WARNING:** This method returns a direct reference to the internal WebSocketClient.
+     * Modifying the client's state or calling methods directly may lead to unexpected behavior
+     * or break SDK functionality. Use this only for read-only operations like event listening.
+     *
+     * @internal This method is for internal SDK use and advanced scenarios
+     * @returns The WebSocketClient instance (direct reference - use with caution)
+     *
+     * @example
+     * ```typescript
+     * // Advanced usage - listen to low-level events (read-only)
+     * const wsClient = connectionMgr.getWebSocketClient();
+     * wsClient.on('message:received', (msg) => console.log(msg));
+     * ```
+     */
+    getWebSocketClient(): WebSocketClient;
+    /**
+     * Set up event forwarding from WebSocket client
+     */
+    private setupEventForwarding;
+    /**
+     * Destroys the connection manager and cleans up all resources.
+     * Disconnects from the server and removes all event listeners.
+     * After destruction, the manager cannot be reused.
+     *
+     * @example
+     * ```typescript
+     * connectionMgr.destroy();
+     * console.log('Connection manager destroyed');
+     * ```
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=connection-manager.d.ts.map

package/dist/managers/connection-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-manager.d.ts","sourceRoot":"","sources":["../../src/managers/connection-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,qBAAa,iBAAkB,SAAQ,YAAY,CAAC,SAAS,CAAC;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM;IAOrD;;;;;;;;;;;;;;;OAeG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrC;;;;;;;;;OASG;IACI,UAAU,IAAI,IAAI;IAKzB;;;;;;;;;;;;OAYG;IACI,kBAAkB,IAAI,eAAe;IAI5C;;;;;;;;;;;;;OAaG;IACI,YAAY,IAAI,mBAAmB;IAI1C;;;;;;;;;;;;OAYG;IACH,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED;;;;;;;;;;;;OAYG;IACH,IAAW,eAAe,IAAI,OAAO,CAEpC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACI,kBAAkB,IAAI,eAAe;IAI5C;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA2B5B;;;;;;;;;;OAUG;IACI,OAAO,IAAI,IAAI;CAKvB"}

package/dist/managers/connection-manager.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * ConnectionManager - Manages WebSocket connection lifecycle
+ * Handles connection, disconnection, and state management
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectionManager = void 0;
+const eventemitter3_1 = require("eventemitter3");
+class ConnectionManager extends eventemitter3_1.EventEmitter {
+    constructor(wsClient, logger) {
+        super();
+        this.wsClient = wsClient;
+        this.logger = logger;
+        this.setupEventForwarding();
+    }
+    /**
+     * Initiates WebSocket connection through the underlying WebSocket client.
+     * Delegates all connection logic including authentication and reconnection.
+     *
+     * @returns Promise that resolves when connection and authentication complete
+     * @throws {TimeoutError} If connection times out
+     * @throws {ConnectionError} If WebSocket connection fails
+     * @throws {AuthenticationError} If authentication fails
+     *
+     * @example
+     * ```typescript
+     * const connectionMgr = new ConnectionManager(wsClient, logger);
+     * await connectionMgr.connect();
+     * console.log('Connected via connection manager');
+     * ```
+     */
+    async connect() {
+        this.logger.info("ConnectionManager: Initiating connection");
+        await this.wsClient.connect();
+    }
+    /**
+     * Disconnects from the WebSocket server through the underlying WebSocket client.
+     * Cleans up all connection resources and stops reconnection attempts.
+     *
+     * @example
+     * ```typescript
+     * connectionMgr.disconnect();
+     * console.log('Disconnected');
+     * ```
+     */
+    disconnect() {
+        this.logger.info("ConnectionManager: Disconnecting");
+        this.wsClient.disconnect();
+    }
+    /**
+     * Gets the current WebSocket connection state with detailed status information.
+     * Includes connection status, reconnection attempts, and error information.
+     *
+     * @returns Connection state object with status, attempts, and timestamps
+     *
+     * @example
+     * ```typescript
+     * const state = connectionMgr.getConnectionState();
+     * console.log(`Connected: ${state.connected}`);
+     * console.log(`Reconnecting: ${state.reconnecting}`);
+     * ```
+     */
+    getConnectionState() {
+        return this.wsClient.getConnectionState();
+    }
+    /**
+     * Gets the current authentication state with wallet and room information.
+     * Includes authentication status, wallet address, and accessible rooms.
+     *
+     * @returns Authentication state object with wallet, challenge, and room access
+     *
+     * @example
+     * ```typescript
+     * const authState = connectionMgr.getAuthState();
+     * if (authState.authenticated) {
+     *   console.log(`Authenticated as: ${authState.walletAddress}`);
+     * }
+     * ```
+     */
+    getAuthState() {
+        return this.wsClient.getAuthState();
+    }
+    /**
+     * Quick check for whether the WebSocket is currently connected.
+     * Convenience getter for immediate connection status.
+     *
+     * @returns True if connected, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (connectionMgr.isConnected) {
+     *   console.log('Ready to send messages');
+     * }
+     * ```
+     */
+    get isConnected() {
+        return this.wsClient.isConnected;
+    }
+    /**
+     * Quick check for whether authentication is complete.
+     * Convenience getter for immediate authentication status.
+     *
+     * @returns True if authenticated, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (connectionMgr.isAuthenticated) {
+     *   console.log('Authenticated and ready');
+     * }
+     * ```
+     */
+    get isAuthenticated() {
+        return this.wsClient.isAuthenticated;
+    }
+    /**
+     * Gets the underlying WebSocket client instance for advanced usage.
+     * Provides direct access to low-level WebSocket operations.
+     *
+     * ⚠️ **WARNING:** This method returns a direct reference to the internal WebSocketClient.
+     * Modifying the client's state or calling methods directly may lead to unexpected behavior
+     * or break SDK functionality. Use this only for read-only operations like event listening.
+     *
+     * @internal This method is for internal SDK use and advanced scenarios
+     * @returns The WebSocketClient instance (direct reference - use with caution)
+     *
+     * @example
+     * ```typescript
+     * // Advanced usage - listen to low-level events (read-only)
+     * const wsClient = connectionMgr.getWebSocketClient();
+     * wsClient.on('message:received', (msg) => console.log(msg));
+     * ```
+     */
+    getWebSocketClient() {
+        return this.wsClient;
+    }
+    /**
+     * Set up event forwarding from WebSocket client
+     */
+    setupEventForwarding() {
+        // Forward connection events
+        this.wsClient.on("connection:open", () => this.emit("connection:open"));
+        this.wsClient.on("connection:close", (code, reason) => this.emit("connection:close", code, reason));
+        this.wsClient.on("connection:error", (error) => this.emit("connection:error", error));
+        this.wsClient.on("connection:reconnecting", (attempt) => this.emit("connection:reconnecting", attempt));
+        this.wsClient.on("connection:reconnected", () => this.emit("connection:reconnected"));
+        this.wsClient.on("connection:state", (state) => this.emit("connection:state", state));
+        // Forward auth events
+        this.wsClient.on("auth:challenge", (challenge) => this.emit("auth:challenge", challenge));
+        this.wsClient.on("auth:success", (state) => this.emit("auth:success", state));
+        this.wsClient.on("auth:error", (error) => this.emit("auth:error", error));
+        this.wsClient.on("auth:state", (state) => this.emit("auth:state", state));
+        // Forward lifecycle events
+        this.wsClient.on("ready", () => this.emit("ready"));
+        this.wsClient.on("disconnect", () => this.emit("disconnect"));
+        // Forward error events
+        this.wsClient.on("error", (error) => this.emit("error", error));
+    }
+    /**
+     * Destroys the connection manager and cleans up all resources.
+     * Disconnects from the server and removes all event listeners.
+     * After destruction, the manager cannot be reused.
+     *
+     * @example
+     * ```typescript
+     * connectionMgr.destroy();
+     * console.log('Connection manager destroyed');
+     * ```
+     */
+    destroy() {
+        this.logger.info("ConnectionManager: Destroying");
+        this.disconnect();
+        this.removeAllListeners();
+    }
+}
+exports.ConnectionManager = ConnectionManager;
+//# sourceMappingURL=connection-manager.js.map

package/dist/managers/connection-manager.js.map

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

package/dist/managers/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Manager exports
+ * Provides focused classes for different SDK responsibilities
+ */
+export { ConnectionManager } from "./connection-manager";
+export { RoomManager } from "./room-manager";
+export { AgentRegistry } from "./agent-registry";
+export { MessageRouter, type SendMessageOptions, type AgentCommand } from "./message-router";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/managers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/managers/index.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Manager exports
+ * Provides focused classes for different SDK responsibilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageRouter = exports.AgentRegistry = exports.RoomManager = exports.ConnectionManager = void 0;
+var connection_manager_1 = require("./connection-manager");
+Object.defineProperty(exports, "ConnectionManager", { enumerable: true, get: function () { return connection_manager_1.ConnectionManager; } });
+var room_manager_1 = require("./room-manager");
+Object.defineProperty(exports, "RoomManager", { enumerable: true, get: function () { return room_manager_1.RoomManager; } });
+var agent_registry_1 = require("./agent-registry");
+Object.defineProperty(exports, "AgentRegistry", { enumerable: true, get: function () { return agent_registry_1.AgentRegistry; } });
+var message_router_1 = require("./message-router");
+Object.defineProperty(exports, "MessageRouter", { enumerable: true, get: function () { return message_router_1.MessageRouter; } });
+//# sourceMappingURL=index.js.map

package/dist/managers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/managers/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA;AAC1B,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,mDAA6F;AAApF,+GAAA,aAAa,OAAA"}