agent-discover 1.3.8 → 1.4.0

package/dist/domain/proxy.d.ts

@@ -1,6 +1,90 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
 import type { SecretsService } from './secrets.js';
 import type { MetricsService } from './metrics.js';
 import type { LogService } from './log.js';
+type AnyTransport = StdioClientTransport | SSEClientTransport | StreamableHTTPClientTransport;
+export type ResourceEntry = {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+    size?: number;
+};
+export type ResourceTemplateEntry = {
+    uriTemplate: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+};
+export type PromptEntry = {
+    name: string;
+    description?: string;
+    arguments?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+    }>;
+};
+export type ServerInfo = {
+    name: string;
+    version: string;
+    instructions?: string;
+    capabilities: Record<string, unknown>;
+};
+interface ActiveServer {
+    client: Client;
+    transport: AnyTransport;
+    tools: Array<{
+        name: string;
+        description?: string;
+        inputSchema?: Record<string, unknown>;
+    }>;
+    config: ServerConfig;
+    capabilities?: Record<string, unknown>;
+    serverVersion?: {
+        name: string;
+        version: string;
+    };
+    instructions?: string;
+    transient: boolean;
+    interactive: boolean;
+    lastPingMs?: number;
+}
+export interface PendingElicitation {
+    id: string;
+    serverName: string;
+    message: string;
+    requestedSchema: Record<string, unknown>;
+    createdAt: number;
+}
+export type ElicitationAction = 'accept' | 'decline' | 'cancel';
+export interface SamplingProvider {
+    createMessage(request: {
+        serverName: string;
+        messages: Array<{
+            role: string;
+            content: {
+                type: string;
+                text?: string;
+            };
+        }>;
+        maxTokens?: number;
+        temperature?: number;
+        systemPrompt?: string;
+        modelPreferences?: Record<string, unknown>;
+    }): Promise<{
+        role: 'assistant';
+        content: {
+            type: 'text';
+            text: string;
+        };
+        model: string;
+        stopReason?: string;
+    }>;
+}
 export interface ServerConfig {
     name: string;
     command?: string;
@@ -19,13 +103,31 @@ export interface ParsedToolName {
     serverName: string;
     toolName: string;
 }
+export interface TransientHandle {
+    handle: string;
+    serverName: string;
+    tools: ActiveServer['tools'];
+    capabilities: Record<string, unknown>;
+    serverVersion?: {
+        name: string;
+        version: string;
+    };
+    expiresAt: number;
+}
 export declare class McpProxy {
     private readonly activeServers;
     private readonly activating;
+    private readonly transient;
+    private transientSeq;
     private secretsService?;
     private metricsService?;
     private logService?;
     private serverIdResolver?;
+    private rootsProvider;
+    private samplingProvider?;
+    private readonly elicitations;
+    private elicitationListener?;
+    private elicitationSeq;
     setSecretsService(secrets: SecretsService): void;
     setMetricsService(metrics: MetricsService): void;
     setLogService(logs: LogService): void;
@@ -35,6 +137,7 @@ export declare class McpProxy {
         description?: string;
         inputSchema?: Record<string, unknown>;
     }>>;
+    private activateInternal;
     deactivate(name: string): Promise<void>;
     callTool(serverName: string, toolName: string, args?: Record<string, unknown>): Promise<{
         content: Array<{
@@ -53,7 +156,57 @@ export declare class McpProxy {
         description?: string;
     }>;
     isActive(name: string): boolean;
+    getServerInfo(name: string): ServerInfo | null;
+    listToolsLive(name: string): Promise<ActiveServer['tools']>;
+    listResources(name: string, cursor?: string): Promise<{
+        resources: ResourceEntry[];
+        nextCursor?: string;
+    }>;
+    listResourceTemplates(name: string, cursor?: string): Promise<{
+        resourceTemplates: ResourceTemplateEntry[];
+        nextCursor?: string;
+    }>;
+    readResource(name: string, uri: string): Promise<{
+        contents: Array<Record<string, unknown>>;
+    }>;
+    subscribeResource(name: string, uri: string): Promise<void>;
+    unsubscribeResource(name: string, uri: string): Promise<void>;
+    listPrompts(name: string, cursor?: string): Promise<{
+        prompts: PromptEntry[];
+        nextCursor?: string;
+    }>;
+    getPrompt(name: string, promptName: string, args?: Record<string, string>): Promise<{
+        messages: Array<Record<string, unknown>>;
+        description?: string;
+    }>;
+    ping(name: string): Promise<{
+        ok: boolean;
+        rtt_ms: number;
+    }>;
+    setLoggingLevel(name: string, level: 'debug' | 'info' | 'notice' | 'warning' | 'error' | 'critical' | 'alert' | 'emergency'): Promise<void>;
+    exportConfig(name: string, format: 'mcp-json' | 'agent-discover'): Record<string, unknown>;
+    activateTransient(config: ServerConfig, ttlMs?: number): Promise<TransientHandle>;
+    releaseTransient(handle: string): Promise<void>;
+    resolveTransient(handle: string): string | null;
+    private pruneTransient;
+    setRootsProvider(provider: () => Array<{
+        uri: string;
+        name?: string;
+    }>): void;
+    private wireRootsHandler;
+    private wireNotificationHandler;
+    private requireActive;
+    setElicitationListener(listener: (pending: PendingElicitation) => void): void;
+    listPendingElicitations(): PendingElicitation[];
+    respondElicitation(id: string, response: {
+        action: ElicitationAction;
+        content?: Record<string, unknown>;
+    }): boolean;
+    private wireElicitationHandler;
+    setSamplingProvider(provider: SamplingProvider): void;
+    private wireSamplingHandler;
     private createTransport;
     deactivateAll(): Promise<void>;
 }
+export {};
 //# sourceMappingURL=proxy.d.ts.map

package/dist/domain/proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/domain/proxy.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAwC3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,iBAAiB,CAAC;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmC;IAKjE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,gBAAgB,CAAC,CAAkC;IAE3D,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIhD,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIhD,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAIrC,mBAAmB,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,IAAI;IAI9D,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAC3C,KAAK,CAAC;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvC,CAAC,CACH;IA6DK,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvC,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC;QACT,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IAoCF,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,SAAS;IAgBjB,kBAAkB,IAAI,WAAW,EAAE;IAcnC,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAgB5D,oBAAoB,IAAI,MAAM,EAAE;IAIhC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAK3E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B,OAAO,CAAC,eAAe;IA2DjB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAUrC"}
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/domain/proxy.ts"],"names":[],"mappings":"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"}

package/dist/domain/proxy.js

@@ -10,6 +10,7 @@ import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
 import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { ElicitRequestSchema, CreateMessageRequestSchema, ListRootsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { version } from '../version.js';
 const ACTIVATE_TIMEOUT_MS = 60_000;
 const CALL_TIMEOUT_MS = 60_000;
@@ -31,6 +32,9 @@ function withTimeout(promise, ms, label) {
         new Promise((_resolve, reject) => setTimeout(() => reject(new Error(`${label} timed out after ${ms}ms`)), ms)),
     ]);
 }
+const TRANSIENT_TTL_MS = 15 * 60_000;
+const TRANSIENT_NAME_PREFIX = '__transient__';
+const ELICITATION_TIMEOUT_MS = 2 * 60_000;
 export class McpProxy {
     activeServers = new Map();
     // Names currently mid-activation. Held only across the connect/listTools
@@ -38,10 +42,17 @@ export class McpProxy {
     // child processes (the original `if (activeServers.has(name))` guard
     // races because both callers pass it before either awaits).
     activating = new Set();
+    transient = new Map();
+    transientSeq = 0;
     secretsService;
     metricsService;
     logService;
     serverIdResolver;
+    rootsProvider = () => [];
+    samplingProvider;
+    elicitations = new Map();
+    elicitationListener;
+    elicitationSeq = 0;
     setSecretsService(secrets) {
         this.secretsService = secrets;
     }
@@ -55,6 +66,9 @@ export class McpProxy {
         this.serverIdResolver = resolver;
     }
     async activate(config) {
+        return this.activateInternal(config, false, false);
+    }
+    async activateInternal(config, transient, interactive) {
         if (this.activeServers.has(config.name) || this.activating.has(config.name)) {
             throw new Error(`Server "${config.name}" is already active`);
         }
@@ -63,12 +77,42 @@ export class McpProxy {
         this.activating.add(config.name);
         try {
             const transport = this.createTransport(config);
-            const client = new Client({ name: 'agent-discover', version }, { capabilities: {} });
+            const advertisedCapabilities = {
+                roots: { listChanged: true },
+                elicitation: {},
+            };
+            if (interactive) {
+                advertisedCapabilities.sampling = {};
+            }
+            const client = new Client({ name: 'agent-discover', version }, { capabilities: advertisedCapabilities });
+            this.wireRootsHandler(client);
+            this.wireNotificationHandler(client, config.name);
+            if (interactive) {
+                this.wireElicitationHandler(client, config.name);
+                this.wireSamplingHandler(client, config.name);
+            }
             try {
                 await withTimeout(client.connect(transport), ACTIVATE_TIMEOUT_MS, 'connect');
+                const capabilities = typeof client.getServerCapabilities === 'function'
+                    ? client.getServerCapabilities()
+                    : undefined;
+                const serverVersion = typeof client.getServerVersion === 'function' ? client.getServerVersion() : undefined;
+                const instructions = typeof client.getInstructions === 'function' ? client.getInstructions() : undefined;
                 const result = await withTimeout(client.listTools(), ACTIVATE_TIMEOUT_MS, 'listTools');
                 const tools = result.tools ?? [];
-                this.activeServers.set(config.name, { client, transport, tools, config });
+                this.activeServers.set(config.name, {
+                    client,
+                    transport,
+                    tools,
+                    config,
+                    capabilities: capabilities,
+                    serverVersion: serverVersion
+                        ? { name: serverVersion.name, version: serverVersion.version }
+                        : undefined,
+                    instructions,
+                    transient,
+                    interactive,
+                });
                 return tools;
             }
             catch (err) {
@@ -131,8 +175,19 @@ export class McpProxy {
         if (!server)
             throw new Error(`Server "${serverName}" is not active`);
         const start = Date.now();
+        const logs = this.logService;
+        const onprogress = (notification) => {
+            try {
+                logs?.pushProgress(serverName, notification.progressToken ?? toolName, notification.progress ?? 0, notification.total, notification.message);
+            }
+            catch {
+                /* ignore */
+            }
+        };
         try {
-            const result = await withTimeout(server.client.callTool({ name: toolName, arguments: args ?? {} }), CALL_TIMEOUT_MS, `${serverName}/${toolName}`);
+            const result = await withTimeout(server.client.callTool({ name: toolName, arguments: args ?? {} }, undefined, {
+                onprogress,
+            }), CALL_TIMEOUT_MS, `${serverName}/${toolName}`);
             const typed = result;
             const latency = Date.now() - start;
             const success = !typed.isError;
@@ -215,6 +270,344 @@ export class McpProxy {
     isActive(name) {
         return this.activeServers.has(name);
     }
+    // ---------------------------------------------------------------------------
+    // Tester surface — server info, resources, prompts, ping, logging level
+    // ---------------------------------------------------------------------------
+    getServerInfo(name) {
+        const server = this.activeServers.get(name);
+        if (!server)
+            return null;
+        return {
+            name: server.serverVersion?.name ?? server.config.name,
+            version: server.serverVersion?.version ?? '',
+            instructions: server.instructions,
+            capabilities: server.capabilities ?? {},
+        };
+    }
+    async listToolsLive(name) {
+        const server = this.requireActive(name);
+        const result = await withTimeout(server.client.listTools(), CALL_TIMEOUT_MS, 'listTools');
+        const tools = result.tools ?? [];
+        server.tools = tools;
+        return tools;
+    }
+    async listResources(name, cursor) {
+        const server = this.requireActive(name);
+        const params = cursor ? { cursor } : undefined;
+        const result = await withTimeout(server.client.listResources(params), CALL_TIMEOUT_MS, 'listResources');
+        return {
+            resources: (result.resources ?? []).map((r) => ({
+                uri: r.uri,
+                name: r.name,
+                description: r.description,
+                mimeType: r.mimeType,
+                size: r.size,
+            })),
+            nextCursor: result.nextCursor,
+        };
+    }
+    async listResourceTemplates(name, cursor) {
+        const server = this.requireActive(name);
+        const params = cursor ? { cursor } : undefined;
+        const result = await withTimeout(server.client.listResourceTemplates(params), CALL_TIMEOUT_MS, 'listResourceTemplates');
+        return {
+            resourceTemplates: (result.resourceTemplates ?? []).map((t) => ({
+                uriTemplate: t.uriTemplate,
+                name: t.name,
+                description: t.description,
+                mimeType: t.mimeType,
+            })),
+            nextCursor: result.nextCursor,
+        };
+    }
+    async readResource(name, uri) {
+        const server = this.requireActive(name);
+        const start = Date.now();
+        try {
+            const result = await withTimeout(server.client.readResource({ uri }), CALL_TIMEOUT_MS, `${name}/readResource`);
+            const latency = Date.now() - start;
+            this.logService?.push(name, uri, { uri }, JSON.stringify(result.contents), latency, true, 'resource-read');
+            return { contents: result.contents };
+        }
+        catch (err) {
+            const latency = Date.now() - start;
+            const msg = err instanceof Error ? err.message : String(err);
+            this.logService?.push(name, uri, { uri }, msg, latency, false, 'resource-read');
+            throw err;
+        }
+    }
+    async subscribeResource(name, uri) {
+        const server = this.requireActive(name);
+        await withTimeout(server.client.subscribeResource({ uri }), CALL_TIMEOUT_MS, 'subscribe');
+    }
+    async unsubscribeResource(name, uri) {
+        const server = this.requireActive(name);
+        await withTimeout(server.client.unsubscribeResource({ uri }), CALL_TIMEOUT_MS, 'unsubscribe');
+    }
+    async listPrompts(name, cursor) {
+        const server = this.requireActive(name);
+        const params = cursor ? { cursor } : undefined;
+        const result = await withTimeout(server.client.listPrompts(params), CALL_TIMEOUT_MS, 'listPrompts');
+        return {
+            prompts: (result.prompts ?? []).map((p) => ({
+                name: p.name,
+                description: p.description,
+                arguments: p.arguments,
+            })),
+            nextCursor: result.nextCursor,
+        };
+    }
+    async getPrompt(name, promptName, args) {
+        const server = this.requireActive(name);
+        const start = Date.now();
+        try {
+            const result = await withTimeout(server.client.getPrompt({ name: promptName, arguments: args ?? {} }), CALL_TIMEOUT_MS, `${name}/getPrompt/${promptName}`);
+            const latency = Date.now() - start;
+            this.logService?.push(name, promptName, (args ?? {}), JSON.stringify(result.messages), latency, true, 'prompt-get');
+            return {
+                messages: result.messages,
+                description: result.description,
+            };
+        }
+        catch (err) {
+            const latency = Date.now() - start;
+            const msg = err instanceof Error ? err.message : String(err);
+            this.logService?.push(name, promptName, (args ?? {}), msg, latency, false, 'prompt-get');
+            throw err;
+        }
+    }
+    async ping(name) {
+        const server = this.requireActive(name);
+        const start = Date.now();
+        try {
+            await withTimeout(server.client.ping(), CALL_TIMEOUT_MS, 'ping');
+            const rtt = Date.now() - start;
+            server.lastPingMs = rtt;
+            this.logService?.push(name, 'ping', {}, 'pong', rtt, true, 'ping');
+            return { ok: true, rtt_ms: rtt };
+        }
+        catch (err) {
+            const rtt = Date.now() - start;
+            const msg = err instanceof Error ? err.message : String(err);
+            this.logService?.push(name, 'ping', {}, msg, rtt, false, 'ping');
+            throw err;
+        }
+    }
+    async setLoggingLevel(name, level) {
+        const server = this.requireActive(name);
+        await withTimeout(server.client.setLoggingLevel(level), CALL_TIMEOUT_MS, 'setLoggingLevel');
+    }
+    exportConfig(name, format) {
+        const server = this.activeServers.get(name);
+        if (!server)
+            throw new Error(`Server "${name}" is not active`);
+        const cfg = server.config;
+        const entry = {};
+        if (cfg.transport === 'sse' || cfg.transport === 'streamable-http') {
+            entry.type = cfg.transport === 'sse' ? 'sse' : 'http';
+            if (cfg.url)
+                entry.url = cfg.url;
+            if (cfg.headers && Object.keys(cfg.headers).length > 0)
+                entry.headers = cfg.headers;
+        }
+        else {
+            if (cfg.command)
+                entry.command = cfg.command;
+            if (cfg.args && cfg.args.length > 0)
+                entry.args = cfg.args;
+            if (cfg.env && Object.keys(cfg.env).length > 0)
+                entry.env = cfg.env;
+        }
+        if (format === 'agent-discover') {
+            return { servers: [{ name: cfg.name, ...entry, auto_activate: true }] };
+        }
+        return { mcpServers: { [cfg.name]: entry } };
+    }
+    // ---------------------------------------------------------------------------
+    // Transient (ad-hoc) servers
+    // ---------------------------------------------------------------------------
+    async activateTransient(config, ttlMs = TRANSIENT_TTL_MS) {
+        this.pruneTransient();
+        const handle = `${Date.now().toString(36)}-${(++this.transientSeq).toString(36)}`;
+        const serverName = `${TRANSIENT_NAME_PREFIX}${handle}`;
+        const merged = { ...config, name: serverName };
+        const tools = await this.activateInternal(merged, true, true);
+        const expiresAt = Date.now() + ttlMs;
+        this.transient.set(handle, { serverName, expiresAt });
+        const active = this.activeServers.get(serverName);
+        setTimeout(() => {
+            this.releaseTransient(handle).catch(() => { });
+        }, ttlMs).unref?.();
+        return {
+            handle,
+            serverName,
+            tools,
+            capabilities: active.capabilities ?? {},
+            serverVersion: active.serverVersion,
+            expiresAt,
+        };
+    }
+    async releaseTransient(handle) {
+        const entry = this.transient.get(handle);
+        if (!entry)
+            return;
+        this.transient.delete(handle);
+        if (this.activeServers.has(entry.serverName)) {
+            try {
+                await this.deactivate(entry.serverName);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+    resolveTransient(handle) {
+        const entry = this.transient.get(handle);
+        if (!entry)
+            return null;
+        if (entry.expiresAt < Date.now()) {
+            this.releaseTransient(handle).catch(() => { });
+            return null;
+        }
+        return entry.serverName;
+    }
+    pruneTransient() {
+        const now = Date.now();
+        for (const [handle, entry] of this.transient.entries()) {
+            if (entry.expiresAt < now) {
+                this.releaseTransient(handle).catch(() => { });
+            }
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Roots provider (advertises client roots capability)
+    // ---------------------------------------------------------------------------
+    setRootsProvider(provider) {
+        this.rootsProvider = provider;
+    }
+    wireRootsHandler(client) {
+        try {
+            client.setRequestHandler(ListRootsRequestSchema, async () => ({
+                roots: this.rootsProvider(),
+            }));
+        }
+        catch {
+            /* roots handler is best-effort; failures don't block activation */
+        }
+    }
+    wireNotificationHandler(client, serverName) {
+        const anyClient = client;
+        const logs = this.logService;
+        anyClient.fallbackNotificationHandler = async (n) => {
+            try {
+                if (!logs)
+                    return;
+                if (n.method === 'notifications/progress' && n.params) {
+                    const p = n.params;
+                    logs.pushProgress(serverName, p.progressToken ?? 0, p.progress ?? 0, p.total, p.message);
+                }
+                else {
+                    logs.pushNotification(serverName, n.method, (n.params ?? {}));
+                }
+            }
+            catch {
+                /* ignore */
+            }
+        };
+    }
+    requireActive(name) {
+        const server = this.activeServers.get(name);
+        if (!server)
+            throw new Error(`Server "${name}" is not active`);
+        return server;
+    }
+    // ---------------------------------------------------------------------------
+    // Elicitation — only wired on interactive (transient) clients
+    // ---------------------------------------------------------------------------
+    setElicitationListener(listener) {
+        this.elicitationListener = listener;
+    }
+    listPendingElicitations() {
+        return [...this.elicitations.values()].map((e) => e.request);
+    }
+    respondElicitation(id, response) {
+        const entry = this.elicitations.get(id);
+        if (!entry)
+            return false;
+        this.elicitations.delete(id);
+        clearTimeout(entry.timer);
+        entry.resolve(response);
+        return true;
+    }
+    wireElicitationHandler(client, serverName) {
+        client.setRequestHandler(ElicitRequestSchema, async (req) => {
+            const params = req.params;
+            const id = `elicit-${Date.now().toString(36)}-${(++this.elicitationSeq).toString(36)}`;
+            const pending = {
+                id,
+                serverName,
+                message: params.message ?? '',
+                requestedSchema: params.requestedSchema ?? { type: 'object', properties: {} },
+                createdAt: Date.now(),
+            };
+            this.logService?.push(serverName, 'elicitation/create', pending.requestedSchema, pending.message, 0, true, 'elicitation');
+            return new Promise((resolve) => {
+                const timer = setTimeout(() => {
+                    if (this.elicitations.has(id)) {
+                        this.elicitations.delete(id);
+                        resolve({ action: 'cancel' });
+                    }
+                }, ELICITATION_TIMEOUT_MS);
+                this.elicitations.set(id, { serverName, resolve, timer, request: pending });
+                try {
+                    this.elicitationListener?.(pending);
+                }
+                catch {
+                    /* ignore listener errors */
+                }
+            }).then((response) => {
+                return response.action === 'accept' && response.content
+                    ? { action: 'accept', content: response.content }
+                    : { action: response.action };
+            });
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Sampling — only wired on interactive (transient) clients
+    // ---------------------------------------------------------------------------
+    setSamplingProvider(provider) {
+        this.samplingProvider = provider;
+    }
+    wireSamplingHandler(client, serverName) {
+        client.setRequestHandler(CreateMessageRequestSchema, async (req) => {
+            const params = req.params;
+            const start = Date.now();
+            if (!this.samplingProvider) {
+                const message = 'sampling/createMessage: no sampling provider configured (set AGENT_DISCOVER_OPENAI_API_KEY or OPENAI_API_KEY to enable)';
+                this.logService?.push(serverName, 'sampling/createMessage', params, message, 0, false, 'sampling');
+                throw new Error(message);
+            }
+            try {
+                const result = await this.samplingProvider.createMessage({
+                    serverName,
+                    messages: params.messages,
+                    maxTokens: params.maxTokens,
+                    temperature: params.temperature,
+                    systemPrompt: params.systemPrompt,
+                    modelPreferences: params.modelPreferences,
+                });
+                const latency = Date.now() - start;
+                this.logService?.push(serverName, 'sampling/createMessage', params, result.content.text, latency, true, 'sampling');
+                return result;
+            }
+            catch (err) {
+                const latency = Date.now() - start;
+                const msg = err instanceof Error ? err.message : String(err);
+                this.logService?.push(serverName, 'sampling/createMessage', params, msg, latency, false, 'sampling');
+                throw err;
+            }
+        });
+    }
     createTransport(config) {
         const transportType = config.transport ?? 'stdio';
         if ((transportType === 'streamable-http' || transportType === 'sse') && config.url) {