elevenlabs-voice-agent-mcp 1.0.14 → 1.1.0

package/dist/utils/truncation.js

@@ -1,16 +1,22 @@
 /**
- * Response truncation utilities
- *
- * Handles truncation of large responses to stay within MCP character limits
- * while providing clear guidance to users.
+ * @fileoverview Response truncation utilities
+ * @description Handles truncation of large responses to stay within MCP character limits
+ * while providing clear guidance to users. Prevents overwhelming clients with excessive data.
+ * @module utils/truncation
  */
 import { CHARACTER_LIMIT } from "../constants.js";
 /**
- * Truncates content if it exceeds the character limit
+ * Truncates content if it exceeds the character limit.
+ * @description Checks content length against CHARACTER_LIMIT and truncates with
+ * a helpful message if exceeded. Used to prevent response overflow in MCP tools.
+ *
+ * @param {string} content - The content to potentially truncate
+ * @param {string} [context] - Additional context or guidance for the user
+ * @returns {string} Original content if within limit, or truncated with indicator
  *
- * @param content - The content to potentially truncate
- * @param context - Additional context or guidance for the user
- * @returns Original or truncated content with indicator
+ * @example
+ * const output = truncateIfNeeded(longMarkdown, "Use offset=100 to continue");
+ * // If over limit: "...content...[TRUNCATED: Response exceeded 25000 characters. Use offset=100 to continue]"
  */
 export function truncateIfNeeded(content, context) {
     if (content.length <= CHARACTER_LIMIT) {
@@ -21,13 +27,19 @@ export function truncateIfNeeded(content, context) {
     return `${truncated}\n\n[TRUNCATED: Response exceeded ${CHARACTER_LIMIT} characters. ${guidance}]`;
 }
 /**
- * Truncates an array of items and provides pagination guidance
+ * Truncates an array of items with pagination guidance.
+ * @description Formats array items one by one, stopping when the character limit
+ * is reached. Provides pagination guidance for fetching remaining items.
+ *
+ * @template T - Type of items in the array
+ * @param {T[]} items - Array of items that might need truncation
+ * @param {(item: T, index: number) => string} formatter - Function to format each item as a string
+ * @param {number} [currentOffset=0] - Current pagination offset for guidance
+ * @param {string} [context] - Additional context for users
+ * @returns {string} Formatted and potentially truncated string
  *
- * @param items - Array of items that might need truncation
- * @param formatter - Function to format each item as a string
- * @param currentOffset - Current pagination offset
- * @param context - Additional context for users
- * @returns Formatted and potentially truncated string
+ * @example
+ * const output = truncateArray(agents, (agent, i) => `${i}. ${agent.name}\n`, 0);
  */
 export function truncateArray(items, formatter, currentOffset = 0, context) {
     let result = "";
@@ -46,11 +58,17 @@ export function truncateArray(items, formatter, currentOffset = 0, context) {
     return result;
 }
 /**
- * Safely truncates a string in the middle, preserving start and end
+ * Safely truncates a string in the middle, preserving start and end.
+ * @description Useful for displaying long strings (like URLs) in limited space
+ * while showing both the beginning and end.
  *
- * @param content - Content to truncate
- * @param maxLength - Maximum length
- * @returns Truncated string with "..." indicator
+ * @param {string} content - Content to truncate
+ * @param {number} maxLength - Maximum length of output string
+ * @returns {string} Truncated string with "..." indicator in the middle
+ *
+ * @example
+ * truncateMiddle("https://example.com/very/long/path/to/resource", 30);
+ * // Returns: "https://examp...to/resource"
  */
 export function truncateMiddle(content, maxLength) {
     if (content.length <= maxLength) {
@@ -62,11 +80,17 @@ export function truncateMiddle(content, maxLength) {
     return `${start}...${end}`;
 }
 /**
- * Formats a large JSON object with optional truncation
+ * Formats a large JSON object with optional truncation.
+ * @description Converts any object to pretty-printed JSON, automatically
+ * truncating if the result exceeds CHARACTER_LIMIT.
+ *
+ * @param {unknown} obj - Object to format as JSON
+ * @param {number} [indent=2] - Number of spaces for indentation
+ * @returns {string} JSON string, potentially truncated with guidance
  *
- * @param obj - Object to format
- * @param indent - Indentation spaces (default: 2)
- * @returns JSON string, potentially truncated
+ * @example
+ * const json = formatJSON({ agents: [...] });
+ * // Returns pretty-printed JSON, truncated if over 25000 chars
  */
 export function formatJSON(obj, indent = 2) {
     const json = JSON.stringify(obj, null, indent);

package/dist/utils/truncation.js.map

@@ -1 +1 @@
-{"version":3,"file":"truncation.js","sourceRoot":"","sources":["../../src/utils/truncation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,OAAgB;IAChE,IAAI,OAAO,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC;QACtC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,OAAO,IAAI,0DAA0D,CAAC;IAEvF,OAAO,GAAG,SAAS,qCAAqC,eAAe,gBAAgB,QAAQ,GAAG,CAAC;AACrG,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAU,EACV,SAA6C,EAC7C,gBAAwB,CAAC,EACzB,OAAgB;IAEhB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAEzC,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;YACvD,MAAM,UAAU,GAAG,aAAa,GAAG,KAAK,CAAC;YACzC,MAAM,QAAQ,GAAG,OAAO,IAAI,cAAc,UAAU,6CAA6C,CAAC;YAClG,MAAM,IAAI,qCAAqC,eAAe,gBAAgB,QAAQ,GAAG,CAAC;YAC1F,MAAM;QACR,CAAC;QAED,MAAM,IAAI,SAAS,CAAC;QACpB,KAAK,EAAE,CAAC;IACV,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,SAAiB;IAC/D,IAAI,OAAO,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IAE3D,OAAO,GAAG,KAAK,MAAM,GAAG,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,GAAY,EAAE,SAAiB,CAAC;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAE/C,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;QAClC,OAAO,gBAAgB,CAAC,IAAI,EAAE,8EAA8E,CAAC,CAAC;IAChH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"truncation.js","sourceRoot":"","sources":["../../src/utils/truncation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,OAAgB;IAChE,IAAI,OAAO,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC;QACtC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,OAAO,IAAI,0DAA0D,CAAC;IAEvF,OAAO,GAAG,SAAS,qCAAqC,eAAe,gBAAgB,QAAQ,GAAG,CAAC;AACrG,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAU,EACV,SAA6C,EAC7C,gBAAwB,CAAC,EACzB,OAAgB;IAEhB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAEzC,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;YACvD,MAAM,UAAU,GAAG,aAAa,GAAG,KAAK,CAAC;YACzC,MAAM,QAAQ,GAAG,OAAO,IAAI,cAAc,UAAU,6CAA6C,CAAC;YAClG,MAAM,IAAI,qCAAqC,eAAe,gBAAgB,QAAQ,GAAG,CAAC;YAC1F,MAAM;QACR,CAAC;QAED,MAAM,IAAI,SAAS,CAAC;QACpB,KAAK,EAAE,CAAC;IACV,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,SAAiB;IAC/D,IAAI,OAAO,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IAE3D,OAAO,GAAG,KAAK,MAAM,GAAG,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAC,GAAY,EAAE,SAAiB,CAAC;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAE/C,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;QAClC,OAAO,gBAAgB,CAAC,IAAI,EAAE,8EAA8E,CAAC,CAAC;IAChH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elevenlabs-voice-agent-mcp",
-  "version": "1.0.14",
+  "version": "1.1.0",
   "description": "MCP server for ElevenLabs Voice Agent Development",
   "type": "module",
   "main": "dist/index.js",
@@ -34,8 +34,12 @@
     "dev": "tsx watch src/index.ts",
     "build": "tsc && chmod +x dist/index.js",
     "clean": "rm -rf dist",
-    "test": "npm run test:all",
-    "test:all": "npm run test:startup && npm run test:api && npm run test:mcp && npm run test:tools",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:ui": "vitest --ui",
+    "test:types": "tsc --noEmit -p tsconfig.test.json",
+    "test:integration": "npm run test:startup && npm run test:api && npm run test:mcp && npm run test:tools",
     "test:startup": "tsx test/test-server-startup.ts",
     "test:api": "tsx test/test-api-connection.ts",
     "test:mcp": "tsx test/mcp-client-test.ts",
@@ -53,8 +57,10 @@
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
+    "@vitest/coverage-v8": "^4.0.16",
     "dotenv": "^17.2.3",
     "tsx": "^4.19.2",
-    "typescript": "^5.7.2"
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.16"
   }
 }