@1mcp/agent 0.36.0 → 0.38.0

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

@@ -0,0 +1,161 @@
+import logger, { debugIf } from '../../../../logger/logger.js';
+export async function cleanupTemplateServersForSession(sessionId, outboundConns, transports, context) {
+    context.ephemeralClients.delete(sessionId);
+    context.persistentSessions.delete(sessionId);
+    const instancesToCleanup = context.clientTemplateTracker.removeClient(sessionId);
+    logger.info(`Removing client from ${instancesToCleanup.length} template instances`, {
+        sessionId,
+        instancesToCleanup,
+    });
+    for (const instanceKey of instancesToCleanup) {
+        const [templateName, ...instanceParts] = instanceKey.split(':');
+        const instanceId = instanceParts.join(':');
+        try {
+            const sessionHashes = context.sessionToRenderedHash.get(sessionId);
+            const renderedHash = sessionHashes?.get(templateName);
+            const { outboundKey, isShareable } = resolveOutboundCleanupTarget(templateName, sessionId, renderedHash, outboundConns);
+            const poolInstanceKey = getPoolInstanceKey(context.clientInstancePool, instanceKey);
+            const instance = context.clientInstancePool.getInstance(poolInstanceKey);
+            context.clientInstancePool.removeClientFromInstance(poolInstanceKey, sessionId);
+            if (sessionHashes) {
+                sessionHashes.delete(templateName);
+                if (sessionHashes.size === 0) {
+                    context.sessionToRenderedHash.delete(sessionId);
+                }
+            }
+            debugIf(() => ({
+                message: `TemplateServerManager.cleanupTemplateServers: Successfully removed client from client instance`,
+                meta: {
+                    sessionId,
+                    templateName,
+                    instanceId,
+                    instanceKey,
+                    outboundKey,
+                    isShareable,
+                    renderedHash: renderedHash?.substring(0, 8),
+                },
+            }));
+            const remainingClients = context.clientTemplateTracker.getClientCount(templateName, instanceId);
+            cleanupOutboundConnection(outboundConns, outboundKey, isShareable, remainingClients);
+            if (!isShareable || remainingClients === 0) {
+                instance?.outboundKeys?.delete(outboundKey);
+            }
+            cleanupTransportIfUnused(transports, instanceId, remainingClients);
+            logInstanceRetention(templateName, instanceId, outboundKey, remainingClients);
+        }
+        catch (error) {
+            logger.warn(`Failed to cleanup client instance ${instanceKey}:`, {
+                error,
+                sessionId,
+                templateName,
+                instanceId,
+            });
+        }
+    }
+    logger.info(`Cleaned up template client instances for session ${sessionId}`, {
+        instancesCleaned: instancesToCleanup.length,
+    });
+}
+export async function cleanupExpiredEphemeralClients(outboundConns, transports, context) {
+    const now = new Date();
+    for (const [sessionId, clients] of Array.from(context.ephemeralClients.entries())) {
+        if (context.persistentSessions.has(sessionId)) {
+            continue;
+        }
+        for (const [templateName, trackedClient] of Array.from(clients.entries())) {
+            const idleTime = now.getTime() - trackedClient.lastUsedAt.getTime();
+            if (idleTime <= trackedClient.idleTimeout) {
+                continue;
+            }
+            const instance = context.clientInstancePool.getInstance(trackedClient.instanceKey) ??
+                context.clientInstancePool.getInstance(`${templateName}:${trackedClient.instanceKey}`);
+            context.clientInstancePool.removeClientFromInstance(trackedClient.instanceKey, sessionId, trackedClient.lastUsedAt);
+            const shouldCleanup = context.clientTemplateTracker.removeClientFromInstance(sessionId, templateName, trackedClient.instanceId);
+            const sessionHashes = context.sessionToRenderedHash.get(sessionId);
+            sessionHashes?.delete(templateName);
+            if (sessionHashes?.size === 0) {
+                context.sessionToRenderedHash.delete(sessionId);
+            }
+            const remainingClients = context.clientTemplateTracker.getClientCount(templateName, trackedClient.instanceId);
+            if (shouldCleanup || remainingClients === 0) {
+                outboundConns.delete(trackedClient.outboundKey);
+                instance?.outboundKeys?.delete(trackedClient.outboundKey);
+                delete transports[trackedClient.instanceId];
+                context.clientTemplateTracker.cleanupInstance(templateName, trackedClient.instanceId);
+            }
+            clients.delete(templateName);
+            debugIf(() => ({
+                message: 'Expired ephemeral template client',
+                meta: {
+                    sessionId,
+                    templateName,
+                    instanceId: trackedClient.instanceId,
+                    instanceKey: trackedClient.instanceKey,
+                    idleTime,
+                    instanceFound: Boolean(instance),
+                },
+            }));
+        }
+        if (clients.size === 0) {
+            context.ephemeralClients.delete(sessionId);
+        }
+    }
+}
+function resolveOutboundCleanupTarget(templateName, sessionId, renderedHash, outboundConns) {
+    if (!renderedHash) {
+        return { outboundKey: `${templateName}:${sessionId}`, isShareable: false };
+    }
+    const hashKey = `${templateName}:${renderedHash}`;
+    const sessionKey = `${templateName}:${sessionId}`;
+    if (outboundConns.has(hashKey)) {
+        return { outboundKey: hashKey, isShareable: true };
+    }
+    return { outboundKey: sessionKey, isShareable: false };
+}
+function cleanupOutboundConnection(outboundConns, outboundKey, isShareable, remainingClients) {
+    if (isShareable && remainingClients === 0) {
+        const removed = outboundConns.delete(outboundKey);
+        if (removed) {
+            logger.debug(`Removed shareable template server from outbound connections: ${outboundKey}`);
+        }
+        return;
+    }
+    if (!isShareable) {
+        const removed = outboundConns.delete(outboundKey);
+        if (removed) {
+            logger.debug(`Removed template server from outbound connections: ${outboundKey}`);
+        }
+        return;
+    }
+    debugIf(() => ({
+        message: `Shareable template server still has clients, keeping connection`,
+        meta: { outboundKey, remainingClients },
+    }));
+}
+function cleanupTransportIfUnused(transports, instanceId, remainingClients) {
+    if (remainingClients === 0 && instanceId) {
+        delete transports[instanceId];
+        logger.debug(`Removed transport for instance: ${instanceId}`);
+    }
+}
+function logInstanceRetention(templateName, instanceId, outboundKey, remainingClients) {
+    if (remainingClients === 0) {
+        logger.debug(`Client instance ${instanceId} has no more clients, marking as idle for cleanup after timeout`, {
+            templateName,
+            instanceId,
+            idleTimeout: 5 * 60 * 1000,
+        });
+        return;
+    }
+    debugIf(() => ({
+        message: `Client instance ${instanceId} still has ${remainingClients} clients, keeping connection open`,
+        meta: { instanceId, outboundKey, remainingClients },
+    }));
+}
+function getPoolInstanceKey(clientInstancePool, trackerInstanceKey) {
+    const [, ...instanceParts] = trackerInstanceKey.split(':');
+    const instanceId = instanceParts.join(':');
+    const poolInstanceKey = clientInstancePool.getInstanceKeyById(instanceId);
+    return poolInstanceKey ?? trackerInstanceKey;
+}
+//# sourceMappingURL=templateServerCleanup.js.map

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

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

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

@@ -0,0 +1,155 @@
+import { ClientTemplateTracker, TemplateIndex } from '../../../../core/filtering/index.js';
+import { InstructionAggregator } from '../../../../core/instructions/instructionAggregator.js';
+import type { BackendSupervisionSnapshot } from '../../../../core/server/backendStdioSupervisor.js';
+import { ClientInstancePool, type PooledClientInstance } from '../../../../core/server/clientInstancePool.js';
+import { type TemplateInstancePoolPolicy } from '../../../../core/server/clientInstancePoolTypes.js';
+import type { OutboundConnections } from '../../../../core/types/client.js';
+import { MCPServerParams } from '../../../../core/types/index.js';
+import type { InboundConnectionConfig } from '../../../../core/types/server.js';
+import { Transport } from '../../../../sdk/legacy/shared/transport.js';
+import type { ContextData } from '../../../../types/context.js';
+/**
+ * Options for rebuilding the template index
+ */
+export interface TemplateRebuildOptions {
+    mcpTemplates?: Record<string, MCPServerParams>;
+}
+export interface TemplateRebuildResult {
+    toolMetadataChanged: boolean;
+}
+export interface TemplateDefinitionRuntimeImpact {
+    activeInstancesBefore: number;
+    retiredInstances: number;
+    activeInstancesAfter: number;
+    retirementObserved: boolean;
+    error?: string;
+}
+export type TemplateClientLifecycle = 'persistent' | 'ephemeral';
+export interface RuntimeTemplateReloadTarget {
+    sessionId: string;
+    templateName: string;
+    lifecycle: TemplateClientLifecycle;
+}
+/**
+ * Manages template-based server instances and client pools
+ */
+export declare class TemplateServerManager {
+    private clientInstancePool;
+    private templateSessionMap?;
+    private cleanupTimer?;
+    private instructionAggregator?;
+    private ephemeralClients;
+    private persistentSessions;
+    private outboundConns?;
+    private transports?;
+    private templateConfigHashes;
+    private templateToolMetadataHashes;
+    private templateRetirements;
+    private sessionToRenderedHash;
+    private clientTemplateTracker;
+    private templateIndex;
+    private failedTemplates;
+    private readonly poolPolicy;
+    constructor(poolPolicy?: Partial<TemplateInstancePoolPolicy>);
+    /**
+     * Set the instruction aggregator for extracting and caching server instructions
+     */
+    setInstructionAggregator(aggregator: InstructionAggregator): void;
+    /**
+     * Starts the periodic cleanup timer for idle template instances
+     */
+    private startCleanupTimer;
+    /**
+     * Create template-based servers for a client connection
+     */
+    createTemplateBasedServers(sessionId: string, context: ContextData, opts: InboundConnectionConfig, serverConfigData: {
+        mcpTemplates?: Record<string, MCPServerParams>;
+    }, // MCPServerConfiguration with templates
+    outboundConns: OutboundConnections, transports: Record<string, Transport>, lifecycle?: TemplateClientLifecycle): Promise<void>;
+    /**
+     * Clean up template-based servers when a client disconnects
+     */
+    cleanupTemplateServers(sessionId: string, outboundConns: OutboundConnections, transports: Record<string, Transport>): Promise<void>;
+    trackPersistentClient(sessionId: string): void;
+    trackEphemeralClient(sessionId: string, templateName: string, instance: PooledClientInstance, outboundKey?: string): void;
+    touchEphemeralClient(sessionId: string, templateName?: string): void;
+    /**
+     * Get template configurations that match the client's filter criteria
+     */
+    private getMatchingTemplateConfigs;
+    /**
+     * Get idle template instances for cleanup
+     */
+    getIdleTemplateInstances(idleTimeoutMs?: number): Array<{
+        templateName: string;
+        instanceId: string;
+        idleTime: number;
+    }>;
+    /**
+     * Resolve an operational template instance target by full ID or unique prefix.
+     */
+    resolveTemplateInstance(templateName: string, instanceIdOrPrefix: string): PooledClientInstance | undefined;
+    getTemplateInstances(templateName: string): PooledClientInstance[];
+    getTemplateActiveInstanceCount(templateName: string): number;
+    getTemplateActiveInstanceIdentities(templateName: string): string[];
+    observeTemplateDefinitionRetirement(templateName: string, instanceIdentities: readonly string[]): Promise<TemplateDefinitionRuntimeImpact>;
+    private countRemainingTemplateInstances;
+    restartTemplateInstance(instance: PooledClientInstance): Promise<BackendSupervisionSnapshot>;
+    private publishTemplateSupervision;
+    private refreshTemplateInstructions;
+    /**
+     * Force cleanup of idle template instances
+     */
+    cleanupIdleInstances(outboundConns?: OutboundConnections, transports?: Record<string, Transport>): Promise<number>;
+    /**
+     * Rebuild the template index
+     */
+    rebuildTemplateIndex(serverConfigData?: TemplateRebuildOptions): TemplateRebuildResult;
+    /** Retire only rendered instances whose effective Runtime Scope inputs changed. */
+    retireTemplatesForRuntimeEnvironment(_declaredTemplateNames: readonly string[]): Promise<RuntimeTemplateReloadTarget[]>;
+    private retireRuntimeTemplateInstance;
+    private scheduleTemplateRetirement;
+    private retireTemplateInstances;
+    /**
+     * Get enhanced filtering statistics
+     */
+    getFilteringStats(): {
+        tracker: ReturnType<ClientTemplateTracker['getStats']> | null;
+        index: ReturnType<TemplateIndex['getStats']> | null;
+        enabled: boolean;
+    };
+    /**
+     * Get detailed client template tracking information
+     */
+    getClientTemplateInfo(): ReturnType<ClientTemplateTracker['getDetailedInfo']>;
+    /**
+     * Get the client instance pool
+     */
+    getClientInstancePool(): ClientInstancePool;
+    /**
+     * Get failed template server creation attempts
+     */
+    getFailedTemplates(): Array<{
+        templateName: string;
+        sessionId: string;
+        error: string;
+        timestamp: Date;
+    }>;
+    /**
+     * Get the rendered hash for a specific session and template
+     * Used by resolveOutboundConnection to determine the correct outbound key
+     */
+    getRenderedHashForSession(sessionId: string, templateName: string): string | undefined;
+    /**
+     * Get all rendered hashes for a specific session
+     * Used by filterConnectionsForSession to determine which connections to include
+     * Returns Map<templateName, renderedHash>
+     */
+    getAllRenderedHashesForSession(sessionId: string): Map<string, string> | undefined;
+    /**
+     * Clean up resources (for shutdown)
+     */
+    shutdown(): Promise<void>;
+    cleanup(): void;
+}
+//# sourceMappingURL=templateServerManager.d.ts.map

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

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