@flutchai/flutch-sdk 0.4.1 → 0.6.0

package/dist/index.d.cts

@@ -1049,6 +1049,8 @@ interface ModelByIdConfig {
     baseURL?: string;
     toolsConfig?: IAgentToolConfig[];
     customTools?: DynamicStructuredTool[];
+    mcpServers?: Record<string, any>[];
+    mcpContext?: Record<string, any>;
 }
 type ModelConfigFetcher = (modelId: string) => Promise<ModelConfigWithToken>;
 interface ModelConfigWithToken {
@@ -1273,7 +1275,7 @@ declare class McpToolFilter {
     private readonly logger;
     private readonly mcpConverter;
     constructor(mcpRuntimeUrl?: string);
-    getFilteredTools(toolsConfig?: IAgentToolConfig[]): Promise<StructuredTool[]>;
+    getFilteredTools(toolsConfig?: IAgentToolConfig[], mcpServers?: Record<string, any>[], context?: Record<string, any>): Promise<StructuredTool[]>;
     getAllTools(): Promise<StructuredTool[]>;
     isHealthy(): Promise<boolean>;
     getAvailableToolNames(): Promise<string[]>;
@@ -1285,10 +1287,10 @@ declare class McpRuntimeHttpClient implements McpRuntimeClient {
     private readonly baseUrl;
     constructor(mcpRuntimeUrl?: string);
     getTools(): Promise<McpTool[]>;
-    executeTool(name: string, args: any, context?: any): Promise<ToolExecutionResult>;
+    executeTool(name: string, args: any, context?: any, mcpServers?: Record<string, any>[]): Promise<ToolExecutionResult>;
     getToolStats(): Promise<any>;
     isHealthy(): Promise<boolean>;
-    executeToolWithEvents(toolCallId: string, toolName: string, enrichedArgs: Record<string, any>, executionContext: Record<string, any>, config?: RunnableConfig): Promise<{
+    executeToolWithEvents(toolCallId: string, toolName: string, enrichedArgs: Record<string, any>, executionContext: Record<string, any>, config?: RunnableConfig, mcpServers?: Record<string, any>[]): Promise<{
         content: string;
         success: boolean;
         rawResult?: any;
@@ -1326,6 +1328,7 @@ interface ExecuteToolWithAttachmentsParams {
         properties?: Record<string, any>;
         required?: string[];
     };
+    mcpServers?: Record<string, any>[];
 }
 interface ExecuteToolWithAttachmentsResult {
     toolMessage: ToolMessage;

package/dist/index.d.ts

@@ -1049,6 +1049,8 @@ interface ModelByIdConfig {
     baseURL?: string;
     toolsConfig?: IAgentToolConfig[];
     customTools?: DynamicStructuredTool[];
+    mcpServers?: Record<string, any>[];
+    mcpContext?: Record<string, any>;
 }
 type ModelConfigFetcher = (modelId: string) => Promise<ModelConfigWithToken>;
 interface ModelConfigWithToken {
@@ -1273,7 +1275,7 @@ declare class McpToolFilter {
     private readonly logger;
     private readonly mcpConverter;
     constructor(mcpRuntimeUrl?: string);
-    getFilteredTools(toolsConfig?: IAgentToolConfig[]): Promise<StructuredTool[]>;
+    getFilteredTools(toolsConfig?: IAgentToolConfig[], mcpServers?: Record<string, any>[], context?: Record<string, any>): Promise<StructuredTool[]>;
     getAllTools(): Promise<StructuredTool[]>;
     isHealthy(): Promise<boolean>;
     getAvailableToolNames(): Promise<string[]>;
@@ -1285,10 +1287,10 @@ declare class McpRuntimeHttpClient implements McpRuntimeClient {
     private readonly baseUrl;
     constructor(mcpRuntimeUrl?: string);
     getTools(): Promise<McpTool[]>;
-    executeTool(name: string, args: any, context?: any): Promise<ToolExecutionResult>;
+    executeTool(name: string, args: any, context?: any, mcpServers?: Record<string, any>[]): Promise<ToolExecutionResult>;
     getToolStats(): Promise<any>;
     isHealthy(): Promise<boolean>;
-    executeToolWithEvents(toolCallId: string, toolName: string, enrichedArgs: Record<string, any>, executionContext: Record<string, any>, config?: RunnableConfig): Promise<{
+    executeToolWithEvents(toolCallId: string, toolName: string, enrichedArgs: Record<string, any>, executionContext: Record<string, any>, config?: RunnableConfig, mcpServers?: Record<string, any>[]): Promise<{
         content: string;
         success: boolean;
         rawResult?: any;
@@ -1326,6 +1328,7 @@ interface ExecuteToolWithAttachmentsParams {
         properties?: Record<string, any>;
         required?: string[];
     };
+    mcpServers?: Record<string, any>[];
 }
 interface ExecuteToolWithAttachmentsResult {
     toolMessage: ToolMessage;

package/dist/index.js

@@ -329,8 +329,8 @@ var ENDPOINT_METADATA_KEY, UI_ENDPOINT_CLASS_METADATA_KEY, UI_ENDPOINT_METHOD_ME
 var init_endpoint_decorators = __esm({
   "src/agent-ui/endpoint.decorators.ts"() {
     ENDPOINT_METADATA_KEY = "graph:endpoints";
-    UI_ENDPOINT_CLASS_METADATA_KEY = Symbol("ui_endpoint_class");
-    UI_ENDPOINT_METHOD_METADATA_KEY = Symbol("ui_endpoint_methods");
+    UI_ENDPOINT_CLASS_METADATA_KEY = /* @__PURE__ */ Symbol("ui_endpoint_class");
+    UI_ENDPOINT_METHOD_METADATA_KEY = /* @__PURE__ */ Symbol("ui_endpoint_methods");
   }
 });
 var UIEndpointsDiscoveryService;
@@ -343,6 +343,9 @@ var init_ui_endpoints_discovery = __esm({
         this.metadataScanner = metadataScanner;
         this.endpointRegistry = endpointRegistry;
       }
+      discoveryService;
+      metadataScanner;
+      endpointRegistry;
       logger = new Logger(UIEndpointsDiscoveryService.name);
       async onModuleInit() {
         await this.discoverUIEndpoints();
@@ -419,6 +422,8 @@ var init_ui_dispatch_controller = __esm({
         this.endpointRegistry = endpointRegistry;
         this.builderRegistry = builderRegistry;
       }
+      endpointRegistry;
+      builderRegistry;
       logger = new Logger(UIDispatchController.name);
       async dispatchUIEndpoint(dto) {
         this.logger.debug(
@@ -693,8 +698,8 @@ function findCallbackMethod(target, handler) {
 var CALLBACK_METADATA_KEY, CALLBACK_CLASS_METADATA_KEY;
 var init_callback_decorators = __esm({
   "src/callbacks/callback.decorators.ts"() {
-    CALLBACK_METADATA_KEY = Symbol("callbacks");
-    CALLBACK_CLASS_METADATA_KEY = Symbol("callback_class");
+    CALLBACK_METADATA_KEY = /* @__PURE__ */ Symbol("callbacks");
+    CALLBACK_CLASS_METADATA_KEY = /* @__PURE__ */ Symbol("callback_class");
   }
 });
 
@@ -1484,6 +1489,10 @@ var UniversalGraphService = class {
       this.logger.error("GRAPH_ENGINE is not properly injected!");
     }
   }
+  configService;
+  builders;
+  engine;
+  endpointRegistry;
   logger = new Logger(UniversalGraphService.name);
   /**
    * Returns graph types supported by the service
@@ -1997,6 +2006,8 @@ var GraphController = class {
     this.graphService = graphService;
     this.builderRegistry = builderRegistry;
   }
+  graphService;
+  builderRegistry;
   logger = new Logger(GraphController.name);
   async healthCheck() {
     try {
@@ -2383,6 +2394,7 @@ var CallbackStore = class {
     this.redis = redis;
     this.isProduction = process.env.NODE_ENV === "production";
   }
+  redis;
   isProduction;
   /**
    * Issues a new callback token and persists its payload.
@@ -2589,6 +2601,7 @@ var IdempotencyManager = class {
   constructor(redis) {
     this.redis = redis;
   }
+  redis;
   logger = new Logger(IdempotencyManager.name);
   defaultConfig = {
     ttlSeconds: 3600,
@@ -2839,6 +2852,14 @@ var SmartCallbackRouter = class {
     this.idempotencyManager = idempotencyManager;
     this.patchService = patchService;
   }
+  registry;
+  store;
+  acl;
+  auditor;
+  metrics;
+  rateLimiter;
+  idempotencyManager;
+  patchService;
   logger = new Logger(SmartCallbackRouter.name);
   circuitBreakers = /* @__PURE__ */ new Map();
   defaultConfig = {
@@ -3098,6 +3119,8 @@ var UniversalCallbackService = class {
     this.store = store;
     this.router = router;
   }
+  store;
+  router;
   async handle(record, user, metadata) {
     try {
       const result = await this.router.route(record, user, metadata);
@@ -3889,6 +3912,7 @@ var CallbackRateLimiter = class {
   constructor(redis) {
     this.redis = redis;
   }
+  redis;
   logger = new Logger(CallbackRateLimiter.name);
   defaultConfig = {
     windowMs: 6e4,
@@ -4054,6 +4078,8 @@ var CallbackPatchService = class {
     this.telegram = telegram;
     this.web = web;
   }
+  telegram;
+  web;
   logger = new Logger(CallbackPatchService.name);
   async apply(record, patch, context) {
     if (!patch) return;
@@ -4114,6 +4140,8 @@ var CallbackTokenGuard = class {
     this.store = store;
     this.acl = acl;
   }
+  store;
+  acl;
   logger = new Logger(CallbackTokenGuard.name);
   async canActivate(context) {
     const request = context.switchToHttp().getRequest();
@@ -4171,6 +4199,7 @@ var CallbackController = class {
   constructor(callbackService) {
     this.callbackService = callbackService;
   }
+  callbackService;
   async handleCallback(req) {
     return this.callbackService.handle(req.callbackRecord, req.user);
   }
@@ -4459,7 +4488,8 @@ async function executeToolWithAttachments(params) {
     injectIntoArg = "data",
     sourceAttachmentId,
     threadId,
-    toolSchema
+    toolSchema,
+    mcpServers
   } = params;
   const argsWithInjection = { ...enrichedArgs };
   try {
@@ -4490,7 +4520,8 @@ async function executeToolWithAttachments(params) {
     toolCall.name,
     argsWithInjection,
     executionContext,
-    config
+    config,
+    mcpServers
   );
   try {
     if (success && rawResult !== void 0 && content.length > threshold) {
@@ -4710,6 +4741,7 @@ var GraphEngineFactory = class {
   constructor(langgraph) {
     this.langgraph = langgraph;
   }
+  langgraph;
   /**
    * Get engine for the specified type
    */
@@ -5367,6 +5399,8 @@ var LangGraphEngine = class {
       this.logger.error("EventProcessor is undefined/null!");
     }
   }
+  eventProcessor;
+  configService;
   logger = new Logger(LangGraphEngine.name);
   /**
    * Deserialize input recursively
@@ -6343,6 +6377,7 @@ var McpToolFilter = class _McpToolFilter {
     this.mcpRuntimeUrl = mcpRuntimeUrl;
     this.mcpConverter = new McpConverter(this.mcpRuntimeUrl);
   }
+  mcpRuntimeUrl;
   logger = new Logger(_McpToolFilter.name);
   mcpConverter;
   /**
@@ -6350,12 +6385,13 @@ var McpToolFilter = class _McpToolFilter {
    * @param toolsConfig Array of tool configurations with dynamic config
    * @returns Array of LangChain Tool instances with dynamic schemas
    */
-  async getFilteredTools(toolsConfig = []) {
+  async getFilteredTools(toolsConfig = [], mcpServers, context) {
     this.logger.debug(
       `[DEBUG] Getting filtered tools with dynamic schemas. Config: ${JSON.stringify(toolsConfig)}`
     );
     this.logger.debug(`[DEBUG] MCP Runtime URL: ${this.mcpRuntimeUrl}`);
-    if (toolsConfig.length === 0) {
+    const hasInlineServers = !!(mcpServers && mcpServers.length > 0);
+    if (toolsConfig.length === 0 && !hasInlineServers) {
       this.logger.debug("No tools configured, returning empty array");
       return [];
     }
@@ -6363,10 +6399,13 @@ var McpToolFilter = class _McpToolFilter {
       this.logger.debug(
         `[DEBUG] Making HTTP POST request to: ${this.mcpRuntimeUrl}/tools/schemas`
       );
-      this.logger.debug(`[DEBUG] Request body: ${JSON.stringify(toolsConfig)}`);
+      const requestBody = { tools: toolsConfig };
+      if (hasInlineServers) requestBody.mcpServers = mcpServers;
+      if (context) requestBody.context = context;
+      this.logger.debug(`[DEBUG] Request body: ${JSON.stringify(requestBody)}`);
       const response = await axios2.post(
         `${this.mcpRuntimeUrl}/tools/schemas`,
-        { tools: toolsConfig },
+        requestBody,
         {
           timeout: 5e3,
           headers: {
@@ -6383,14 +6422,14 @@ var McpToolFilter = class _McpToolFilter {
       );
       const mcpClient = {
         getTools: async () => dynamicTools,
-        executeTool: async (name, args, context) => {
+        executeTool: async (name, args, context2) => {
           this.logger.debug(`[DEBUG] Executing tool ${name} with args:`, args);
           const response2 = await axios2.post(
             `${this.mcpRuntimeUrl}/tools/execute`,
             {
               name,
               arguments: args || {},
-              context
+              context: context2
             }
           );
           return response2.data;
@@ -6529,7 +6568,7 @@ var McpRuntimeHttpClient = class {
   /**
    * Execute a tool by name with given arguments
    */
-  async executeTool(name, args, context) {
+  async executeTool(name, args, context, mcpServers) {
     try {
       this.logger.debug(`Executing tool: ${name} with args:`, args);
       const payload = {
@@ -6539,6 +6578,9 @@ var McpRuntimeHttpClient = class {
       if (context) {
         payload.context = context;
       }
+      if (mcpServers && mcpServers.length > 0) {
+        payload.mcpServers = mcpServers;
+      }
       const response = await this.httpClient.post("/tools/execute", payload);
       this.logger.log(`Tool ${name} executed successfully`);
       return response.data;
@@ -6589,7 +6631,7 @@ var McpRuntimeHttpClient = class {
    * @param config - RunnableConfig with callbacks
    * @returns Tool execution result with content
    */
-  async executeToolWithEvents(toolCallId, toolName, enrichedArgs, executionContext, config) {
+  async executeToolWithEvents(toolCallId, toolName, enrichedArgs, executionContext, config, mcpServers) {
     const parsedConfig = parseCallbackConfigArg(config);
     const callbackManager = CallbackManager.configure(parsedConfig.callbacks);
     let runManager;
@@ -6611,7 +6653,8 @@ var McpRuntimeHttpClient = class {
       const result = await this.executeTool(
         toolName,
         enrichedArgs,
-        executionContext
+        executionContext,
+        mcpServers
       );
       const content = result.success ? JSON.stringify(result) : result.error || JSON.stringify(result);
       await runManager?.handleToolEnd(content);
@@ -6775,6 +6818,8 @@ var ModelInitializer = class _ModelInitializer {
     this.apiKeyResolver = apiKeyResolver;
     this.logger = logger2 || new Logger(_ModelInitializer.name);
   }
+  configFetcher;
+  apiKeyResolver;
   logger;
   // Cache for model configurations to avoid repeated API calls
   modelConfigCache = /* @__PURE__ */ new Map();
@@ -6820,13 +6865,17 @@ var ModelInitializer = class _ModelInitializer {
    * Example: "model123:0.7:4096" or "model123:0.7:4096:a1b2c3d4e5f6g7h8"
    */
   generateModelCacheKey(config) {
-    return generateModelCacheKey(
+    const base = generateModelCacheKey(
       config.modelId,
       config.temperature,
       config.maxTokens,
       config.toolsConfig,
       config.baseURL
     );
+    if (config.mcpServers && config.mcpServers.length > 0) {
+      return `${base}:mcp:${JSON.stringify(config.mcpServers)}`;
+    }
+    return base;
   }
   // Chat model creators
   chatModelCreators = {
@@ -7102,11 +7151,13 @@ var ModelInitializer = class _ModelInitializer {
       ...model.metadata,
       modelId: config.modelId
     };
-    if (config.toolsConfig || config.customTools) {
+    if (config.toolsConfig || config.customTools || config.mcpServers && config.mcpServers.length > 0) {
       const boundModel = await this.bindToolsToModel(
         model,
         config.toolsConfig,
-        config.customTools
+        config.customTools,
+        config.mcpServers,
+        config.mcpContext
       );
       this.modelInstanceCache.set(cacheKey, boundModel);
       return boundModel;
@@ -7123,24 +7174,27 @@ var ModelInitializer = class _ModelInitializer {
    * - Runnable when tools are bound (model.bindTools returns Runnable)
    * - BaseChatModel when no tools
    */
-  async bindToolsToModel(model, toolsConfig, customTools) {
+  async bindToolsToModel(model, toolsConfig, customTools, mcpServers, mcpContext) {
     const allTools = [];
-    if (toolsConfig && toolsConfig.length > 0) {
+    const enabledToolsConfig = (toolsConfig || []).filter(
+      (tc) => tc.enabled !== false
+    );
+    const hasInlineServers = !!(mcpServers && mcpServers.length > 0);
+    if (enabledToolsConfig.length > 0 || hasInlineServers) {
       try {
-        const enabledToolsConfig = toolsConfig.filter(
-          (tc) => tc.enabled !== false
+        this.logger.debug(
+          `Fetching ${enabledToolsConfig.length} tools (+${mcpServers?.length || 0} inline server(s)) with dynamic schemas from MCP Runtime`
         );
-        if (enabledToolsConfig.length > 0) {
-          this.logger.debug(
-            `Fetching ${enabledToolsConfig.length} tools with dynamic schemas from MCP Runtime: ${enabledToolsConfig.map((tc) => tc.toolName).join(", ")}`
-          );
-          const mcpToolFilter = new McpToolFilter();
-          const mcpTools = await mcpToolFilter.getFilteredTools(enabledToolsConfig);
-          this.logger.debug(
-            `Successfully fetched ${mcpTools.length} tools with dynamic schemas from MCP Runtime`
-          );
-          allTools.push(...mcpTools);
-        }
+        const mcpToolFilter = new McpToolFilter();
+        const mcpTools = await mcpToolFilter.getFilteredTools(
+          enabledToolsConfig,
+          mcpServers,
+          mcpContext
+        );
+        this.logger.debug(
+          `Successfully fetched ${mcpTools.length} tools with dynamic schemas from MCP Runtime`
+        );
+        allTools.push(...mcpTools);
       } catch (error) {
         this.logger.error(
           `Failed to fetch tools from MCP Runtime: ${error instanceof Error ? error.message : String(error)}`
@@ -7659,6 +7713,7 @@ var StaticDiscovery = class {
   constructor(services) {
     this.services = services;
   }
+  services;
   /**
    * Get list of services by category
    */
@@ -7851,6 +7906,7 @@ var FileTokenStore = class {
   constructor(filePath) {
     this.filePath = filePath;
   }
+  filePath;
   async get(provider) {
     const data = this.readFile();
     return data[provider] ?? null;
@@ -7891,6 +7947,7 @@ var MongoTokenStore = class {
     this.db = db;
     this.collectionName = collectionName ?? DEFAULT_COLLECTION;
   }
+  db;
   collectionName;
   initialized = false;
   async get(provider) {