@juspay/neurolink 9.26.2 → 9.28.0

package/dist/cli/loop/optionsSchema.js

@@ -82,5 +82,9 @@ export const textGenerationOptionsSchema = {
         type: "boolean",
         description: "Skip injecting tool descriptions into the system prompt. Useful when tool info is already provided.",
     },
+    disableToolCache: {
+        type: "boolean",
+        description: "Disable tool result caching for this request (overrides global mcp.cache.enabled).",
+    },
 };
 //# sourceMappingURL=optionsSchema.js.map

package/dist/core/modules/ToolsManager.js

@@ -318,6 +318,32 @@ export class ToolsManager {
                     const startTime = Date.now();
                     let executionId;
                     try {
+                        // Route through NeuroLink.executeTool() when available for MCP enhancement support
+                        // (cache, middleware, annotations, circuit breaker, routing)
+                        if (this.toolExecutor) {
+                            const result = await this.toolExecutor(toolName, params);
+                            const convertedResult = this.utilities?.convertToolResult
+                                ? await this.utilities.convertToolResult(result)
+                                : result;
+                            const endTime = Date.now();
+                            customToolSpan.setAttribute("tool.duration_ms", endTime - startTime);
+                            let errorResult = undefined;
+                            if (convertedResult &&
+                                typeof convertedResult === "object" &&
+                                "isError" in convertedResult &&
+                                convertedResult.isError) {
+                                try {
+                                    errorResult = JSON.stringify(convertedResult);
+                                }
+                                catch (error) {
+                                    logger.error(`Failed to serialize error result for ${toolName}`, error);
+                                }
+                            }
+                            customToolSpan.setAttribute("tool.result.status", errorResult ? "error" : "success");
+                            customToolSpan.setStatus({ code: SpanStatusCode.OK });
+                            return convertedResult;
+                        }
+                        // Fallback: direct execution (standalone usage without NeuroLink SDK)
                         if (this.neurolink?.emitToolStart) {
                             executionId = this.neurolink.emitToolStart(toolName, params, startTime);
                         }
@@ -350,8 +376,9 @@ export class ToolsManager {
                     catch (error) {
                         const endTime = Date.now();
                         const errorMsg = error instanceof Error ? error.message : String(error);
-                        // Emit tool end event (error)
-                        if (this.neurolink?.emitToolEnd) {
+                        // Emit tool end event (error) — only for fallback path
+                        // When toolExecutor is used, executeTool() handles event emission
+                        if (!this.toolExecutor && this.neurolink?.emitToolEnd) {
                             this.neurolink.emitToolEnd(toolName, undefined, // no result
                             errorMsg, startTime, endTime, executionId);
                             logger.debug(`Custom tool error: ${toolName} (${endTime - startTime}ms)`, { error: errorMsg });

package/dist/index.d.ts

@@ -200,7 +200,8 @@ export declare function createBestAIProvider(requestedProvider?: string, modelNa
  * await writeFile('output.txt', 'Hello from MCP!');
  * ```
  */
-export { CircuitBreakerManager, calculateExpiresAt, createMCPServer, createOAuthProviderFromConfig, DEFAULT_HTTP_RETRY_CONFIG, DEFAULT_RATE_LIMIT_CONFIG, executeMCP, FileTokenStorage, getMCPStats, getServerInfo, globalCircuitBreakerManager, globalRateLimiterManager, HTTPRateLimiter, InMemoryTokenStorage, initializeMCPEcosystem, isRetryableHTTPError, isRetryableStatusCode, isTokenExpired, listMCPs, MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, } from "./mcp/index.js";
+export { CircuitBreakerManager, calculateExpiresAt, createMCPServer, createOAuthProviderFromConfig, DEFAULT_HTTP_RETRY_CONFIG, DEFAULT_RATE_LIMIT_CONFIG, executeMCP, FileTokenStorage, getMCPStats, getServerInfo, globalCircuitBreakerManager, globalRateLimiterManager, HTTPRateLimiter, InMemoryTokenStorage, initializeMCPEcosystem, isRetryableHTTPError, isRetryableStatusCode, isTokenExpired, listMCPs, MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, MCPToolRegistry, ExternalServerManager, MCPClientFactory, ToolRouter, createToolRouter, DEFAULT_ROUTER_CONFIG, ToolCache, createToolCache, DEFAULT_CACHE_CONFIG, ToolResultCache, createToolResultCache, RequestBatcher, ToolCallBatcher, createRequestBatcher, createToolCallBatcher, DEFAULT_BATCH_CONFIG, inferAnnotations, createAnnotatedTool, validateAnnotations, filterToolsByAnnotations, mergeAnnotations, getAnnotationSummary, requiresConfirmation, isSafeToRetry, getToolSafetyLevel, ElicitationManager, globalElicitationManager, EnhancedToolDiscovery, MCPRegistryClient, globalMCPRegistryClient, getWellKnownServer, getAllWellKnownServers, MCPServerBase, MultiServerManager, globalMultiServerManager, AgentExposureManager, exposeAgentAsTool, exposeAgentsAsTools, exposeWorkflowAsTool, exposeWorkflowsAsTools, globalAgentExposureManager, ServerCapabilitiesManager, createTextResource, createJsonResource, createPrompt, neuroLinkToolToMCP, mcpToolToNeuroLink, batchConvertToMCP, batchConvertToNeuroLink, sanitizeToolName, validateToolName, createToolFromFunction, mcpProtocolToolToServerTool, serverToolToMCPProtocol, TOOL_COMPATIBILITY, ToolIntegrationManager, globalToolIntegrationManager, wrapToolWithElicitation, wrapToolsWithElicitation, createElicitationContext, confirmationMiddleware, validationMiddleware, loggingMiddleware, createRetryMiddleware, createTimeoutMiddleware, createToolMiddlewareChain, ElicitationProtocolAdapter, globalElicitationProtocol, isElicitationProtocolMessage, protocolMessageToElicitation, elicitationResponseToProtocol, createElicitationRequest, createElicitationResponse, createElicitationCancel, createTextInputRequest, createSelectRequest, createConfirmationRequest, createFormRequest, } from "./mcp/index.js";
+export type { RoutingStrategy, ToolRouterConfig, RoutingDecision, MCPTool, ToolRouterEvents, AffinityRule, CategoryMapping, RouterServerWeight, CacheStrategy, CacheConfig as MCPCacheConfig, CacheStats, CacheEvents, BatchConfig, BatchResult, BatchExecutor, BatcherEvents, MCPToolAnnotations, MCPServerTool, ToolConverterOptions, MCPProtocolTool, NeuroLinkTool, ToolMiddleware, EnhancedExecutionContext, ToolWrapperOptions, ExposableAgent, ExposableWorkflow, ExposureOptions, ExposureResult, MCPResource, MCPPrompt, ServerCapabilitiesConfig, PromptGenerator, PromptMessage, PromptResult, RegisteredPrompt, RegisteredResource, ResourceContent, ResourceReader, ResourceSubscriptionCallback, RegistryEntry, RegistrySearchOptions, RegistrySearchResult, RegistrySourceType, RegistryConfig, MCPRegistryClientConfig, LoadBalancingStrategy, ServerGroup, UnifiedTool, MultiServerManagerConfig, ServerWeight, MCPServerBaseConfig, MCPServerEvents, EnhancedToolInfo, ToolSearchCriteria, ToolSearchResult, CompatibilityCheckResult, ElicitationType, Elicitation, ElicitationResponse, ElicitationHandler, ElicitationManagerConfig, ElicitationRequest, ElicitationContext, TextElicitation, SelectElicitation, SelectOption, MultiSelectElicitation, ConfirmationElicitation, FileElicitation, SecretElicitation, FormElicitation, FormField, ElicitationProtocolMessage, ElicitationProtocolMessageType, ElicitationProtocolPayload, ElicitationProtocolHandler, ElicitationProtocolAdapterConfig, ElicitationRequestMessage, ElicitationRequestParams, ElicitationResponseMessage, ElicitationResponseParams, ElicitationCancelMessage, ElicitationCancelParams, } from "./mcp/index.js";
 export type { AuthorizationUrlResult, DiscoveredMcp, HTTPRetryConfig, MCPOAuthConfig, McpMetadata, OAuthClientInformation, OAuthTokens as McpOAuthTokens, RateLimitConfig, TokenExchangeRequest, TokenStorage, } from "./types/mcpTypes.js";
 export type { ExecutionContext, ToolExecutionResult, ToolInfo, } from "./types/tools.js";
 export type { LogLevel } from "./types/utilities.js";

package/dist/index.js

@@ -237,7 +237,33 @@ InMemoryTokenStorage,
 // Simplified MCP exports
 initializeMCPEcosystem, isRetryableHTTPError, isRetryableStatusCode, isTokenExpired, listMCPs, 
 // Circuit Breaker
-MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, } from "./mcp/index.js";
+MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, 
+// Core MCP Components
+MCPToolRegistry, ExternalServerManager, MCPClientFactory, 
+// MCP Enhancements - Routing, Caching, Batching
+ToolRouter, createToolRouter, DEFAULT_ROUTER_CONFIG, ToolCache, createToolCache, DEFAULT_CACHE_CONFIG, ToolResultCache, createToolResultCache, RequestBatcher, ToolCallBatcher, createRequestBatcher, createToolCallBatcher, DEFAULT_BATCH_CONFIG, 
+// MCP Enhancements - Tool Annotations
+inferAnnotations, createAnnotatedTool, validateAnnotations, filterToolsByAnnotations, mergeAnnotations, getAnnotationSummary, requiresConfirmation, isSafeToRetry, getToolSafetyLevel, 
+// MCP Enhancements - Elicitation
+ElicitationManager, globalElicitationManager, 
+// MCP Enhancements - Enhanced Tool Discovery
+EnhancedToolDiscovery, 
+// MCP Enhancements - Registry Client
+MCPRegistryClient, globalMCPRegistryClient, getWellKnownServer, getAllWellKnownServers, 
+// MCP Enhancements - Server Base
+MCPServerBase, 
+// MCP Enhancements - Multi-Server Manager
+MultiServerManager, globalMultiServerManager, 
+// MCP Enhancements - Agent Exposure
+AgentExposureManager, exposeAgentAsTool, exposeAgentsAsTools, exposeWorkflowAsTool, exposeWorkflowsAsTools, globalAgentExposureManager, 
+// MCP Enhancements - Server Capabilities
+ServerCapabilitiesManager, createTextResource, createJsonResource, createPrompt, 
+// MCP Enhancements - Tool Converter
+neuroLinkToolToMCP, mcpToolToNeuroLink, batchConvertToMCP, batchConvertToNeuroLink, sanitizeToolName, validateToolName, createToolFromFunction, mcpProtocolToolToServerTool, serverToolToMCPProtocol, TOOL_COMPATIBILITY, 
+// MCP Enhancements - Tool Integration
+ToolIntegrationManager, globalToolIntegrationManager, wrapToolWithElicitation, wrapToolsWithElicitation, createElicitationContext, confirmationMiddleware, validationMiddleware, loggingMiddleware, createRetryMiddleware, createTimeoutMiddleware, createToolMiddlewareChain, 
+// MCP Enhancements - Elicitation Protocol
+ElicitationProtocolAdapter, globalElicitationProtocol, isElicitationProtocolMessage, protocolMessageToElicitation, elicitationResponseToProtocol, createElicitationRequest, createElicitationResponse, createElicitationCancel, createTextInputRequest, createSelectRequest, createConfirmationRequest, createFormRequest, } from "./mcp/index.js";
 export { logger } from "./utils/logger.js";
 export { getPoolStats } from "./utils/redis.js";
 // ============================================================================

package/dist/lib/core/modules/ToolsManager.js

@@ -318,6 +318,32 @@ export class ToolsManager {
                     const startTime = Date.now();
                     let executionId;
                     try {
+                        // Route through NeuroLink.executeTool() when available for MCP enhancement support
+                        // (cache, middleware, annotations, circuit breaker, routing)
+                        if (this.toolExecutor) {
+                            const result = await this.toolExecutor(toolName, params);
+                            const convertedResult = this.utilities?.convertToolResult
+                                ? await this.utilities.convertToolResult(result)
+                                : result;
+                            const endTime = Date.now();
+                            customToolSpan.setAttribute("tool.duration_ms", endTime - startTime);
+                            let errorResult = undefined;
+                            if (convertedResult &&
+                                typeof convertedResult === "object" &&
+                                "isError" in convertedResult &&
+                                convertedResult.isError) {
+                                try {
+                                    errorResult = JSON.stringify(convertedResult);
+                                }
+                                catch (error) {
+                                    logger.error(`Failed to serialize error result for ${toolName}`, error);
+                                }
+                            }
+                            customToolSpan.setAttribute("tool.result.status", errorResult ? "error" : "success");
+                            customToolSpan.setStatus({ code: SpanStatusCode.OK });
+                            return convertedResult;
+                        }
+                        // Fallback: direct execution (standalone usage without NeuroLink SDK)
                         if (this.neurolink?.emitToolStart) {
                             executionId = this.neurolink.emitToolStart(toolName, params, startTime);
                         }
@@ -350,8 +376,9 @@ export class ToolsManager {
                     catch (error) {
                         const endTime = Date.now();
                         const errorMsg = error instanceof Error ? error.message : String(error);
-                        // Emit tool end event (error)
-                        if (this.neurolink?.emitToolEnd) {
+                        // Emit tool end event (error) — only for fallback path
+                        // When toolExecutor is used, executeTool() handles event emission
+                        if (!this.toolExecutor && this.neurolink?.emitToolEnd) {
                             this.neurolink.emitToolEnd(toolName, undefined, // no result
                             errorMsg, startTime, endTime, executionId);
                             logger.debug(`Custom tool error: ${toolName} (${endTime - startTime}ms)`, { error: errorMsg });

package/dist/lib/index.d.ts

@@ -200,7 +200,8 @@ export declare function createBestAIProvider(requestedProvider?: string, modelNa
  * await writeFile('output.txt', 'Hello from MCP!');
  * ```
  */
-export { CircuitBreakerManager, calculateExpiresAt, createMCPServer, createOAuthProviderFromConfig, DEFAULT_HTTP_RETRY_CONFIG, DEFAULT_RATE_LIMIT_CONFIG, executeMCP, FileTokenStorage, getMCPStats, getServerInfo, globalCircuitBreakerManager, globalRateLimiterManager, HTTPRateLimiter, InMemoryTokenStorage, initializeMCPEcosystem, isRetryableHTTPError, isRetryableStatusCode, isTokenExpired, listMCPs, MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, } from "./mcp/index.js";
+export { CircuitBreakerManager, calculateExpiresAt, createMCPServer, createOAuthProviderFromConfig, DEFAULT_HTTP_RETRY_CONFIG, DEFAULT_RATE_LIMIT_CONFIG, executeMCP, FileTokenStorage, getMCPStats, getServerInfo, globalCircuitBreakerManager, globalRateLimiterManager, HTTPRateLimiter, InMemoryTokenStorage, initializeMCPEcosystem, isRetryableHTTPError, isRetryableStatusCode, isTokenExpired, listMCPs, MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, MCPToolRegistry, ExternalServerManager, MCPClientFactory, ToolRouter, createToolRouter, DEFAULT_ROUTER_CONFIG, ToolCache, createToolCache, DEFAULT_CACHE_CONFIG, ToolResultCache, createToolResultCache, RequestBatcher, ToolCallBatcher, createRequestBatcher, createToolCallBatcher, DEFAULT_BATCH_CONFIG, inferAnnotations, createAnnotatedTool, validateAnnotations, filterToolsByAnnotations, mergeAnnotations, getAnnotationSummary, requiresConfirmation, isSafeToRetry, getToolSafetyLevel, ElicitationManager, globalElicitationManager, EnhancedToolDiscovery, MCPRegistryClient, globalMCPRegistryClient, getWellKnownServer, getAllWellKnownServers, MCPServerBase, MultiServerManager, globalMultiServerManager, AgentExposureManager, exposeAgentAsTool, exposeAgentsAsTools, exposeWorkflowAsTool, exposeWorkflowsAsTools, globalAgentExposureManager, ServerCapabilitiesManager, createTextResource, createJsonResource, createPrompt, neuroLinkToolToMCP, mcpToolToNeuroLink, batchConvertToMCP, batchConvertToNeuroLink, sanitizeToolName, validateToolName, createToolFromFunction, mcpProtocolToolToServerTool, serverToolToMCPProtocol, TOOL_COMPATIBILITY, ToolIntegrationManager, globalToolIntegrationManager, wrapToolWithElicitation, wrapToolsWithElicitation, createElicitationContext, confirmationMiddleware, validationMiddleware, loggingMiddleware, createRetryMiddleware, createTimeoutMiddleware, createToolMiddlewareChain, ElicitationProtocolAdapter, globalElicitationProtocol, isElicitationProtocolMessage, protocolMessageToElicitation, elicitationResponseToProtocol, createElicitationRequest, createElicitationResponse, createElicitationCancel, createTextInputRequest, createSelectRequest, createConfirmationRequest, createFormRequest, } from "./mcp/index.js";
+export type { RoutingStrategy, ToolRouterConfig, RoutingDecision, MCPTool, ToolRouterEvents, AffinityRule, CategoryMapping, RouterServerWeight, CacheStrategy, CacheConfig as MCPCacheConfig, CacheStats, CacheEvents, BatchConfig, BatchResult, BatchExecutor, BatcherEvents, MCPToolAnnotations, MCPServerTool, ToolConverterOptions, MCPProtocolTool, NeuroLinkTool, ToolMiddleware, EnhancedExecutionContext, ToolWrapperOptions, ExposableAgent, ExposableWorkflow, ExposureOptions, ExposureResult, MCPResource, MCPPrompt, ServerCapabilitiesConfig, PromptGenerator, PromptMessage, PromptResult, RegisteredPrompt, RegisteredResource, ResourceContent, ResourceReader, ResourceSubscriptionCallback, RegistryEntry, RegistrySearchOptions, RegistrySearchResult, RegistrySourceType, RegistryConfig, MCPRegistryClientConfig, LoadBalancingStrategy, ServerGroup, UnifiedTool, MultiServerManagerConfig, ServerWeight, MCPServerBaseConfig, MCPServerEvents, EnhancedToolInfo, ToolSearchCriteria, ToolSearchResult, CompatibilityCheckResult, ElicitationType, Elicitation, ElicitationResponse, ElicitationHandler, ElicitationManagerConfig, ElicitationRequest, ElicitationContext, TextElicitation, SelectElicitation, SelectOption, MultiSelectElicitation, ConfirmationElicitation, FileElicitation, SecretElicitation, FormElicitation, FormField, ElicitationProtocolMessage, ElicitationProtocolMessageType, ElicitationProtocolPayload, ElicitationProtocolHandler, ElicitationProtocolAdapterConfig, ElicitationRequestMessage, ElicitationRequestParams, ElicitationResponseMessage, ElicitationResponseParams, ElicitationCancelMessage, ElicitationCancelParams, } from "./mcp/index.js";
 export type { AuthorizationUrlResult, DiscoveredMcp, HTTPRetryConfig, MCPOAuthConfig, McpMetadata, OAuthClientInformation, OAuthTokens as McpOAuthTokens, RateLimitConfig, TokenExchangeRequest, TokenStorage, } from "./types/mcpTypes.js";
 export type { ExecutionContext, ToolExecutionResult, ToolInfo, } from "./types/tools.js";
 export type { LogLevel } from "./types/utilities.js";

package/dist/lib/index.js

@@ -237,7 +237,33 @@ InMemoryTokenStorage,
 // Simplified MCP exports
 initializeMCPEcosystem, isRetryableHTTPError, isRetryableStatusCode, isTokenExpired, listMCPs, 
 // Circuit Breaker
-MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, } from "./mcp/index.js";
+MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, 
+// Core MCP Components
+MCPToolRegistry, ExternalServerManager, MCPClientFactory, 
+// MCP Enhancements - Routing, Caching, Batching
+ToolRouter, createToolRouter, DEFAULT_ROUTER_CONFIG, ToolCache, createToolCache, DEFAULT_CACHE_CONFIG, ToolResultCache, createToolResultCache, RequestBatcher, ToolCallBatcher, createRequestBatcher, createToolCallBatcher, DEFAULT_BATCH_CONFIG, 
+// MCP Enhancements - Tool Annotations
+inferAnnotations, createAnnotatedTool, validateAnnotations, filterToolsByAnnotations, mergeAnnotations, getAnnotationSummary, requiresConfirmation, isSafeToRetry, getToolSafetyLevel, 
+// MCP Enhancements - Elicitation
+ElicitationManager, globalElicitationManager, 
+// MCP Enhancements - Enhanced Tool Discovery
+EnhancedToolDiscovery, 
+// MCP Enhancements - Registry Client
+MCPRegistryClient, globalMCPRegistryClient, getWellKnownServer, getAllWellKnownServers, 
+// MCP Enhancements - Server Base
+MCPServerBase, 
+// MCP Enhancements - Multi-Server Manager
+MultiServerManager, globalMultiServerManager, 
+// MCP Enhancements - Agent Exposure
+AgentExposureManager, exposeAgentAsTool, exposeAgentsAsTools, exposeWorkflowAsTool, exposeWorkflowsAsTools, globalAgentExposureManager, 
+// MCP Enhancements - Server Capabilities
+ServerCapabilitiesManager, createTextResource, createJsonResource, createPrompt, 
+// MCP Enhancements - Tool Converter
+neuroLinkToolToMCP, mcpToolToNeuroLink, batchConvertToMCP, batchConvertToNeuroLink, sanitizeToolName, validateToolName, createToolFromFunction, mcpProtocolToolToServerTool, serverToolToMCPProtocol, TOOL_COMPATIBILITY, 
+// MCP Enhancements - Tool Integration
+ToolIntegrationManager, globalToolIntegrationManager, wrapToolWithElicitation, wrapToolsWithElicitation, createElicitationContext, confirmationMiddleware, validationMiddleware, loggingMiddleware, createRetryMiddleware, createTimeoutMiddleware, createToolMiddlewareChain, 
+// MCP Enhancements - Elicitation Protocol
+ElicitationProtocolAdapter, globalElicitationProtocol, isElicitationProtocolMessage, protocolMessageToElicitation, elicitationResponseToProtocol, createElicitationRequest, createElicitationResponse, createElicitationCancel, createTextInputRequest, createSelectRequest, createConfirmationRequest, createFormRequest, } from "./mcp/index.js";
 export { logger } from "./utils/logger.js";
 export { getPoolStats } from "./utils/redis.js";
 // ============================================================================

package/dist/lib/mcp/agentExposure.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Agent and Workflow Exposure as MCP Tools
+ *
+ * Enables exposing NeuroLink agents and workflows as MCP tools,
+ * allowing external MCP clients to invoke complex AI operations
+ * through the standardized MCP protocol.
+ *
+ * @module mcp/agentExposure
+ * @since 8.39.0
+ */
+import type { JsonObject } from "../types/common.js";
+import type { NeuroLinkExecutionContext } from "../types/mcpTypes.js";
+import type { MCPServerTool, MCPToolAnnotations } from "./toolAnnotations.js";
+/**
+ * Agent definition for MCP exposure
+ */
+export type ExposableAgent = {
+    /**
+     * Unique agent identifier
+     */
+    id: string;
+    /**
+     * Human-readable agent name
+     */
+    name: string;
+    /**
+     * Agent description for AI models
+     */
+    description: string;
+    /**
+     * Input schema for the agent
+     */
+    inputSchema?: JsonObject;
+    /**
+     * Output schema for the agent
+     */
+    outputSchema?: JsonObject;
+    /**
+     * Agent execution function
+     */
+    execute: (input: unknown, context?: NeuroLinkExecutionContext) => Promise<unknown>;
+    /**
+     * Additional agent metadata
+     */
+    metadata?: {
+        version?: string;
+        author?: string;
+        category?: string;
+        tags?: string[];
+        estimatedDuration?: number;
+        costHint?: number;
+    };
+};
+/**
+ * Workflow definition for MCP exposure
+ */
+export type ExposableWorkflow = {
+    /**
+     * Unique workflow identifier
+     */
+    id: string;
+    /**
+     * Human-readable workflow name
+     */
+    name: string;
+    /**
+     * Workflow description
+     */
+    description: string;
+    /**
+     * Workflow steps (for documentation)
+     */
+    steps?: Array<{
+        id: string;
+        name: string;
+        description?: string;
+    }>;
+    /**
+     * Input schema for the workflow
+     */
+    inputSchema?: JsonObject;
+    /**
+     * Output schema for the workflow
+     */
+    outputSchema?: JsonObject;
+    /**
+     * Workflow execution function
+     */
+    execute: (input: unknown, context?: NeuroLinkExecutionContext) => Promise<unknown>;
+    /**
+     * Workflow metadata
+     */
+    metadata?: {
+        version?: string;
+        author?: string;
+        category?: string;
+        tags?: string[];
+        estimatedDuration?: number;
+        retriable?: boolean;
+        idempotent?: boolean;
+    };
+};
+/**
+ * Options for exposing agents/workflows as MCP tools
+ */
+export type ExposureOptions = {
+    /**
+     * Prefix for tool names
+     */
+    prefix?: string;
+    /**
+     * Default annotations for all exposed tools
+     */
+    defaultAnnotations?: MCPToolAnnotations;
+    /**
+     * Whether to include metadata in tool description
+     */
+    includeMetadataInDescription?: boolean;
+    /**
+     * Custom name transformer
+     */
+    nameTransformer?: (name: string) => string;
+    /**
+     * Add execution context wrapper
+     */
+    wrapWithContext?: boolean;
+    /**
+     * Timeout for agent/workflow execution (ms)
+     */
+    executionTimeout?: number;
+    /**
+     * Enable execution logging
+     */
+    enableLogging?: boolean;
+};
+/**
+ * Exposure result
+ */
+export type ExposureResult = {
+    /**
+     * Generated MCP tool
+     */
+    tool: MCPServerTool;
+    /**
+     * Original source type
+     */
+    sourceType: "agent" | "workflow";
+    /**
+     * Original source ID
+     */
+    sourceId: string;
+    /**
+     * Generated tool name
+     */
+    toolName: string;
+};
+/**
+ * Expose an agent as an MCP tool
+ */
+export declare function exposeAgentAsTool(agent: ExposableAgent, options?: ExposureOptions): ExposureResult;
+/**
+ * Expose a workflow as an MCP tool
+ */
+export declare function exposeWorkflowAsTool(workflow: ExposableWorkflow, options?: ExposureOptions): ExposureResult;
+/**
+ * Batch expose agents as MCP tools
+ */
+export declare function exposeAgentsAsTools(agents: ExposableAgent[], options?: ExposureOptions): ExposureResult[];
+/**
+ * Batch expose workflows as MCP tools
+ */
+export declare function exposeWorkflowsAsTools(workflows: ExposableWorkflow[], options?: ExposureOptions): ExposureResult[];
+/**
+ * Agent Exposure Manager
+ *
+ * Manages the lifecycle of exposed agents and workflows,
+ * providing registration, lookup, and invocation capabilities.
+ */
+export declare class AgentExposureManager {
+    private exposedTools;
+    private options;
+    constructor(options?: ExposureOptions);
+    /**
+     * Expose an agent and register it
+     */
+    exposeAgent(agent: ExposableAgent): MCPServerTool;
+    /**
+     * Expose a workflow and register it
+     */
+    exposeWorkflow(workflow: ExposableWorkflow): MCPServerTool;
+    /**
+     * Get all exposed tools
+     */
+    getExposedTools(): MCPServerTool[];
+    /**
+     * Get exposed tool by name
+     */
+    getExposedTool(toolName: string): MCPServerTool | undefined;
+    /**
+     * Get exposure result by tool name
+     */
+    getExposureResult(toolName: string): ExposureResult | undefined;
+    /**
+     * Get tools by source type
+     */
+    getToolsBySourceType(sourceType: "agent" | "workflow"): MCPServerTool[];
+    /**
+     * Remove exposed tool
+     */
+    unexpose(toolName: string): boolean;
+    /**
+     * Clear all exposed tools
+     */
+    clear(): void;
+    /**
+     * Get statistics
+     */
+    getStatistics(): {
+        totalExposed: number;
+        exposedAgents: number;
+        exposedWorkflows: number;
+        toolNames: string[];
+    };
+}
+/**
+ * Global agent exposure manager instance
+ */
+export declare const globalAgentExposureManager: AgentExposureManager;