@toolplex/client 0.1.1 → 0.1.3

package/dist/mcp-server/toolHandlers/listToolsHandler.js

@@ -1,7 +1,7 @@
-import { FileLogger } from '../../shared/fileLogger.js';
-import { findServerManagerClient } from './serverManagerUtils.js';
-import { ListToolsResultSchema, ListAllToolsResultSchema, } from '../../shared/serverManagerTypes.js';
-import Registry from '../registry.js';
+import { FileLogger } from "../../shared/fileLogger.js";
+import { findServerManagerClient } from "./serverManagerUtils.js";
+import { ListToolsResultSchema, ListAllToolsResultSchema, } from "../../shared/serverManagerTypes.js";
+import Registry from "../registry.js";
 const logger = FileLogger;
 export async function handleListTools(params) {
     const startTime = Date.now();
@@ -11,14 +11,16 @@ export async function handleListTools(params) {
     const policyEnforcer = Registry.getPolicyEnforcer();
     try {
         const server_id = params.server_id;
-        let response = '';
+        let response = "";
         if (server_id) {
             // Check if server is blocked using policy enforcer
             policyEnforcer.enforceUseServerPolicy(server_id);
             await logger.debug(`Listing tools for specific server: ${server_id}`);
             const client = await findServerManagerClient(server_id, serverManagerClients);
-            const response_data = await client.sendRequest('list_tools', { server_id: server_id });
-            if ('error' in response_data) {
+            const response_data = await client.sendRequest("list_tools", {
+                server_id: server_id,
+            });
+            if ("error" in response_data) {
                 throw new Error(`Failed to list tools for server_id ${server_id}, error message: ${response_data.error.message}`);
             }
             const parsed = ListToolsResultSchema.safeParse(response_data);
@@ -26,11 +28,11 @@ export async function handleListTools(params) {
                 throw new Error(`Invalid response from server manager: ${parsed.error}`);
             }
             response = promptsCache
-                .getPrompt('list_tools_server_header')
-                .replace('{SERVER_ID}', parsed.data.server_id)
-                .replace('{SERVER_NAME}', parsed.data.server_name);
+                .getPrompt("list_tools_server_header")
+                .replace("{SERVER_ID}", parsed.data.server_id)
+                .replace("{SERVER_NAME}", parsed.data.server_name);
             if (!parsed.data.tools || parsed.data.tools.length === 0) {
-                response += promptsCache.getPrompt('list_tools_empty');
+                response += promptsCache.getPrompt("list_tools_empty");
             }
             else {
                 parsed.data.tools.forEach((tool) => {
@@ -40,10 +42,10 @@ export async function handleListTools(params) {
             }
         }
         else {
-            await logger.debug('Listing tools from all installed servers');
-            response = promptsCache.getPrompt('list_tools_all_header');
+            await logger.debug("Listing tools from all installed servers");
+            response = promptsCache.getPrompt("list_tools_all_header");
             for (const [runtime, client] of Object.entries(serverManagerClients)) {
-                const response_data = await client.sendRequest('list_all_tools', {});
+                const response_data = await client.sendRequest("list_all_tools", {});
                 if (response_data.error) {
                     continue;
                 }
@@ -62,16 +64,16 @@ export async function handleListTools(params) {
                             response += `- ${tool.name}: ${tool.description}\n`;
                             response += `  Input Schema: ${JSON.stringify(tool.inputSchema, null, 2)}\n\n`;
                         });
-                        response += '\n';
+                        response += "\n";
                     }
                 }
             }
-            if (response === promptsCache.getPrompt('list_tools_all_header')) {
-                response += promptsCache.getPrompt('list_tools_empty');
+            if (response === promptsCache.getPrompt("list_tools_all_header")) {
+                response += promptsCache.getPrompt("list_tools_empty");
             }
         }
-        await logger.debug('Successfully retrieved tools list');
-        await telemetryLogger.log('client_list_tools', {
+        await logger.debug("Successfully retrieved tools list");
+        await telemetryLogger.log("client_list_tools", {
             success: true,
             log_context: {
                 server_id: params.server_id,
@@ -79,19 +81,21 @@ export async function handleListTools(params) {
             latency_ms: Date.now() - startTime,
         });
         return {
-            role: 'system',
+            role: "system",
             content: [
                 {
-                    type: 'text',
+                    type: "text",
                     text: response,
                 },
             ],
         };
     }
     catch (error) {
-        const errorMessage = error instanceof Error ? error.message : promptsCache.getPrompt('unexpected_error');
+        const errorMessage = error instanceof Error
+            ? error.message
+            : promptsCache.getPrompt("unexpected_error");
         await logger.error(`Failed to list tools: ${errorMessage}`);
-        await telemetryLogger.log('client_list_tools', {
+        await telemetryLogger.log("client_list_tools", {
             success: false,
             log_context: {
                 server_id: params.server_id,
@@ -100,11 +104,13 @@ export async function handleListTools(params) {
             latency_ms: Date.now() - startTime,
         });
         return {
-            role: 'system',
+            role: "system",
             content: [
                 {
-                    type: 'text',
-                    text: promptsCache.getPrompt('list_tools_failure').replace('{ERROR}', errorMessage),
+                    type: "text",
+                    text: promptsCache
+                        .getPrompt("list_tools_failure")
+                        .replace("{ERROR}", errorMessage),
                 },
             ],
         };

package/dist/mcp-server/toolHandlers/logPlaybookUsageHandler.d.ts

@@ -1,3 +1,3 @@
-import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { LogPlaybookUsageParams } from '../../shared/mcpServerTypes.js';
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { LogPlaybookUsageParams } from "../../shared/mcpServerTypes.js";
 export declare function handleLogPlaybookUsage(params: LogPlaybookUsageParams): Promise<CallToolResult>;

package/dist/mcp-server/toolHandlers/logPlaybookUsageHandler.js

@@ -1,5 +1,5 @@
-import { FileLogger } from '../../shared/fileLogger.js';
-import Registry from '../registry.js';
+import { FileLogger } from "../../shared/fileLogger.js";
+import Registry from "../registry.js";
 const logger = FileLogger;
 export async function handleLogPlaybookUsage(params) {
     const startTime = Date.now();
@@ -13,14 +13,14 @@ export async function handleLogPlaybookUsage(params) {
     const clientContext = Registry.getClientContext();
     try {
         // Check if the client is in restricted mode
-        if (clientContext.clientMode === 'restricted') {
-            throw new Error('Playbook functionality is disabled in restricted mode.');
+        if (clientContext.clientMode === "restricted") {
+            throw new Error("Playbook functionality is disabled in restricted mode.");
         }
         // Enforce playbook usage logging policy
         policyEnforcer.enforceLogPlaybookUsagePolicy();
         await apiService.logPlaybookUsage(playbook_id, success, error_message);
-        await logger.info('Playbook usage logged successfully');
-        await telemetryLogger.log('client_log_playbook_usage', {
+        await logger.info("Playbook usage logged successfully");
+        await telemetryLogger.log("client_log_playbook_usage", {
             success: true,
             log_context: {
                 playbook_id,
@@ -29,11 +29,11 @@ export async function handleLogPlaybookUsage(params) {
             latency_ms: Date.now() - startTime,
         });
         return {
-            role: 'system',
+            role: "system",
             content: [
                 {
-                    type: 'text',
-                    text: promptsCache.getPrompt('log_playbook_usage_success'),
+                    type: "text",
+                    text: promptsCache.getPrompt("log_playbook_usage_success"),
                 },
             ],
         };
@@ -41,7 +41,7 @@ export async function handleLogPlaybookUsage(params) {
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         await logger.error(`Failed to log playbook usage: ${errorMessage}`);
-        await telemetryLogger.log('client_log_playbook_usage', {
+        await telemetryLogger.log("client_log_playbook_usage", {
             success: false,
             log_context: {
                 playbook_id,
@@ -51,13 +51,13 @@ export async function handleLogPlaybookUsage(params) {
             latency_ms: Date.now() - startTime,
         });
         return {
-            role: 'system',
+            role: "system",
             content: [
                 {
-                    type: 'text',
+                    type: "text",
                     text: promptsCache
-                        .getPrompt('log_playbook_usage_failure')
-                        .replace('{ERROR}', errorMessage),
+                        .getPrompt("log_playbook_usage_failure")
+                        .replace("{ERROR}", errorMessage),
                 },
             ],
         };

package/dist/mcp-server/toolHandlers/lookupEntityHandler.d.ts

@@ -1,3 +1,3 @@
-import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { LookupEntityParams } from '../../shared/mcpServerTypes.js';
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { LookupEntityParams } from "../../shared/mcpServerTypes.js";
 export declare function handleLookupEntityTool(params: LookupEntityParams): Promise<CallToolResult>;

package/dist/mcp-server/toolHandlers/lookupEntityHandler.js

@@ -1,6 +1,6 @@
-import { FileLogger } from '../../shared/fileLogger.js';
-import Registry from '../registry.js';
-import { annotateInstalledServer } from '../utils/resultAnnotators.js';
+import { FileLogger } from "../../shared/fileLogger.js";
+import Registry from "../registry.js";
+import { annotateInstalledServer } from "../utils/resultAnnotators.js";
 const logger = FileLogger;
 export async function handleLookupEntityTool(params) {
     const startTime = Date.now();
@@ -13,17 +13,17 @@ export async function handleLookupEntityTool(params) {
     const clientContext = Registry.getClientContext();
     try {
         // Check if the client is in restricted mode
-        if (clientContext.clientMode === 'restricted') {
-            throw new Error('Lookup functionality is disabled in restricted mode.');
+        if (clientContext.clientMode === "restricted") {
+            throw new Error("Lookup functionality is disabled in restricted mode.");
         }
         // Enforce blocked server policy if looking up a server
-        if (params.entity_type === 'server') {
+        if (params.entity_type === "server") {
             policyEnforcer.enforceUseServerPolicy(params.entity_id);
         }
         let lookupResponse = await apiService.lookupEntity(params.entity_type, params.entity_id);
         if (!lookupResponse) {
-            await logger.debug('No entity found');
-            await telemetryLogger.log('client_lookup_entity', {
+            await logger.debug("No entity found");
+            await telemetryLogger.log("client_lookup_entity", {
                 success: true,
                 log_context: {
                     entity_type: params.entity_type,
@@ -32,20 +32,22 @@ export async function handleLookupEntityTool(params) {
                 latency_ms: Date.now() - startTime,
             });
             return {
-                role: 'system',
+                role: "system",
                 content: [
                     {
-                        type: 'text',
+                        type: "text",
                         text: promptsCache
-                            .getPrompt('lookup_entity_not_found')
-                            .replace('{entity_type}', params.entity_type)
-                            .replace('{entity_id}', params.entity_id),
+                            .getPrompt("lookup_entity_not_found")
+                            .replace("{entity_type}", params.entity_type)
+                            .replace("{entity_id}", params.entity_id),
                     },
                 ],
             };
         }
         // Use resultAnnotators to annotate if the server is installed
-        if (params.entity_type === 'server' && lookupResponse && typeof lookupResponse === 'object') {
+        if (params.entity_type === "server" &&
+            lookupResponse &&
+            typeof lookupResponse === "object") {
             try {
                 lookupResponse = annotateInstalledServer(lookupResponse, serversCache);
             }
@@ -57,9 +59,9 @@ export async function handleLookupEntityTool(params) {
         await logger.debug(`Found entity: ${JSON.stringify(lookupResponse)}`);
         let response = `Found ${params.entity_type}:\n`;
         response += JSON.stringify(lookupResponse, null, 2);
-        response += '\n';
-        await logger.debug('Lookup completed successfully');
-        await telemetryLogger.log('client_lookup_entity', {
+        response += "\n";
+        await logger.debug("Lookup completed successfully");
+        await telemetryLogger.log("client_lookup_entity", {
             success: true,
             log_context: {
                 entity_type: params.entity_type,
@@ -69,25 +71,25 @@ export async function handleLookupEntityTool(params) {
         });
         const content = [
             {
-                type: 'text',
+                type: "text",
                 text: response,
             },
         ];
-        if (params.entity_type === 'server') {
+        if (params.entity_type === "server") {
             content.push({
-                type: 'text',
-                text: promptsCache.getPrompt('lookup_entity_install_guidance'),
+                type: "text",
+                text: promptsCache.getPrompt("lookup_entity_install_guidance"),
             });
         }
         return {
-            role: 'system',
+            role: "system",
             content,
         };
     }
     catch (err) {
         const errorMessage = err instanceof Error ? err.message : String(err);
         await logger.error(`Error looking up entity: ${errorMessage}`);
-        await telemetryLogger.log('client_lookup_entity', {
+        await telemetryLogger.log("client_lookup_entity", {
             success: false,
             log_context: {
                 entity_type: params.entity_type,
@@ -97,14 +99,14 @@ export async function handleLookupEntityTool(params) {
             latency_ms: Date.now() - startTime,
         });
         return {
-            role: 'system',
+            role: "system",
             content: [
                 {
-                    type: 'text',
+                    type: "text",
                     text: promptsCache
-                        .getPrompt('lookup_entity_error')
-                        .replace('{entity_type}', params.entity_type)
-                        .replace('{ERROR}', errorMessage),
+                        .getPrompt("lookup_entity_error")
+                        .replace("{entity_type}", params.entity_type)
+                        .replace("{ERROR}", errorMessage),
                 },
             ],
         };

package/dist/mcp-server/toolHandlers/savePlaybookHandler.d.ts

@@ -1,3 +1,3 @@
-import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { SavePlaybookParams } from '../../shared/mcpServerTypes.js';
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { SavePlaybookParams } from "../../shared/mcpServerTypes.js";
 export declare function handleSavePlaybook(params: SavePlaybookParams): Promise<CallToolResult>;

package/dist/mcp-server/toolHandlers/savePlaybookHandler.js

@@ -1,9 +1,9 @@
-import { FileLogger } from '../../shared/fileLogger.js';
-import Registry from '../registry.js';
+import { FileLogger } from "../../shared/fileLogger.js";
+import Registry from "../registry.js";
 const logger = FileLogger;
 export async function handleSavePlaybook(params) {
     const startTime = Date.now();
-    await logger.info('Handling save playbook request');
+    await logger.info("Handling save playbook request");
     await logger.debug(`Playbook params: ${JSON.stringify(params)}`);
     const apiService = Registry.getToolplexApiService();
     const telemetryLogger = Registry.getTelemetryLogger();
@@ -12,19 +12,19 @@ export async function handleSavePlaybook(params) {
     const clientContext = Registry.getClientContext();
     try {
         // Check if the client is in restricted mode
-        if (clientContext.clientMode === 'restricted') {
-            throw new Error('Playbook functionality is disabled in restricted mode.');
+        if (clientContext.clientMode === "restricted") {
+            throw new Error("Playbook functionality is disabled in restricted mode.");
         }
         // Check if read-only mode is enabled
         if (clientContext.permissions.enable_read_only_mode) {
-            throw new Error('Saving playbooks is disabled in read-only mode');
+            throw new Error("Saving playbooks is disabled in read-only mode");
         }
         // Enforce playbook policy before saving
         policyEnforcer.enforceSavePlaybookPolicy(params);
         const { description, actions, domain, keywords, requirements, source_playbook_id, fork_reason, } = params;
         const response = await apiService.createPlaybook(description, actions, domain, keywords, requirements, source_playbook_id, fork_reason);
         await logger.info(`Playbook created successfully with ID: ${response.id}`);
-        await telemetryLogger.log('client_save_playbook', {
+        await telemetryLogger.log("client_save_playbook", {
             success: true,
             log_context: {
                 playbook_id: response.id,
@@ -33,13 +33,13 @@ export async function handleSavePlaybook(params) {
             latency_ms: Date.now() - startTime,
         });
         return {
-            role: 'system',
+            role: "system",
             content: [
                 {
-                    type: 'text',
+                    type: "text",
                     text: promptsCache
-                        .getPrompt('save_playbook_success')
-                        .replace('{PLAYBOOK_ID}', response.id),
+                        .getPrompt("save_playbook_success")
+                        .replace("{PLAYBOOK_ID}", response.id),
                 },
             ],
         };
@@ -47,17 +47,19 @@ export async function handleSavePlaybook(params) {
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         await logger.error(`Failed to create playbook: ${errorMessage}`);
-        await telemetryLogger.log('client_save_playbook', {
+        await telemetryLogger.log("client_save_playbook", {
             success: false,
             pii_sanitized_error_message: errorMessage,
             latency_ms: Date.now() - startTime,
         });
         return {
-            role: 'system',
+            role: "system",
             content: [
                 {
-                    type: 'text',
-                    text: promptsCache.getPrompt('save_playbook_failure').replace('{ERROR}', errorMessage),
+                    type: "text",
+                    text: promptsCache
+                        .getPrompt("save_playbook_failure")
+                        .replace("{ERROR}", errorMessage),
                 },
             ],
         };

package/dist/mcp-server/toolHandlers/searchHandler.d.ts

@@ -1,3 +1,3 @@
-import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { SearchParams } from '../../shared/mcpServerTypes.js';
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { SearchParams } from "../../shared/mcpServerTypes.js";
 export declare function handleSearchTool(params: SearchParams): Promise<CallToolResult>;

package/dist/mcp-server/toolHandlers/searchHandler.js

@@ -1,10 +1,10 @@
-import { FileLogger } from '../../shared/fileLogger.js';
-import Registry from '../registry.js';
-import { annotateInstalledServers } from '../utils/resultAnnotators.js';
+import { FileLogger } from "../../shared/fileLogger.js";
+import Registry from "../registry.js";
+import { annotateInstalledServers } from "../utils/resultAnnotators.js";
 const logger = FileLogger;
 export async function handleSearchTool(params) {
     const startTime = Date.now();
-    await logger.info('Handling search request');
+    await logger.info("Handling search request");
     await logger.debug(`Search params: ${JSON.stringify(params)}`);
     const apiService = Registry.getToolplexApiService();
     const telemetryLogger = Registry.getTelemetryLogger();
@@ -13,26 +13,29 @@ export async function handleSearchTool(params) {
     const clientContext = Registry.getClientContext();
     const query = params.query;
     const expandedKeywords = params.expanded_keywords || [];
-    const filter = params.filter || 'all';
+    const filter = params.filter || "all";
     const size = params.size || 10;
     try {
         // Check if the client is in restricted mode
-        if (clientContext.clientMode === 'restricted') {
-            throw new Error('Search functionality is disabled in restricted mode.');
+        if (clientContext.clientMode === "restricted") {
+            throw new Error("Search functionality is disabled in restricted mode.");
         }
         const results = await apiService.search(query, expandedKeywords, filter, size);
         // Log telemetry event
-        await telemetryLogger.log('client_search', {
+        await telemetryLogger.log("client_search", {
             success: true,
             log_context: {
                 filter,
                 size,
                 num_expanded_keywords: expandedKeywords.length,
-                num_results: (results.mcp_servers?.length ?? -1) + (results.playbooks?.length ?? -1),
+                num_results: (results.mcp_servers?.length ?? -1) +
+                    (results.playbooks?.length ?? -1),
             },
             latency_ms: Date.now() - startTime,
         });
-        const mcpServers = Array.isArray(results.mcp_servers) ? results.mcp_servers : [];
+        const mcpServers = Array.isArray(results.mcp_servers)
+            ? results.mcp_servers
+            : [];
         const playbooks = Array.isArray(results.playbooks) ? results.playbooks : [];
         const totalResults = mcpServers.length + playbooks.length;
         // Annotate installed servers using resultAnnotators
@@ -48,41 +51,41 @@ export async function handleSearchTool(params) {
             }
         }
         if (totalResults === 0) {
-            await logger.info('No search results found');
+            await logger.info("No search results found");
             return {
-                role: 'system',
+                role: "system",
                 content: [
                     {
-                        type: 'text',
-                        text: promptsCache.getPrompt('search_no_results'),
+                        type: "text",
+                        text: promptsCache.getPrompt("search_no_results"),
                     },
                 ],
             };
         }
         await logger.debug(`Found ${totalResults} results`);
-        let response = promptsCache.getPrompt('search_results_header');
+        let response = promptsCache.getPrompt("search_results_header");
         if ((annotatedServers.length ?? 0) > 0) {
-            response += '\n=== Servers ===\n';
+            response += "\n=== Servers ===\n";
             response += JSON.stringify(annotatedServers, null, 2);
-            response += '\n';
+            response += "\n";
         }
         else {
-            response += '\n(No servers found)\n';
+            response += "\n(No servers found)\n";
         }
         if (playbooks.length > 0) {
-            response += '\n=== Playbooks ===\n';
+            response += "\n=== Playbooks ===\n";
             response += JSON.stringify(playbooks, null, 2);
-            response += '\n';
+            response += "\n";
         }
         else {
-            response += '\n(No playbooks found)\n';
+            response += "\n(No playbooks found)\n";
         }
-        await logger.info('Search completed successfully');
+        await logger.info("Search completed successfully");
         return {
-            role: 'system',
+            role: "system",
             content: [
                 {
-                    type: 'text',
+                    type: "text",
                     text: response,
                 },
             ],
@@ -91,7 +94,7 @@ export async function handleSearchTool(params) {
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         await logger.error(`Search failed: ${errorMessage}`);
-        await telemetryLogger.log('client_search', {
+        await telemetryLogger.log("client_search", {
             success: false,
             log_context: {
                 filter,
@@ -102,11 +105,13 @@ export async function handleSearchTool(params) {
             latency_ms: Date.now() - startTime,
         });
         return {
-            role: 'system',
+            role: "system",
             content: [
                 {
-                    type: 'text',
-                    text: promptsCache.getPrompt('unexpected_error').replace('{ERROR}', errorMessage),
+                    type: "text",
+                    text: promptsCache
+                        .getPrompt("unexpected_error")
+                        .replace("{ERROR}", errorMessage),
                 },
             ],
         };

package/dist/mcp-server/toolHandlers/serverManagerUtils.d.ts

@@ -1,2 +1,2 @@
-import { StdioServerManagerClient } from '../../shared/stdioServerManagerClient.js';
+import { StdioServerManagerClient } from "../../shared/stdioServerManagerClient.js";
 export declare function findServerManagerClient(serverId: string, serverManagerClients: Record<string, StdioServerManagerClient>): Promise<StdioServerManagerClient>;

package/dist/mcp-server/toolHandlers/serverManagerUtils.js

@@ -1,7 +1,7 @@
 export async function findServerManagerClient(serverId, serverManagerClients) {
     for (const client of Object.values(serverManagerClients)) {
-        const response = await client.sendRequest('list_servers', {});
-        if ('error' in response) {
+        const response = await client.sendRequest("list_servers", {});
+        if ("error" in response) {
             throw new Error(`Failed to list servers; error message: ${response.error.message}`);
         }
         // Handle both array and object responses

package/dist/mcp-server/toolHandlers/submitFeedbackHandler.d.ts

@@ -1,3 +1,3 @@
-import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { SubmitFeedbackParams } from '../../shared/mcpServerTypes.js';
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { SubmitFeedbackParams } from "../../shared/mcpServerTypes.js";
 export declare function handleSubmitFeedback(params: SubmitFeedbackParams): Promise<CallToolResult>;