@1mcp/agent 0.37.0 → 0.38.0

package/build/sdk/legacy/server/protocol/toolRequestHandlers.js

@@ -0,0 +1,87 @@
+import { getConfiguredServerTargets } from '../../../../config/configuredServerTargets.js';
+import { InternalCapabilitiesProvider } from '../../../../core/capabilities/internalCapabilitiesProvider.js';
+import { acquireRuntimeCapabilityCatalog } from '../../../../core/capabilities/runtimeCapabilityCatalog.js';
+import { executeWithPostAuthOAuthRecovery } from '../../../../core/client/postAuthOAuthRecovery.js';
+import { getRequestSession, resolveCapabilityVisibility, resolveLazyCapabilityVisibility, } from '../../../../core/protocol/requestHandlerUtils.js';
+import { getDisabledSourceToolError } from '../../../../core/server/disabledTools.js';
+import { requestLegacyOutbound, } from '../../../../sdk/legacy/client/runtime/legacyOutboundConnection.js';
+import { getLegacyInboundServer } from '../../../../sdk/legacy/server/runtime/legacyInboundConnection.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '../../../../sdk/legacy/types.js';
+import { withErrorHandling } from '../../../../utils/core/errorHandling.js';
+export function registerToolHandlers(outboundConns, inboundConn, lazyLoadingOrchestrator) {
+    const sessionId = getRequestSession(inboundConn);
+    const lazy = lazyLoadingOrchestrator?.isEnabled() ?? false;
+    const acquire = async (cursor) => {
+        const visibility = lazy
+            ? resolveLazyCapabilityVisibility(outboundConns, inboundConn, sessionId)
+            : resolveCapabilityVisibility(outboundConns, inboundConn, sessionId, 'tools');
+        const provider = InternalCapabilitiesProvider.getInstance();
+        await provider.initialize();
+        const internalTools = provider.getAvailableTools();
+        const metaTools = lazy && lazyLoadingOrchestrator
+            ? (await lazyLoadingOrchestrator.getCapabilitiesForVisibility(visibility)).tools
+            : [];
+        const serverConfigs = getConfiguredServerTargets();
+        const snapshot = await acquireRuntimeCapabilityCatalog(outboundConns, visibility, {
+            serverConfigs,
+            internalTools: lazy
+                ? internalTools.filter((tool) => !['tool_list', 'tool_schema', 'tool_invoke'].includes(tool.name))
+                : internalTools,
+            unprefixedTools: metaTools,
+            continuation: cursor
+                ? {
+                    kind: 'tools',
+                    cursor,
+                    enablePagination: inboundConn.enablePagination ?? false,
+                    internalOnly: lazy,
+                    filterSelection: { lazy },
+                }
+                : undefined,
+        });
+        return { snapshot, visibility, provider, serverConfigs };
+    };
+    const server = getLegacyInboundServer(inboundConn);
+    server.setRequestHandler(ListToolsRequestSchema, withErrorHandling(async (request) => {
+        const { snapshot } = await acquire(request.params?.cursor);
+        const result = await snapshot.list('tools', {
+            cursor: request.params?.cursor,
+            enablePagination: inboundConn.enablePagination ?? false,
+            filterSelection: { lazy },
+            internalOnly: lazy,
+        });
+        return {
+            tools: result.items,
+            ...(result.nextCursor === undefined ? {} : { nextCursor: result.nextCursor }),
+            ...(result._meta === undefined ? {} : { _meta: result._meta }),
+        };
+    }, 'Error listing tools'));
+    server.setRequestHandler(CallToolRequestSchema, withErrorHandling(async (request) => {
+        const { snapshot, visibility, provider, serverConfigs } = await acquire();
+        const resolved = snapshot.resolve('tools', request.params.name);
+        if (!resolved) {
+            const entry = snapshot.generation.resolve('tools', request.params.name);
+            const error = entry && getDisabledSourceToolError(serverConfigs, entry.route.server, entry.route.upstreamIdentity);
+            if (error)
+                return structuredToolResult({ error });
+            throw new Error(`Unknown tool: ${request.params.name}`);
+        }
+        const { route } = resolved.entry;
+        if (route.origin === 'internal') {
+            if (lazyLoadingOrchestrator && route.connectionKey === '\0app.1mcp/meta-tools') {
+                return structuredToolResult(await lazyLoadingOrchestrator.callMetaTool(route.upstreamIdentity, request.params.arguments, visibility));
+            }
+            return structuredToolResult(await provider.executeTool(route.upstreamIdentity, request.params.arguments, lazy ? visibility : undefined));
+        }
+        if (!resolved.connection)
+            throw new Error(`Server not connected: ${route.server}`);
+        const connection = resolved.connection;
+        return executeWithPostAuthOAuthRecovery(route.server, connection, () => requestLegacyOutbound(connection, 'tools/call', {
+            ...request.params,
+            name: route.upstreamIdentity,
+        }));
+    }, 'Error calling tool'));
+}
+function structuredToolResult(result) {
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], structuredContent: result };
+}
+//# sourceMappingURL=toolRequestHandlers.js.map

package/build/sdk/legacy/server/protocol/toolRequestHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolRequestHandlers.js","sourceRoot":"","sources":["../../../../../src/sdk/legacy/server/protocol/toolRequestHandlers.ts"],"names":[],"mappings":"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"}

package/build/sdk/legacy/server/runtime/clientInstanceFactory.d.ts

@@ -0,0 +1,14 @@
+import type { MCPServerParams } from '../../../../core/types/transport.js';
+import type { PooledClientInstance } from './clientInstancePoolTypes.js';
+export interface CreatePooledInstanceParams {
+    instanceId: string;
+    instanceKey: string;
+    templateName: string;
+    processedConfig: MCPServerParams;
+    renderedHash: string;
+    runtimeFingerprint: string;
+    clientId: string;
+    idleTimeout: number;
+}
+export declare function createPooledClientInstance({ instanceId, instanceKey, templateName, processedConfig, renderedHash, runtimeFingerprint, clientId, idleTimeout, }: CreatePooledInstanceParams): Promise<PooledClientInstance>;
+//# sourceMappingURL=clientInstanceFactory.d.ts.map

package/build/sdk/legacy/server/runtime/clientInstanceFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientInstanceFactory.d.ts","sourceRoot":"","sources":["../../../../../src/sdk/legacy/server/runtime/clientInstanceFactory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAKpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,0BAA0B,CAAC,EAC/C,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,QAAQ,EACR,WAAW,GACZ,EAAE,0BAA0B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA+C5D"}

package/build/sdk/legacy/server/runtime/clientInstanceFactory.js

@@ -0,0 +1,49 @@
+import { sanitizeRuntimeScopeError } from '../../../../config/runtimeScopeEnv.js';
+import { templateBackendLogSource } from '../../../../domains/backend-logs/backendLogSource.js';
+import { createTransportsWithContext } from '../../../../transport/transportFactory.js';
+import { getConnectionTimeout } from '../../../../utils/core/timeoutUtils.js';
+export async function createPooledClientInstance({ instanceId, instanceKey, templateName, processedConfig, renderedHash, runtimeFingerprint, clientId, idleTimeout, }) {
+    const backendLogOptions = processedConfig.type === 'stdio' || (!processedConfig.type && Boolean(processedConfig.command))
+        ? {
+            backendLogSources: {
+                [templateName]: templateBackendLogSource({ templateName, instanceId }),
+            },
+        }
+        : undefined;
+    const configs = { [templateName]: processedConfig };
+    const transports = backendLogOptions
+        ? await createTransportsWithContext(configs, undefined, backendLogOptions)
+        : await createTransportsWithContext(configs, undefined);
+    const transport = transports[templateName];
+    if (!transport) {
+        throw new Error(`Failed to create transport for template ${templateName}`);
+    }
+    const { ClientManager } = await import('../../../../core/client/clientManager.js');
+    const clientManager = ClientManager.getOrCreateInstance();
+    const client = clientManager.createPooledClientInstance();
+    const connectionTimeout = getConnectionTimeout(transport);
+    try {
+        await client.connect(transport, connectionTimeout ? { timeout: connectionTimeout } : undefined);
+    }
+    catch (error) {
+        throw sanitizeRuntimeScopeError(error);
+    }
+    return {
+        id: instanceId,
+        instanceKey,
+        templateName,
+        client,
+        transport,
+        renderedHash,
+        runtimeFingerprint,
+        processedConfig,
+        referenceCount: 1,
+        createdAt: new Date(),
+        lastUsedAt: new Date(),
+        status: 'active',
+        outboundKeys: new Set(),
+        clientIds: new Set([clientId]),
+        idleTimeout,
+    };
+}
+//# sourceMappingURL=clientInstanceFactory.js.map

package/build/sdk/legacy/server/runtime/clientInstanceFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientInstanceFactory.js","sourceRoot":"","sources":["../../../../../src/sdk/legacy/server/runtime/clientInstanceFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAC;AACzF,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAevE,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,EAC/C,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,QAAQ,EACR,WAAW,GACgB;IAC3B,MAAM,iBAAiB,GACrB,eAAe,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,eAAe,CAAC,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC7F,CAAC,CAAC;YACE,iBAAiB,EAAE;gBACjB,CAAC,YAAY,CAAC,EAAE,wBAAwB,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;aACvE;SACF;QACH,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACpD,MAAM,UAAU,GAAG,iBAAiB;QAClC,CAAC,CAAC,MAAM,2BAA2B,CAAC,OAAO,EAAE,SAAS,EAAE,iBAAiB,CAAC;QAC1E,CAAC,CAAC,MAAM,2BAA2B,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAE1D,MAAM,SAAS,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAC3C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,2CAA2C,YAAY,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;IAC5E,MAAM,aAAa,GAAG,aAAa,CAAC,mBAAmB,EAAE,CAAC;IAC1D,MAAM,MAAM,GAAG,aAAa,CAAC,0BAA0B,EAAE,CAAC;IAE1D,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAClG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,OAAO;QACL,EAAE,EAAE,UAAU;QACd,WAAW;QACX,YAAY;QACZ,MAAM;QACN,SAAS;QACT,YAAY;QACZ,kBAAkB;QAClB,eAAe;QACf,cAAc,EAAE,CAAC;QACjB,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,UAAU,EAAE,IAAI,IAAI,EAAE;QACtB,MAAM,EAAE,QAAQ;QAChB,YAAY,EAAE,IAAI,GAAG,EAAE;QACvB,SAAS,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC9B,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/build/sdk/legacy/server/runtime/clientInstancePool.d.ts

@@ -0,0 +1,116 @@
+import { type BackendSupervisionSnapshot } from '../../../../core/server/backendStdioSupervisor.js';
+import type { MCPServerParams } from '../../../../core/types/transport.js';
+import type { ContextData } from '../../../../types/context.js';
+import { ClientPoolOptions, PooledClientInstance } from './clientInstancePoolTypes.js';
+export type { ClientPoolOptions, PooledClientInstance };
+/**
+ * Manages a pool of MCP client instances created from templates
+ *
+ * This class handles:
+ * - Creating new client instances from templates with specific variables
+ * - Reusing existing instances when template variables match
+ * - Managing client connections per instance
+ * - Cleaning up idle instances to free resources
+ */
+export declare class ClientInstancePool {
+    private instances;
+    private templateToInstances;
+    private options;
+    private pendingCreations;
+    private reservedCreationsByTemplate;
+    private reservedCreationCount;
+    private removalOperations;
+    private supervisionPublisher?;
+    private isShuttingDown;
+    private shutdownPromise?;
+    constructor(options?: Partial<ClientPoolOptions>);
+    setSupervisionPublisher(publisher: (instance: PooledClientInstance, snapshot: BackendSupervisionSnapshot) => void): void;
+    /**
+     * Creates or retrieves a client instance for the given template and variables
+     */
+    getOrCreateClientInstance(templateName: string, templateConfig: MCPServerParams, context: ContextData, clientId: string, options?: {
+        shareable?: boolean;
+        perClient?: boolean;
+        idleTimeout?: number;
+    }): Promise<PooledClientInstance>;
+    /**
+     * Adds a client to an existing instance
+     */
+    addClientToInstance(instance: PooledClientInstance, clientId: string): PooledClientInstance;
+    /**
+     * Removes a client from an instance
+     */
+    removeClientFromInstance(instanceKey: string, clientId: string, idleSince?: Date): void;
+    /**
+     * Gets an instance by its key
+     */
+    getInstance(instanceKey: string): PooledClientInstance | undefined;
+    /**
+     * Gets an instance key by its generated instance ID
+     */
+    getInstanceKeyById(instanceId: string): string | undefined;
+    /**
+     * Gets all instances for a specific template
+     */
+    getTemplateInstances(templateName: string): PooledClientInstance[];
+    /**
+     * Resolves a full or unambiguous-prefix instance ID within one template.
+     */
+    resolveTemplateInstance(templateName: string, instanceIdOrPrefix: string): PooledClientInstance | undefined;
+    /**
+     * Gets all active instances in the pool
+     */
+    getAllInstances(): PooledClientInstance[];
+    /**
+     * Manually removes an instance from the pool
+     */
+    removeInstance(instanceKey: string): Promise<void>;
+    private scheduleRemoval;
+    private removeCapturedInstance;
+    /**
+     * Forces cleanup of idle instances
+     */
+    cleanupIdleInstances(): Promise<void>;
+    /**
+     * Shuts down the instance pool and cleans up all resources
+     */
+    shutdown(): Promise<void>;
+    private performShutdown;
+    private assertActive;
+    private createRuntimeFingerprint;
+    private disposeInstance;
+    restartInstance(instance: PooledClientInstance): Promise<BackendSupervisionSnapshot>;
+    private configureInstanceSupervision;
+    /**
+     * Gets pool statistics for monitoring
+     */
+    getStats(): {
+        totalInstances: number;
+        activeInstances: number;
+        idleInstances: number;
+        templateCount: number;
+        totalClients: number;
+    };
+    /**
+     * Gets template configuration with proper defaults
+     */
+    private getTemplateSettings;
+    /**
+     * Creates a unique instance key from template name and variable hash
+     */
+    private createInstanceKey;
+    /**
+     * Checks if creating a new instance would exceed limits
+     */
+    private reserveCreation;
+    private releaseCreationReservation;
+    /**
+     * Adds an instance to the template index
+     */
+    private addToTemplateIndex;
+    /**
+     * Removes an instance from the template index
+     */
+    private removeFromTemplateIndex;
+}
+//# sourceMappingURL=clientInstancePool.d.ts.map

package/build/sdk/legacy/server/runtime/clientInstancePool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientInstancePool.d.ts","sourceRoot":"","sources":["../../../../../src/sdk/legacy/server/runtime/clientInstancePool.ts"],"names":[],"mappings":"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"}