Fix tests

Author: h3xxit

packages/core/README.md

@@ -11,7 +11,7 @@ The `@utcp/sdk` package provides the fundamental components and interfaces for t
 ### Core Components
 
 *   **UtcpClient**: The main client for interacting with the UTCP ecosystem
-    *   Automatic plugin registration for official protocols (HTTP, MCP, Text, CLI)
+    *   Plugin-based protocol support (HTTP, MCP, Text, File, CLI, etc.)
     *   Manual and tool registration/deregistration
     *   Tool search with name, tag, and description matching
     *   Tool execution across multiple protocols
@@ -47,14 +47,15 @@ bun add @utcp/sdk
 
 ### Basic Usage
 
-Plugins are **automatically registered** when you import the UtcpClient:
+**Important:** Plugins must be explicitly imported to register their protocols:
 
 ```typescript
 import { UtcpClient } from '@utcp/sdk';
+import '@utcp/http';  // Auto-registers HTTP protocol
 import { HttpCallTemplateSerializer } from '@utcp/http';
 
 async function main() {
-  // Create client - official plugins auto-register
+  // Create client
   const serializer = new HttpCallTemplateSerializer();
   const apiTemplate = serializer.validateDict({
     name: 'api_manual',
@@ -88,6 +89,7 @@ async function main() {
 
 ```typescript
 import { UtcpClient } from '@utcp/sdk';
+import '@utcp/dotenv-loader';  // Required for .env file support
 
 const client = await UtcpClient.create(process.cwd(), {
   load_variables_from: [
@@ -239,11 +241,47 @@ All lookups use the namespaced key: `{namespace}_VARIABLE_NAME`
 
 ## Plugin System
 
-### Automatic Registration
+### Available Plugins
 
-Official plugins (HTTP, MCP, Text, CLI) are automatically registered when you import `UtcpClient`. The plugin loader in `@utcp/sdk` tries to discover and register available plugins.
+UTCP provides several optional protocol plugins:
 
-### Manual Registration
+**Browser-Compatible:**
+- `@utcp/http` - HTTP/HTTPS requests with full authentication support
+- `@utcp/text` - Direct text/string content (inline UTCP manuals or OpenAPI specs)
+- `@utcp/direct-call` - Direct function calls
+
+**Node.js Only:**
+- `@utcp/file` - File system access for loading manuals from local files
+- `@utcp/mcp` - Model Context Protocol support
+- `@utcp/cli` - CLI command execution
+- `@utcp/dotenv-loader` - Load variables from .env files
+
+### Explicit Plugin Import
+
+Each plugin must be **explicitly imported** to register its protocol:
+
+```typescript
+// Browser application - only import browser-compatible plugins
+import { UtcpClient } from '@utcp/sdk';
+import '@utcp/http';
+import '@utcp/text';
+import '@utcp/direct-call';
+
+// Node.js application - can use all plugins
+import { UtcpClient } from '@utcp/sdk';
+import '@utcp/http';
+import '@utcp/mcp';
+import '@utcp/file';
+import '@utcp/dotenv-loader';
+```
+
+This explicit import approach ensures:
+- ✅ Browser bundles only include what you use
+- ✅ No Node.js dependencies in browser builds
+- ✅ Perfect tree-shaking for minimal bundle sizes
+- ✅ Clear, explicit dependencies
+
+### Custom Plugin Registration
 
 For custom or third-party plugins:
 

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utcp/sdk",
-  "version": "1.0.11",
+  "version": "1.0.14",
   "description": "Universal Tool Calling Protocol SDK",
   "main": "dist/index.cjs",
   "module": "dist/index.js",

packages/core/src/implementations/tag_search_strategy.ts

@@ -92,31 +92,59 @@ export class TagSearchStrategy implements ToolSearchStrategy {
           }
 
           const tagWords = new Set(tagLower.match(/\w+/g) || []);
+          
+          // Exact word matches
           for (const word of tagWords) {
             if (queryWords.has(word)) {
               score += this.tagWeight * 0.5;
             }
           }
+          
+          // Partial/substring word matches (e.g., "author" matches "authors")
+          for (const queryWord of queryWords) {
+            if (queryWord.length > 2) {
+              for (const tagWord of tagWords) {
+                if (tagWord.length > 2 && (tagWord.includes(queryWord) || queryWord.includes(tagWord))) {
+                  score += this.tagWeight * 0.3; // Lower weight for partial matches in tags
+                  break; // Only count once per query word
+                }
+              }
+            }
+          }
         }
       }
 
       if (tool.description) {
+        const descriptionLower = tool.description.toLowerCase();
         const descriptionWords = new Set(
-          tool.description.toLowerCase().match(/\w+/g) || []
+          descriptionLower.match(/\w+/g) || []
         );
+        
+        // Exact word matches
         for (const word of descriptionWords) {
           if (queryWords.has(word) && word.length > 2) {
             score += this.descriptionWeight;
           }
         }
+        
+        // Partial/substring word matches (e.g., "author" matches "authors")
+        for (const queryWord of queryWords) {
+          if (queryWord.length > 2) {
+            for (const descWord of descriptionWords) {
+              if (descWord.length > 2 && (descWord.includes(queryWord) || queryWord.includes(descWord))) {
+                score += this.descriptionWeight * 0.5; // Lower weight for partial matches
+                break; // Only count once per query word
+              }
+            }
+          }
+        }
       }
 
       return { tool, score };
     });
 
     const sortedTools = toolScores
       .sort((a, b) => b.score - a.score)
-      .filter(item => item.score > 0)
       .map(item => item.tool);
 
     return limit > 0 ? sortedTools.slice(0, limit) : sortedTools;

packages/core/src/plugins/plugin_loader.ts

@@ -42,102 +42,32 @@ function _registerCorePlugins(): void {
 }
 
 /**
- * Attempts to auto-register optional UTCP plugins (HTTP, MCP, Text, File, Direct Call, CLI, DotEnv Loader, etc.)
- * if they are available in the project. This is a best-effort approach that
- * silently ignores plugins that are not installed.
- */
-function _tryRegisterOptionalPlugins(): void {
-  // Try to register HTTP plugin
-  try {
-    const httpPlugin = require('@utcp/http');
-    if (httpPlugin && typeof httpPlugin.register === 'function') {
-      httpPlugin.register();
-    }
-  } catch (e) {
-    // HTTP plugin not available, skip
-  }
-
-  // Try to register MCP plugin
-  try {
-    const mcpPlugin = require('@utcp/mcp');
-    if (mcpPlugin && typeof mcpPlugin.register === 'function') {
-      mcpPlugin.register();
-    }
-  } catch (e) {
-    // MCP plugin not available, skip
-  }
-
-  // Try to register Text plugin
-  try {
-    const textPlugin = require('@utcp/text');
-    if (textPlugin && typeof textPlugin.register === 'function') {
-      textPlugin.register();
-    }
-  } catch (e) {
-    // Text plugin not available, skip
-  }
-
-  // Try to register File plugin
-  try {
-    const filePlugin = require('@utcp/file');
-    if (filePlugin && typeof filePlugin.register === 'function') {
-      filePlugin.register();
-    }
-  } catch (e) {
-    // File plugin not available, skip
-  }
-
-  // Try to register Direct Call plugin
-  try {
-    const directCallPlugin = require('@utcp/direct-call');
-    if (directCallPlugin && typeof directCallPlugin.register === 'function') {
-      directCallPlugin.register();
-    }
-  } catch (e) {
-    // Direct Call plugin not available, skip
-  }
-
-  // Try to register CLI plugin
-  try {
-    const cliPlugin = require('@utcp/cli');
-    if (cliPlugin && typeof cliPlugin.register === 'function') {
-      cliPlugin.register();
-    }
-  } catch (e) {
-    // CLI plugin not available, skip
-  }
-
-  // Try to register DotEnv Loader plugin
-  try {
-    const dotenvLoaderPlugin = require('@utcp/dotenv-loader');
-    if (dotenvLoaderPlugin && typeof dotenvLoaderPlugin.register === 'function') {
-      dotenvLoaderPlugin.register();
-    }
-  } catch (e) {
-    // DotEnv Loader plugin not available, skip
-  }
-
-  // Try to register String plugin
-  try {
-    const stringPlugin = require('@utcp/string');
-    if (stringPlugin && typeof stringPlugin.register === 'function') {
-      stringPlugin.register();
-    }
-  } catch (e) {
-    // String plugin not available, skip
-  }
-}
-
-/**
- * Ensures that all core UTCP plugins (default repository, search strategy,
- * and post-processors) are registered with the plugin registry.
- * This function should be called once at application startup.
+ * Ensures that all core UTCP plugins (auth serializers, default repository, 
+ * search strategy, and post-processors) are registered with the plugin registry.
+ * 
+ * This function is called automatically when needed and should not be called manually.
+ * 
+ * Note: Optional plugins like HTTP, MCP, Text, File, etc. are NOT auto-registered.
+ * Users must explicitly import the plugins they need:
+ * 
+ * @example
+ * // Browser application
+ * import { UtcpClient } from '@utcp/sdk';
+ * import '@utcp/http';     // Auto-registers HTTP protocol
+ * import '@utcp/text';     // Auto-registers text content protocol
+ * 
+ * @example
+ * // Node.js application
+ * import { UtcpClient } from '@utcp/sdk';
+ * import '@utcp/http';
+ * import '@utcp/mcp';
+ * import '@utcp/file';
+ * import '@utcp/dotenv-loader';
  */
 export function ensureCorePluginsInitialized(): void {
   if (!corePluginsInitialized && !initializing) {
     initializing = true;
     _registerCorePlugins();
-    _tryRegisterOptionalPlugins();
     corePluginsInitialized = true;
     initializing = false;
   }

packages/file/tests/file_communication_protocol.test.ts

@@ -5,7 +5,7 @@ import path from 'path';
 // Import from package indices to trigger auto-registration
 import { FileCommunicationProtocol, FileCallTemplate } from "@utcp/file";
 import "@utcp/http"; // Needed for OpenAPI conversion
-import { IUtcpClient } from "@utcp/sdk";
+import { IUtcpClient, ApiKeyAuth } from "@utcp/sdk";
 
 const tempFiles: string[] = [];
 const mockClient = {} as IUtcpClient;
@@ -145,9 +145,9 @@ describe("FileCommunicationProtocol", () => {
         auth_tools: {
           auth_type: 'api_key',
           var_name: 'X-API-Key',
-          api_key_value: '${API_KEY}',
-          in: 'header'
-        }
+          api_key: '${API_KEY}',
+          location: 'header'
+        } as ApiKeyAuth
       };
 
       const result = await protocol.registerManual(mockClient, callTemplate);

packages/http/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utcp/http",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "description": "HTTP utilities for UTCP",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -43,7 +43,7 @@
     }
   },
   "dependencies": {
-    "@utcp/sdk": "^1.0.11",
+    "@utcp/sdk": "^1.0.14",
     "axios": "^1.11.0",
     "js-yaml": "^4.1.0"
   },

packages/http/src/index.ts

@@ -10,7 +10,6 @@ import { SseCallTemplateSerializer } from './sse_call_template';
 import { HttpCommunicationProtocol } from './http_communication_protocol';
 import { StreamableHttpCommunicationProtocol } from './streamable_http_communication_protocol';
 import { SseCommunicationProtocol } from './sse_communication_protocol';
-import { OpenApiConverter, OpenApiConverterOptions } from './openapi_converter';
 
 /**
  * Registers all HTTP-based protocol CallTemplate serializers
@@ -42,4 +41,5 @@ export * from './streamable_http_call_template';
 export * from './streamable_http_communication_protocol';
 export * from './sse_call_template';
 export * from './sse_communication_protocol';
-export { OpenApiConverter, OpenApiConverterOptions } from './openapi_converter';
+export { OpenApiConverter } from './openapi_converter';
+export type { OpenApiConverterOptions } from './openapi_converter';