@teneo-protocol/sdk 1.0.0

package/dist/index.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Teneo Protocol SDK
+ * TypeScript SDK for external platforms to interact with Teneo agents
+ * Uses Zod for runtime validation and type safety
+ *
+ * @packageDocumentation
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListRoomsResponseSchema = exports.RoomInfoSchema = exports.UnsubscribeResponseSchema = exports.SubscribeResponseSchema = exports.ListRoomsMessageSchema = exports.UnsubscribeMessageSchema = exports.SubscribeMessageSchema = exports.PongMessageSchema = exports.PingMessageSchema = exports.ErrorMessageSchema = exports.AgentsListMessageSchema = exports.AgentSelectedMessageSchema = exports.TaskResponseMessageSchema = exports.TaskMessageSchema = exports.UserMessageSchema = exports.RegistrationSuccessMessageSchema = exports.RegisterMessageSchema = exports.AuthErrorMessageSchema = exports.AuthSuccessMessageSchema = exports.AuthMessageSchema = exports.CheckCachedAuthMessageSchema = exports.ChallengeMessageSchema = exports.RequestChallengeMessageSchema = exports.BaseMessageSchema = exports.AgentSchema = exports.RoomSchema = exports.CommandSchema = exports.CapabilitySchema = exports.AgentStatusSchema = exports.AgentTypeSchema = exports.ClientTypeSchema = exports.ContentTypeSchema = exports.MessageTypeSchema = exports.safeParseConfig = exports.validateConfig = exports.DEFAULT_CONFIG = exports.SDKConfigBuilder = exports.WebhookPayloadSchema = exports.WebhookConfigSchema = exports.AuthenticationStateSchema = exports.ConnectionStateSchema = exports.PartialSDKConfigSchema = exports.SDKConfigSchema = exports.WebhookEventTypeSchema = exports.ResponseFormatSchema = exports.LogLevelSchema = exports.LoggerSchema = exports.AgentCommandSchema = exports.SendMessageOptionsSchema = exports.TeneoSDK = void 0;
+exports.SecurePrivateKey = exports.ResponseFormatter = exports.FormattedResponseSchema = exports.ResponseMetadataSchema = exports.FormatOptionSchema = exports.isRecoverableError = exports.safeValidateEventData = exports.validateEventData = exports.ConfigurationError = exports.SignatureVerificationError = exports.RateLimitError = exports.TimeoutError = exports.ValidationError = exports.WebhookError = exports.MessageError = exports.AuthenticationError = exports.ConnectionError = exports.SDKError = exports.EventMetadataSchema = exports.ConfigurationErrorSchema = exports.SignatureVerificationErrorSchema = exports.RateLimitErrorSchema = exports.TimeoutErrorSchema = exports.ValidationErrorSchema = exports.WebhookErrorSchema = exports.MessageErrorSchema = exports.AuthenticationErrorSchema = exports.ConnectionErrorSchema = exports.SDKErrorSchema = exports.AgentResponseSchema = exports.AgentSelectedDataSchema = exports.safeParseMessage = exports.validateMessage = exports.createListRooms = exports.createUnsubscribe = exports.createSubscribe = exports.createPing = exports.createUserMessage = exports.createAuth = exports.createCheckCachedAuth = exports.createRequestChallenge = exports.isAgentsList = exports.isError = exports.isTaskResponse = exports.isAgentSelected = exports.isChallenge = exports.isAuth = exports.isAuthError = exports.isAuthSuccess = exports.AnyMessageSchema = void 0;
+exports.VERSION = void 0;
+exports.createTeneoSDK = createTeneoSDK;
+/**
+ * Main SDK class for interacting with Teneo agents
+ * @see {@link TeneoSDK}
+ */
+var teneo_sdk_1 = require("./teneo-sdk");
+Object.defineProperty(exports, "TeneoSDK", { enumerable: true, get: function () { return teneo_sdk_1.TeneoSDK; } });
+Object.defineProperty(exports, "SendMessageOptionsSchema", { enumerable: true, get: function () { return teneo_sdk_1.SendMessageOptionsSchema; } });
+Object.defineProperty(exports, "AgentCommandSchema", { enumerable: true, get: function () { return teneo_sdk_1.AgentCommandSchema; } });
+const teneo_sdk_2 = require("./teneo-sdk");
+/**
+ * Configuration types, schemas, and builders
+ * Use SDKConfigBuilder for fluent configuration API
+ */
+var config_1 = require("./types/config");
+// Schemas
+Object.defineProperty(exports, "LoggerSchema", { enumerable: true, get: function () { return config_1.LoggerSchema; } });
+Object.defineProperty(exports, "LogLevelSchema", { enumerable: true, get: function () { return config_1.LogLevelSchema; } });
+Object.defineProperty(exports, "ResponseFormatSchema", { enumerable: true, get: function () { return config_1.ResponseFormatSchema; } });
+Object.defineProperty(exports, "WebhookEventTypeSchema", { enumerable: true, get: function () { return config_1.WebhookEventTypeSchema; } });
+Object.defineProperty(exports, "SDKConfigSchema", { enumerable: true, get: function () { return config_1.SDKConfigSchema; } });
+Object.defineProperty(exports, "PartialSDKConfigSchema", { enumerable: true, get: function () { return config_1.PartialSDKConfigSchema; } });
+Object.defineProperty(exports, "ConnectionStateSchema", { enumerable: true, get: function () { return config_1.ConnectionStateSchema; } });
+Object.defineProperty(exports, "AuthenticationStateSchema", { enumerable: true, get: function () { return config_1.AuthenticationStateSchema; } });
+Object.defineProperty(exports, "WebhookConfigSchema", { enumerable: true, get: function () { return config_1.WebhookConfigSchema; } });
+Object.defineProperty(exports, "WebhookPayloadSchema", { enumerable: true, get: function () { return config_1.WebhookPayloadSchema; } });
+Object.defineProperty(exports, "SDKConfigBuilder", { enumerable: true, get: function () { return config_1.SDKConfigBuilder; } });
+// Utilities
+Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return config_1.DEFAULT_CONFIG; } });
+Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return config_1.validateConfig; } });
+Object.defineProperty(exports, "safeParseConfig", { enumerable: true, get: function () { return config_1.safeParseConfig; } });
+/**
+ * Message types, schemas, and utilities
+ * All WebSocket message types with Zod validation
+ */
+var messages_1 = require("./types/messages");
+// Enum schemas
+Object.defineProperty(exports, "MessageTypeSchema", { enumerable: true, get: function () { return messages_1.MessageTypeSchema; } });
+Object.defineProperty(exports, "ContentTypeSchema", { enumerable: true, get: function () { return messages_1.ContentTypeSchema; } });
+Object.defineProperty(exports, "ClientTypeSchema", { enumerable: true, get: function () { return messages_1.ClientTypeSchema; } });
+Object.defineProperty(exports, "AgentTypeSchema", { enumerable: true, get: function () { return messages_1.AgentTypeSchema; } });
+Object.defineProperty(exports, "AgentStatusSchema", { enumerable: true, get: function () { return messages_1.AgentStatusSchema; } });
+// Supporting schemas
+Object.defineProperty(exports, "CapabilitySchema", { enumerable: true, get: function () { return messages_1.CapabilitySchema; } });
+Object.defineProperty(exports, "CommandSchema", { enumerable: true, get: function () { return messages_1.CommandSchema; } });
+Object.defineProperty(exports, "RoomSchema", { enumerable: true, get: function () { return messages_1.RoomSchema; } });
+Object.defineProperty(exports, "AgentSchema", { enumerable: true, get: function () { return messages_1.AgentSchema; } });
+// Message schemas
+Object.defineProperty(exports, "BaseMessageSchema", { enumerable: true, get: function () { return messages_1.BaseMessageSchema; } });
+Object.defineProperty(exports, "RequestChallengeMessageSchema", { enumerable: true, get: function () { return messages_1.RequestChallengeMessageSchema; } });
+Object.defineProperty(exports, "ChallengeMessageSchema", { enumerable: true, get: function () { return messages_1.ChallengeMessageSchema; } });
+Object.defineProperty(exports, "CheckCachedAuthMessageSchema", { enumerable: true, get: function () { return messages_1.CheckCachedAuthMessageSchema; } });
+Object.defineProperty(exports, "AuthMessageSchema", { enumerable: true, get: function () { return messages_1.AuthMessageSchema; } });
+Object.defineProperty(exports, "AuthSuccessMessageSchema", { enumerable: true, get: function () { return messages_1.AuthSuccessMessageSchema; } });
+Object.defineProperty(exports, "AuthErrorMessageSchema", { enumerable: true, get: function () { return messages_1.AuthErrorMessageSchema; } });
+Object.defineProperty(exports, "RegisterMessageSchema", { enumerable: true, get: function () { return messages_1.RegisterMessageSchema; } });
+Object.defineProperty(exports, "RegistrationSuccessMessageSchema", { enumerable: true, get: function () { return messages_1.RegistrationSuccessMessageSchema; } });
+Object.defineProperty(exports, "UserMessageSchema", { enumerable: true, get: function () { return messages_1.UserMessageSchema; } });
+Object.defineProperty(exports, "TaskMessageSchema", { enumerable: true, get: function () { return messages_1.TaskMessageSchema; } });
+Object.defineProperty(exports, "TaskResponseMessageSchema", { enumerable: true, get: function () { return messages_1.TaskResponseMessageSchema; } });
+Object.defineProperty(exports, "AgentSelectedMessageSchema", { enumerable: true, get: function () { return messages_1.AgentSelectedMessageSchema; } });
+Object.defineProperty(exports, "AgentsListMessageSchema", { enumerable: true, get: function () { return messages_1.AgentsListMessageSchema; } });
+Object.defineProperty(exports, "ErrorMessageSchema", { enumerable: true, get: function () { return messages_1.ErrorMessageSchema; } });
+Object.defineProperty(exports, "PingMessageSchema", { enumerable: true, get: function () { return messages_1.PingMessageSchema; } });
+Object.defineProperty(exports, "PongMessageSchema", { enumerable: true, get: function () { return messages_1.PongMessageSchema; } });
+Object.defineProperty(exports, "SubscribeMessageSchema", { enumerable: true, get: function () { return messages_1.SubscribeMessageSchema; } });
+Object.defineProperty(exports, "UnsubscribeMessageSchema", { enumerable: true, get: function () { return messages_1.UnsubscribeMessageSchema; } });
+Object.defineProperty(exports, "ListRoomsMessageSchema", { enumerable: true, get: function () { return messages_1.ListRoomsMessageSchema; } });
+Object.defineProperty(exports, "SubscribeResponseSchema", { enumerable: true, get: function () { return messages_1.SubscribeResponseSchema; } });
+Object.defineProperty(exports, "UnsubscribeResponseSchema", { enumerable: true, get: function () { return messages_1.UnsubscribeResponseSchema; } });
+Object.defineProperty(exports, "RoomInfoSchema", { enumerable: true, get: function () { return messages_1.RoomInfoSchema; } });
+Object.defineProperty(exports, "ListRoomsResponseSchema", { enumerable: true, get: function () { return messages_1.ListRoomsResponseSchema; } });
+Object.defineProperty(exports, "AnyMessageSchema", { enumerable: true, get: function () { return messages_1.AnyMessageSchema; } });
+// Type guards
+Object.defineProperty(exports, "isAuthSuccess", { enumerable: true, get: function () { return messages_1.isAuthSuccess; } });
+Object.defineProperty(exports, "isAuthError", { enumerable: true, get: function () { return messages_1.isAuthError; } });
+Object.defineProperty(exports, "isAuth", { enumerable: true, get: function () { return messages_1.isAuth; } });
+Object.defineProperty(exports, "isChallenge", { enumerable: true, get: function () { return messages_1.isChallenge; } });
+Object.defineProperty(exports, "isAgentSelected", { enumerable: true, get: function () { return messages_1.isAgentSelected; } });
+Object.defineProperty(exports, "isTaskResponse", { enumerable: true, get: function () { return messages_1.isTaskResponse; } });
+Object.defineProperty(exports, "isError", { enumerable: true, get: function () { return messages_1.isError; } });
+Object.defineProperty(exports, "isAgentsList", { enumerable: true, get: function () { return messages_1.isAgentsList; } });
+// Message factories
+Object.defineProperty(exports, "createRequestChallenge", { enumerable: true, get: function () { return messages_1.createRequestChallenge; } });
+Object.defineProperty(exports, "createCheckCachedAuth", { enumerable: true, get: function () { return messages_1.createCheckCachedAuth; } });
+Object.defineProperty(exports, "createAuth", { enumerable: true, get: function () { return messages_1.createAuth; } });
+Object.defineProperty(exports, "createUserMessage", { enumerable: true, get: function () { return messages_1.createUserMessage; } });
+Object.defineProperty(exports, "createPing", { enumerable: true, get: function () { return messages_1.createPing; } });
+Object.defineProperty(exports, "createSubscribe", { enumerable: true, get: function () { return messages_1.createSubscribe; } });
+Object.defineProperty(exports, "createUnsubscribe", { enumerable: true, get: function () { return messages_1.createUnsubscribe; } });
+Object.defineProperty(exports, "createListRooms", { enumerable: true, get: function () { return messages_1.createListRooms; } });
+// Validation helpers
+Object.defineProperty(exports, "validateMessage", { enumerable: true, get: function () { return messages_1.validateMessage; } });
+Object.defineProperty(exports, "safeParseMessage", { enumerable: true, get: function () { return messages_1.safeParseMessage; } });
+/**
+ * Event types, error classes, and event handling utilities
+ * Comprehensive typed event system for SDK lifecycle
+ */
+var events_1 = require("./types/events");
+// Schemas
+Object.defineProperty(exports, "AgentSelectedDataSchema", { enumerable: true, get: function () { return events_1.AgentSelectedDataSchema; } });
+Object.defineProperty(exports, "AgentResponseSchema", { enumerable: true, get: function () { return events_1.AgentResponseSchema; } });
+Object.defineProperty(exports, "SDKErrorSchema", { enumerable: true, get: function () { return events_1.SDKErrorSchema; } });
+Object.defineProperty(exports, "ConnectionErrorSchema", { enumerable: true, get: function () { return events_1.ConnectionErrorSchema; } });
+Object.defineProperty(exports, "AuthenticationErrorSchema", { enumerable: true, get: function () { return events_1.AuthenticationErrorSchema; } });
+Object.defineProperty(exports, "MessageErrorSchema", { enumerable: true, get: function () { return events_1.MessageErrorSchema; } });
+Object.defineProperty(exports, "WebhookErrorSchema", { enumerable: true, get: function () { return events_1.WebhookErrorSchema; } });
+Object.defineProperty(exports, "ValidationErrorSchema", { enumerable: true, get: function () { return events_1.ValidationErrorSchema; } });
+Object.defineProperty(exports, "TimeoutErrorSchema", { enumerable: true, get: function () { return events_1.TimeoutErrorSchema; } });
+Object.defineProperty(exports, "RateLimitErrorSchema", { enumerable: true, get: function () { return events_1.RateLimitErrorSchema; } });
+Object.defineProperty(exports, "SignatureVerificationErrorSchema", { enumerable: true, get: function () { return events_1.SignatureVerificationErrorSchema; } });
+Object.defineProperty(exports, "ConfigurationErrorSchema", { enumerable: true, get: function () { return events_1.ConfigurationErrorSchema; } });
+Object.defineProperty(exports, "EventMetadataSchema", { enumerable: true, get: function () { return events_1.EventMetadataSchema; } });
+// Error classes
+Object.defineProperty(exports, "SDKError", { enumerable: true, get: function () { return events_1.SDKError; } });
+Object.defineProperty(exports, "ConnectionError", { enumerable: true, get: function () { return events_1.ConnectionError; } });
+Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return events_1.AuthenticationError; } });
+Object.defineProperty(exports, "MessageError", { enumerable: true, get: function () { return events_1.MessageError; } });
+Object.defineProperty(exports, "WebhookError", { enumerable: true, get: function () { return events_1.WebhookError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return events_1.ValidationError; } });
+Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return events_1.TimeoutError; } });
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return events_1.RateLimitError; } });
+Object.defineProperty(exports, "SignatureVerificationError", { enumerable: true, get: function () { return events_1.SignatureVerificationError; } });
+Object.defineProperty(exports, "ConfigurationError", { enumerable: true, get: function () { return events_1.ConfigurationError; } });
+// Validation helpers
+Object.defineProperty(exports, "validateEventData", { enumerable: true, get: function () { return events_1.validateEventData; } });
+Object.defineProperty(exports, "safeValidateEventData", { enumerable: true, get: function () { return events_1.safeValidateEventData; } });
+Object.defineProperty(exports, "isRecoverableError", { enumerable: true, get: function () { return events_1.isRecoverableError; } });
+/**
+ * Response formatting utilities for agent responses
+ * Supports raw JSON, humanized text, or both formats
+ */
+var response_formatter_1 = require("./formatters/response-formatter");
+// Schemas
+Object.defineProperty(exports, "FormatOptionSchema", { enumerable: true, get: function () { return response_formatter_1.FormatOptionSchema; } });
+Object.defineProperty(exports, "ResponseMetadataSchema", { enumerable: true, get: function () { return response_formatter_1.ResponseMetadataSchema; } });
+Object.defineProperty(exports, "FormattedResponseSchema", { enumerable: true, get: function () { return response_formatter_1.FormattedResponseSchema; } });
+// Types and classes
+Object.defineProperty(exports, "ResponseFormatter", { enumerable: true, get: function () { return response_formatter_1.ResponseFormatter; } });
+/**
+ * Security utilities for private key management
+ * SEC-3: In-memory encryption for private keys
+ */
+var secure_private_key_1 = require("./utils/secure-private-key");
+Object.defineProperty(exports, "SecurePrivateKey", { enumerable: true, get: function () { return secure_private_key_1.SecurePrivateKey; } });
+/**
+ * SDK version string
+ */
+exports.VERSION = "1.0.0";
+/**
+ * Quick start function to create and connect SDK
+ *
+ * @example
+ * ```typescript
+ * import { createTeneoSDK } from '@teneo-protocol/sdk';
+ *
+ * const sdk = await createTeneoSDK({
+ *   wsUrl: 'ws://localhost:8080/ws',
+ *   privateKey: 'your-private-key',
+ *   autoJoinRooms: ['general']
+ * });
+ * ```
+ */
+async function createTeneoSDK(config) {
+    const { TeneoSDK } = await Promise.resolve().then(() => __importStar(require("./teneo-sdk")));
+    const sdk = new TeneoSDK(config);
+    await sdk.connect();
+    return sdk;
+}
+// Default export for convenience
+exports.default = teneo_sdk_2.TeneoSDK;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/managers/agent-registry.d.ts

@@ -0,0 +1,173 @@
+/**
+ * AgentRegistry - Manages agent state and lookup
+ * Handles agent caching and queries
+ */
+import { EventEmitter } from "eventemitter3";
+import { Agent, Logger } from "../types";
+import { SDKEvents } from "../types/events";
+export declare class AgentRegistry extends EventEmitter<SDKEvents> {
+    private readonly logger;
+    private readonly agents;
+    private cachedAgents?;
+    private isAgentsCacheDirty;
+    private capabilityIndex;
+    private nameTokenIndex;
+    private statusIndex;
+    constructor(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(): ReadonlyArray<Readonly<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: string): Readonly<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: string): ReadonlyArray<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: string): ReadonlyArray<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: string): ReadonlyArray<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: Agent[]): void;
+    /**
+     * 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: Agent): void;
+    /**
+     * 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(): void;
+    /**
+     * 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(): void;
+    /**
+     * 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
+     */
+    private rebuildCache;
+    /**
+     * 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"]
+     * ```
+     */
+    private tokenizeString;
+}
+//# sourceMappingURL=agent-registry.d.ts.map

package/dist/managers/agent-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.d.ts","sourceRoot":"","sources":["../../src/managers/agent-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,qBAAa,aAAc,SAAQ,YAAY,CAAC,SAAS,CAAC;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,YAAY,CAAC,CAAoB;IACzC,OAAO,CAAC,kBAAkB,CAAQ;IAGlC,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,WAAW,CAAkC;gBAEzC,MAAM,EAAE,MAAM;IAK1B;;;;;;;;;;;;;OAaG;IACI,SAAS,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAOlD;;;;;;;;;;;;;;;;;OAiBG;IACI,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,SAAS;IAQ7D;;;;;;;;;;;;;OAaG;IACI,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC;IAwBrE;;;;;;;;;;;;;;;OAeG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC;IAqCrD;;;;;;;;;;;;;OAaG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC;IAwBzD;;;;;;;;;;;;;OAaG;IACI,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI;IAW1C;;;;;;;;;;;;OAYG;IACI,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAMtC;;;;;;;;;OASG;IACI,KAAK,IAAI,IAAI;IAKpB;;;;;;;;;;OAUG;IACI,OAAO,IAAI,IAAI;IAMtB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IA0CpB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,cAAc;CAMvB"}