elevenlabs-voice-agent-mcp 1.0.14 → 1.1.0

package/dist/__tests__/utils/truncation.test.js

@@ -0,0 +1,208 @@
+/**
+ * Tests for truncation utilities
+ *
+ * Tests content truncation and formatting functions.
+ */
+import { describe, it, expect } from "vitest";
+import { truncateIfNeeded, truncateArray, truncateMiddle, formatJSON } from "../../utils/truncation.js";
+import { CHARACTER_LIMIT } from "../../constants.js";
+describe("Truncation Utilities", () => {
+    describe("truncateIfNeeded", () => {
+        it("should return content unchanged if under limit", () => {
+            const content = "Short content";
+            const result = truncateIfNeeded(content);
+            expect(result).toBe(content);
+        });
+        it("should return content unchanged at exactly limit", () => {
+            const content = "x".repeat(CHARACTER_LIMIT);
+            const result = truncateIfNeeded(content);
+            expect(result).toBe(content);
+        });
+        it("should truncate content exceeding limit", () => {
+            const content = "x".repeat(CHARACTER_LIMIT + 100);
+            const result = truncateIfNeeded(content);
+            // Result includes the truncated content + truncation message, so it's slightly longer
+            // but the original content portion is truncated
+            expect(result).toContain("[TRUNCATED:");
+            expect(result).toContain(`${CHARACTER_LIMIT} characters`);
+        });
+        it("should include default guidance in truncation message", () => {
+            const content = "x".repeat(CHARACTER_LIMIT + 100);
+            const result = truncateIfNeeded(content);
+            expect(result).toContain("Consider using filters or pagination");
+        });
+        it("should include custom context in truncation message", () => {
+            const content = "x".repeat(CHARACTER_LIMIT + 100);
+            const context = "Use offset=50 to continue";
+            const result = truncateIfNeeded(content, context);
+            expect(result).toContain("Use offset=50 to continue");
+        });
+        it("should preserve content start when truncating", () => {
+            const content = "START" + "x".repeat(CHARACTER_LIMIT + 100);
+            const result = truncateIfNeeded(content);
+            expect(result.startsWith("START")).toBe(true);
+        });
+    });
+    describe("truncateArray", () => {
+        const formatter = (item, idx) => `${idx + 1}. ${item}\n`;
+        it("should format all items if under limit", () => {
+            const items = ["Item 1", "Item 2", "Item 3"];
+            const result = truncateArray(items, formatter);
+            expect(result).toContain("1. Item 1");
+            expect(result).toContain("2. Item 2");
+            expect(result).toContain("3. Item 3");
+            expect(result).not.toContain("[TRUNCATED:");
+        });
+        it("should truncate when formatted content exceeds limit", () => {
+            // Create items that will exceed CHARACTER_LIMIT when formatted
+            const longItem = "x".repeat(5000);
+            const items = Array(10).fill(longItem);
+            const result = truncateArray(items, formatter);
+            expect(result).toContain("[TRUNCATED:");
+        });
+        it("should include offset in truncation guidance", () => {
+            const longItem = "x".repeat(5000);
+            const items = Array(10).fill(longItem);
+            const result = truncateArray(items, formatter, 5);
+            // Should include next offset based on items processed
+            expect(result).toContain("offset=");
+        });
+        it("should include custom context in truncation", () => {
+            const longItem = "x".repeat(5000);
+            const items = Array(10).fill(longItem);
+            const result = truncateArray(items, formatter, 0, "Custom guidance here");
+            expect(result).toContain("Custom guidance here");
+        });
+        it("should handle empty array", () => {
+            const result = truncateArray([], formatter);
+            expect(result).toBe("");
+        });
+        it("should handle single item", () => {
+            const items = ["Single item"];
+            const result = truncateArray(items, formatter);
+            expect(result).toBe("1. Single item\n");
+        });
+        it("should work with complex formatter", () => {
+            const agents = [
+                { name: "Agent 1", id: "ag_1" },
+                { name: "Agent 2", id: "ag_2" }
+            ];
+            const agentFormatter = (agent, idx) => `## ${idx + 1}. ${agent.name}\nID: ${agent.id}\n\n`;
+            const result = truncateArray(agents, agentFormatter);
+            expect(result).toContain("## 1. Agent 1");
+            expect(result).toContain("ID: ag_1");
+            expect(result).toContain("## 2. Agent 2");
+        });
+    });
+    describe("truncateMiddle", () => {
+        it("should return content unchanged if under maxLength", () => {
+            const content = "Short";
+            const result = truncateMiddle(content, 10);
+            expect(result).toBe("Short");
+        });
+        it("should return content unchanged at exactly maxLength", () => {
+            const content = "Exactly10!";
+            const result = truncateMiddle(content, 10);
+            expect(result).toBe("Exactly10!");
+        });
+        it("should truncate middle when exceeding maxLength", () => {
+            const content = "Hello World! This is a long string.";
+            const result = truncateMiddle(content, 20);
+            // The length may be slightly less than maxLength due to how halfLength is calculated
+            expect(result.length).toBeLessThanOrEqual(20);
+            expect(result).toContain("...");
+            expect(result.startsWith("Hello")).toBe(true);
+            expect(result.endsWith("ing.")).toBe(true);
+        });
+        it("should preserve start and end equally", () => {
+            const content = "AAAAABBBBBCCCCC";
+            const result = truncateMiddle(content, 11);
+            // With maxLength 11 and "..." taking 3 chars, we have 8 chars for content
+            // That's 4 chars at start and 4 at end
+            expect(result).toMatch(/^AAAA\.\.\.CCCC$/);
+        });
+        it("should handle very short maxLength", () => {
+            const content = "This is too long";
+            const result = truncateMiddle(content, 5);
+            expect(result.length).toBe(5);
+            expect(result).toContain("...");
+        });
+        it("should handle maxLength of 3 (just ellipsis)", () => {
+            const content = "Long content";
+            const result = truncateMiddle(content, 3);
+            // With maxLength 3, halfLength = (3-3)/2 = 0, so we get "..."
+            expect(result).toBe("...");
+        });
+    });
+    describe("formatJSON", () => {
+        it("should format object with default indentation", () => {
+            const obj = { key: "value", nested: { a: 1 } };
+            const result = formatJSON(obj);
+            expect(result).toBe(JSON.stringify(obj, null, 2));
+        });
+        it("should format object with custom indentation", () => {
+            const obj = { key: "value" };
+            const result = formatJSON(obj, 4);
+            expect(result).toBe(JSON.stringify(obj, null, 4));
+        });
+        it("should truncate large JSON objects", () => {
+            // Create object larger than CHARACTER_LIMIT
+            const largeObj = {
+                items: Array(1000).fill({ id: "x".repeat(100), data: "y".repeat(100) })
+            };
+            const result = formatJSON(largeObj);
+            expect(result).toContain("[TRUNCATED:");
+            expect(result).toContain(`${CHARACTER_LIMIT} characters`);
+        });
+        it("should not truncate small objects", () => {
+            const smallObj = { a: 1, b: 2, c: 3 };
+            const result = formatJSON(smallObj);
+            expect(result).not.toContain("[TRUNCATED:");
+        });
+        it("should handle arrays", () => {
+            const arr = [1, 2, 3];
+            const result = formatJSON(arr);
+            expect(result).toBe("[\n  1,\n  2,\n  3\n]");
+        });
+        it("should handle null", () => {
+            const result = formatJSON(null);
+            expect(result).toBe("null");
+        });
+        it("should handle strings", () => {
+            const result = formatJSON("test string");
+            expect(result).toBe('"test string"');
+        });
+        it("should handle numbers", () => {
+            const result = formatJSON(42);
+            expect(result).toBe("42");
+        });
+        it("should handle booleans", () => {
+            expect(formatJSON(true)).toBe("true");
+            expect(formatJSON(false)).toBe("false");
+        });
+        it("should handle deeply nested objects", () => {
+            const obj = {
+                level1: {
+                    level2: {
+                        level3: {
+                            value: "deep"
+                        }
+                    }
+                }
+            };
+            const result = formatJSON(obj);
+            expect(result).toContain('"level1"');
+            expect(result).toContain('"level2"');
+            expect(result).toContain('"level3"');
+            expect(result).toContain('"deep"');
+        });
+        it("should handle special characters in strings", () => {
+            const obj = { text: "Hello\nWorld\t\"Quoted\"" };
+            const result = formatJSON(obj);
+            expect(result).toContain("\\n");
+            expect(result).toContain("\\t");
+            expect(result).toContain('\\"');
+        });
+    });
+});
+//# sourceMappingURL=truncation.test.js.map

package/dist/__tests__/utils/truncation.test.js.map

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

package/dist/constants.d.ts

@@ -1,25 +1,149 @@
 /**
- * Constants for ElevenLabs Voice Agent MCP Server
- *
- * Contains API URLs, character limits, default values, and supported options
- * for ElevenLabs Voice Agent API integration.
+ * @fileoverview Constants for ElevenLabs Voice Agent MCP Server
+ * @description Contains API URLs, character limits, default values, and supported options
+ * for ElevenLabs Voice Agent API integration. These constants define the operational
+ * parameters and configuration options available throughout the MCP server.
+ * @module constants
+ */
+/**
+ * Base URL for all ElevenLabs API requests.
+ * @description The root endpoint for the ElevenLabs REST API. All API calls
+ * are made relative to this URL.
+ * @constant {string}
+ * @example
+ * // Used internally by the API client
+ * const url = `${API_BASE_URL}/convai/agents`;
  */
 export declare const API_BASE_URL = "https://api.elevenlabs.io/v1";
+/**
+ * Maximum character limit for MCP tool responses.
+ * @description Responses exceeding this limit are automatically truncated
+ * with pagination guidance to prevent overwhelming clients.
+ * @constant {number}
+ */
 export declare const CHARACTER_LIMIT = 25000;
+/**
+ * Default number of items returned in paginated list responses.
+ * @description Used when no limit is specified in list operations.
+ * @constant {number}
+ */
 export declare const DEFAULT_LIMIT = 20;
+/**
+ * Maximum number of items that can be requested in a single paginated response.
+ * @description Prevents excessive data transfer in single requests.
+ * @constant {number}
+ */
 export declare const MAX_LIMIT = 100;
+/**
+ * Default LLM model for voice agents.
+ * @description Claude Sonnet 4.5 with version date. The @ format specifies
+ * the exact model version for consistent behavior.
+ * @constant {string}
+ */
 export declare const DEFAULT_LLM = "claude-sonnet-4-5@20250929";
-export declare const DEFAULT_VOICE_MODEL = "eleven_turbo_v2";
+/**
+ * Default voice synthesis model for agents.
+ * @description Turbo v2.5 provides high-quality synthesis with support for
+ * 32 languages. Balances speed and quality for conversational AI.
+ * @constant {string}
+ */
+export declare const DEFAULT_VOICE_MODEL = "eleven_turbo_v2_5";
+/**
+ * Default voice ID for new agents.
+ * @description Rachel voice - a natural, professional female voice suitable
+ * for customer service and general conversation.
+ * @constant {string}
+ */
 export declare const DEFAULT_VOICE_ID = "21m00Tcm4TlvDq8ikWAM";
+/**
+ * Default language code for voice agents.
+ * @description English (US) is the default language for agent conversations.
+ * @constant {string}
+ */
 export declare const DEFAULT_LANGUAGE = "en";
+/**
+ * Array of commonly used LLM model identifiers.
+ * @description These are provided as defaults/examples. ElevenLabs may add new
+ * models that work without code changes. Any valid ElevenLabs model identifier
+ * is accepted by the API. Use @ format for versioned models.
+ * @constant {readonly string[]}
+ * @example
+ * // Using a supported LLM
+ * const agent = await createAgent({
+ *   llm: "claude-sonnet-4-5@20250929",
+ *   // ... other config
+ * });
+ */
 export declare const SUPPORTED_LLMS: readonly ["gpt-4o", "gpt-4o-mini", "claude-sonnet-4-5", "claude-sonnet-4-5@20250929", "claude-sonnet-4", "claude-sonnet-4@20250514", "claude-haiku-4-5", "claude-haiku-4-5@20251001", "claude-3-5-sonnet", "claude-3-5-sonnet@20240620", "claude-3-5-sonnet-v2@20241022", "claude-3-haiku", "claude-3-haiku@20240307", "gemini-2.0-flash", "gemini-2.0-flash-exp"];
+/**
+ * Supported voice models for conversational AI agents.
+ * @description Each model has different characteristics:
+ * - `eleven_turbo_v2`: English only, optimized for speed
+ * - `eleven_turbo_v2_5`: 32 languages, higher quality
+ * - `eleven_flash_v2`: English only, lowest latency
+ * - `eleven_flash_v2_5`: 32 languages, low latency
+ * - `eleven_multilingual_v2`: Full multilingual support
+ * @constant {readonly string[]}
+ */
 export declare const SUPPORTED_VOICE_MODELS: readonly ["eleven_turbo_v2", "eleven_turbo_v2_5", "eleven_flash_v2", "eleven_flash_v2_5", "eleven_multilingual_v2"];
+/**
+ * Supported language codes for voice agents.
+ * @description ISO 639-1 language codes supported by ElevenLabs voice agents.
+ * The actual language support depends on the selected voice model.
+ * @constant {readonly string[]}
+ */
 export declare const SUPPORTED_LANGUAGES: readonly ["en", "es", "fr", "de", "it", "pt", "pl", "nl", "ja", "zh", "ko", "ar", "hi"];
+/**
+ * Widget authentication types.
+ * @description Controls how users authenticate when using the web widget:
+ * - `none`: No authentication required
+ * - `manual`: Requires manual authentication
+ * - `open`: Open access with optional authentication
+ * @constant {readonly string[]}
+ */
 export declare const AUTH_TYPES: readonly ["none", "manual", "open"];
+/**
+ * Request timeout in milliseconds.
+ * @description Maximum time to wait for an API response before timing out.
+ * Set to 30 seconds to accommodate voice agent operations.
+ * @constant {number}
+ */
 export declare const REQUEST_TIMEOUT = 30000;
+/**
+ * Maximum number of recipients in a single batch call job.
+ * @description ElevenLabs limits batch calling to 10,000 recipients per job
+ * to ensure system stability and processing capacity.
+ * @constant {number}
+ */
 export declare const MAX_BATCH_RECIPIENTS = 10000;
+/**
+ * Minimum number of recipients required for a batch call job.
+ * @description At least one recipient must be specified for batch calling.
+ * @constant {number}
+ */
 export declare const MIN_BATCH_RECIPIENTS = 1;
+/**
+ * Supported phone number providers.
+ * @description Phone numbers can be provisioned through:
+ * - `twilio`: Twilio-managed phone numbers
+ * - `sip_trunk`: Self-managed SIP trunk connections
+ * @constant {readonly string[]}
+ */
 export declare const PHONE_PROVIDERS: readonly ["twilio", "sip_trunk"];
+/**
+ * ElevenLabs region identifiers.
+ * @description Geographic regions for phone number routing:
+ * - `us1`: United States
+ * - `ie1`: Ireland (Europe)
+ * - `au1`: Australia
+ * @constant {readonly string[]}
+ */
 export declare const REGION_IDS: readonly ["us1", "ie1", "au1"];
+/**
+ * Twilio edge locations for voice routing.
+ * @description Geographic points of presence for Twilio voice traffic
+ * optimization. Choose the location closest to your users for best latency.
+ * @constant {readonly string[]}
+ */
 export declare const EDGE_LOCATIONS: readonly ["ashburn", "dublin", "frankfurt", "sao-paulo", "singapore", "sydney", "tokyo", "umatilla", "roaming"];
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,YAAY,iCAAiC,CAAC;AAG3D,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,SAAS,MAAM,CAAC;AAG7B,eAAO,MAAM,WAAW,+BAA+B,CAAC;AACxD,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AACrD,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AACvD,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAKrC,eAAO,MAAM,cAAc,oWAgBjB,CAAC;AAMX,eAAO,MAAM,sBAAsB,qHAMzB,CAAC;AAGX,eAAO,MAAM,mBAAmB,yFAEtB,CAAC;AAGX,eAAO,MAAM,UAAU,qCAAsC,CAAC;AAG9D,eAAO,MAAM,eAAe,QAAQ,CAAC;AAGrC,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAC1C,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAGtC,eAAO,MAAM,eAAe,kCAAmC,CAAC;AAGhE,eAAO,MAAM,UAAU,gCAAiC,CAAC;AAGzD,eAAO,MAAM,cAAc,iHAGjB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,iCAAiC,CAAC;AAM3D;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC;;;;GAIG;AACH,eAAO,MAAM,SAAS,MAAM,CAAC;AAM7B;;;;;GAKG;AACH,eAAO,MAAM,WAAW,+BAA+B,CAAC;AAExD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAMrC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,oWAgBjB,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,qHAMzB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,yFAEtB,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,qCAAsC,CAAC;AAM9D;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAQ,CAAC;AAMrC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAMtC;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,kCAAmC,CAAC;AAEhE;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,gCAAiC,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,iHAGjB,CAAC"}

package/dist/constants.js

@@ -1,22 +1,88 @@
 /**
- * Constants for ElevenLabs Voice Agent MCP Server
- *
- * Contains API URLs, character limits, default values, and supported options
- * for ElevenLabs Voice Agent API integration.
+ * @fileoverview Constants for ElevenLabs Voice Agent MCP Server
+ * @description Contains API URLs, character limits, default values, and supported options
+ * for ElevenLabs Voice Agent API integration. These constants define the operational
+ * parameters and configuration options available throughout the MCP server.
+ * @module constants
+ */
+/**
+ * Base URL for all ElevenLabs API requests.
+ * @description The root endpoint for the ElevenLabs REST API. All API calls
+ * are made relative to this URL.
+ * @constant {string}
+ * @example
+ * // Used internally by the API client
+ * const url = `${API_BASE_URL}/convai/agents`;
  */
 export const API_BASE_URL = "https://api.elevenlabs.io/v1";
-// Response limits
+// ============================================================================
+// Response Limits
+// ============================================================================
+/**
+ * Maximum character limit for MCP tool responses.
+ * @description Responses exceeding this limit are automatically truncated
+ * with pagination guidance to prevent overwhelming clients.
+ * @constant {number}
+ */
 export const CHARACTER_LIMIT = 25000;
+/**
+ * Default number of items returned in paginated list responses.
+ * @description Used when no limit is specified in list operations.
+ * @constant {number}
+ */
 export const DEFAULT_LIMIT = 20;
+/**
+ * Maximum number of items that can be requested in a single paginated response.
+ * @description Prevents excessive data transfer in single requests.
+ * @constant {number}
+ */
 export const MAX_LIMIT = 100;
-// Default configuration values
-export const DEFAULT_LLM = "claude-sonnet-4-5@20250929"; // Claude Sonnet 4.5 (using @ date format)
-export const DEFAULT_VOICE_MODEL = "eleven_turbo_v2"; // Turbo v2 for English agents
-export const DEFAULT_VOICE_ID = "21m00Tcm4TlvDq8ikWAM"; // Rachel voice
+// ============================================================================
+// Default Configuration Values
+// ============================================================================
+/**
+ * Default LLM model for voice agents.
+ * @description Claude Sonnet 4.5 with version date. The @ format specifies
+ * the exact model version for consistent behavior.
+ * @constant {string}
+ */
+export const DEFAULT_LLM = "claude-sonnet-4-5@20250929";
+/**
+ * Default voice synthesis model for agents.
+ * @description Turbo v2.5 provides high-quality synthesis with support for
+ * 32 languages. Balances speed and quality for conversational AI.
+ * @constant {string}
+ */
+export const DEFAULT_VOICE_MODEL = "eleven_turbo_v2_5";
+/**
+ * Default voice ID for new agents.
+ * @description Rachel voice - a natural, professional female voice suitable
+ * for customer service and general conversation.
+ * @constant {string}
+ */
+export const DEFAULT_VOICE_ID = "21m00Tcm4TlvDq8ikWAM";
+/**
+ * Default language code for voice agents.
+ * @description English (US) is the default language for agent conversations.
+ * @constant {string}
+ */
 export const DEFAULT_LANGUAGE = "en";
-// Common LLM models (examples - any valid ElevenLabs model identifier is accepted)
-// These are provided as defaults/examples; ElevenLabs may add new models that work without code changes
-// Note: Use @ format for versioned models (e.g., claude-sonnet-4-5@20250929)
+// ============================================================================
+// Supported Models and Options
+// ============================================================================
+/**
+ * Array of commonly used LLM model identifiers.
+ * @description These are provided as defaults/examples. ElevenLabs may add new
+ * models that work without code changes. Any valid ElevenLabs model identifier
+ * is accepted by the API. Use @ format for versioned models.
+ * @constant {readonly string[]}
+ * @example
+ * // Using a supported LLM
+ * const agent = await createAgent({
+ *   llm: "claude-sonnet-4-5@20250929",
+ *   // ... other config
+ * });
+ */
 export const SUPPORTED_LLMS = [
     "gpt-4o",
     "gpt-4o-mini",
@@ -34,10 +100,16 @@ export const SUPPORTED_LLMS = [
     "gemini-2.0-flash",
     "gemini-2.0-flash-exp"
 ];
-// Supported voice models for conversational AI agents
-// v2 models (turbo_v2, flash_v2) are optimized for English only
-// v2.5 models (turbo_v2_5, flash_v2_5) support 32 languages
-// multilingual_v2 supports multiple languages
+/**
+ * Supported voice models for conversational AI agents.
+ * @description Each model has different characteristics:
+ * - `eleven_turbo_v2`: English only, optimized for speed
+ * - `eleven_turbo_v2_5`: 32 languages, higher quality
+ * - `eleven_flash_v2`: English only, lowest latency
+ * - `eleven_flash_v2_5`: 32 languages, low latency
+ * - `eleven_multilingual_v2`: Full multilingual support
+ * @constant {readonly string[]}
+ */
 export const SUPPORTED_VOICE_MODELS = [
     "eleven_turbo_v2",
     "eleven_turbo_v2_5",
@@ -45,22 +117,76 @@ export const SUPPORTED_VOICE_MODELS = [
     "eleven_flash_v2_5",
     "eleven_multilingual_v2"
 ];
-// Supported languages
+/**
+ * Supported language codes for voice agents.
+ * @description ISO 639-1 language codes supported by ElevenLabs voice agents.
+ * The actual language support depends on the selected voice model.
+ * @constant {readonly string[]}
+ */
 export const SUPPORTED_LANGUAGES = [
     "en", "es", "fr", "de", "it", "pt", "pl", "nl", "ja", "zh", "ko", "ar", "hi"
 ];
-// Authentication types
+/**
+ * Widget authentication types.
+ * @description Controls how users authenticate when using the web widget:
+ * - `none`: No authentication required
+ * - `manual`: Requires manual authentication
+ * - `open`: Open access with optional authentication
+ * @constant {readonly string[]}
+ */
 export const AUTH_TYPES = ["none", "manual", "open"];
-// API timeouts
-export const REQUEST_TIMEOUT = 30000; // 30 seconds
-// Batch calling limits
+// ============================================================================
+// API Configuration
+// ============================================================================
+/**
+ * Request timeout in milliseconds.
+ * @description Maximum time to wait for an API response before timing out.
+ * Set to 30 seconds to accommodate voice agent operations.
+ * @constant {number}
+ */
+export const REQUEST_TIMEOUT = 30000;
+// ============================================================================
+// Batch Calling Limits
+// ============================================================================
+/**
+ * Maximum number of recipients in a single batch call job.
+ * @description ElevenLabs limits batch calling to 10,000 recipients per job
+ * to ensure system stability and processing capacity.
+ * @constant {number}
+ */
 export const MAX_BATCH_RECIPIENTS = 10000;
+/**
+ * Minimum number of recipients required for a batch call job.
+ * @description At least one recipient must be specified for batch calling.
+ * @constant {number}
+ */
 export const MIN_BATCH_RECIPIENTS = 1;
-// Phone providers
+// ============================================================================
+// Phone Number Configuration
+// ============================================================================
+/**
+ * Supported phone number providers.
+ * @description Phone numbers can be provisioned through:
+ * - `twilio`: Twilio-managed phone numbers
+ * - `sip_trunk`: Self-managed SIP trunk connections
+ * @constant {readonly string[]}
+ */
 export const PHONE_PROVIDERS = ["twilio", "sip_trunk"];
-// Phone number regions
+/**
+ * ElevenLabs region identifiers.
+ * @description Geographic regions for phone number routing:
+ * - `us1`: United States
+ * - `ie1`: Ireland (Europe)
+ * - `au1`: Australia
+ * @constant {readonly string[]}
+ */
 export const REGION_IDS = ["us1", "ie1", "au1"];
-// Edge locations
+/**
+ * Twilio edge locations for voice routing.
+ * @description Geographic points of presence for Twilio voice traffic
+ * optimization. Choose the location closest to your users for best latency.
+ * @constant {readonly string[]}
+ */
 export const EDGE_LOCATIONS = [
     "ashburn", "dublin", "frankfurt", "sao-paulo",
     "singapore", "sydney", "tokyo", "umatilla", "roaming"

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,8BAA8B,CAAC;AAE3D,kBAAkB;AAClB,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAChC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAE7B,+BAA+B;AAC/B,MAAM,CAAC,MAAM,WAAW,GAAG,4BAA4B,CAAC,CAAC,0CAA0C;AACnG,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,CAAC,8BAA8B;AACpF,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,CAAC,eAAe;AACvE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC,mFAAmF;AACnF,wGAAwG;AACxG,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,QAAQ;IACR,aAAa;IACb,mBAAmB;IACnB,4BAA4B;IAC5B,iBAAiB;IACjB,0BAA0B;IAC1B,kBAAkB;IAClB,2BAA2B;IAC3B,mBAAmB;IACnB,4BAA4B;IAC5B,+BAA+B;IAC/B,gBAAgB;IAChB,yBAAyB;IACzB,kBAAkB;IAClB,sBAAsB;CACd,CAAC;AAEX,sDAAsD;AACtD,gEAAgE;AAChE,4DAA4D;AAC5D,8CAA8C;AAC9C,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,iBAAiB;IACjB,mBAAmB;IACnB,iBAAiB;IACjB,mBAAmB;IACnB,wBAAwB;CAChB,CAAC;AAEX,sBAAsB;AACtB,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CACpE,CAAC;AAEX,uBAAuB;AACvB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAE9D,eAAe;AACf,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,aAAa;AAEnD,uBAAuB;AACvB,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAEtC,kBAAkB;AAClB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAU,CAAC;AAEhE,uBAAuB;AACvB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAEzD,iBAAiB;AACjB,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW;IAC7C,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS;CAC7C,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,8BAA8B,CAAC;AAE3D,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAE7B,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,4BAA4B,CAAC;AAExD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,QAAQ;IACR,aAAa;IACb,mBAAmB;IACnB,4BAA4B;IAC5B,iBAAiB;IACjB,0BAA0B;IAC1B,kBAAkB;IAClB,2BAA2B;IAC3B,mBAAmB;IACnB,4BAA4B;IAC5B,+BAA+B;IAC/B,gBAAgB;IAChB,yBAAyB;IACzB,kBAAkB;IAClB,sBAAsB;CACd,CAAC;AAEX;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,iBAAiB;IACjB,mBAAmB;IACnB,iBAAiB;IACjB,mBAAmB;IACnB,wBAAwB;CAChB,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CACpE,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAE9D,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAEtC,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAU,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW;IAC7C,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS;CAC7C,CAAC"}

package/dist/index.d.ts

@@ -1,8 +1,19 @@
 #!/usr/bin/env node
 /**
- * ElevenLabs Voice Agent MCP Server
+ * @fileoverview ElevenLabs Voice Agent MCP Server
+ * @description Main entry point for the MCP server providing tools for voice agent development.
+ * This server implements the Model Context Protocol (MCP) to expose 23 specialized tools
+ * for creating, configuring, testing, monitoring, and deploying ElevenLabs Voice Agents.
  *
- * Main entry point for the MCP server providing tools for voice agent development.
+ * @requires @modelcontextprotocol/sdk
+ * @requires axios
+ * @requires zod
+ *
+ * @example
+ * // Start the server (stdio transport)
+ * $ ELEVENLABS_API_KEY=your_key node dist/index.js
+ *
+ * @module index
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;GAeG"}