@revealui/mcp 0.1.11 → 0.2.0

package/dist/client.js

@@ -0,0 +1,492 @@
+/**
+ * MCP Client wrapper for `@revealui/mcp`.
+ *
+ * Phase: Stage 0 of the MCP v1 plan (see `.jv/docs/mcp-productionization-scope.md`).
+ *
+ * Wraps `@modelcontextprotocol/sdk`'s `Client` with a RevealUI-shaped surface:
+ * transport selection, capability enforcement (method throws a typed error if
+ * the server doesn't advertise the feature), per-URI resource subscription
+ * fan-out, and application-layer handlers for the server-initiated primitives
+ * (sampling, elicitation, roots).
+ *
+ * Stage 0 completion as of PR-0.3:
+ *   PR-0.1 — resources + prompts.
+ *   PR-0.2 — sampling + elicitation + roots + completions.
+ *   PR-0.3 — logging, progress, cancellation, generic notification routing,
+ *            per-request options (signal + onProgress + timeout) threaded
+ *            through every client-initiated call.
+ *
+ * The hypervisor (`./hypervisor.ts`) continues to speak its custom JSON-RPC
+ * for tool calls. Stage 1 migrates the hypervisor to route through this
+ * client so transport abstraction (Streamable HTTP) lands cleanly.
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { StreamableHTTPClientTransport, } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { CreateMessageRequestSchema, ElicitRequestSchema, ListRootsRequestSchema, LoggingMessageNotificationSchema, ResourceUpdatedNotificationSchema, } from '@modelcontextprotocol/sdk/types.js';
+/** Internal: translate our options to the SDK's native shape. */
+function toSdkRequestOptions(options) {
+    if (!options)
+        return undefined;
+    const sdkOptions = {};
+    if (options.signal)
+        sdkOptions.signal = options.signal;
+    if (options.onProgress)
+        sdkOptions.onprogress = options.onProgress;
+    if (options.timeout !== undefined)
+        sdkOptions.timeout = options.timeout;
+    if (options.resetTimeoutOnProgress !== undefined) {
+        sdkOptions.resetTimeoutOnProgress = options.resetTimeoutOnProgress;
+    }
+    return sdkOptions;
+}
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
+/**
+ * Thrown when a caller invokes a method that requires a server-side capability
+ * the server did NOT advertise during initialize. Signals a misconfiguration
+ * or a version mismatch — not a transient failure; do not retry.
+ */
+export class McpCapabilityError extends Error {
+    capability;
+    constructor(capability) {
+        super(`MCP server does not advertise the '${capability}' capability`);
+        this.name = 'McpCapabilityError';
+        this.capability = capability;
+    }
+}
+/**
+ * Thrown when a method is called before `connect()` has resolved.
+ */
+export class McpNotConnectedError extends Error {
+    constructor(method) {
+        super(`McpClient.${method}() called before connect()`);
+        this.name = 'McpNotConnectedError';
+    }
+}
+// ---------------------------------------------------------------------------
+// Capability auto-advertisement
+// ---------------------------------------------------------------------------
+/**
+ * Derive the client capability declaration from which handlers/providers the
+ * caller supplied. Only features we can actually service get advertised.
+ *
+ * Form-mode elicitation is advertised as the default when an elicitation
+ * handler is provided (matches the SDK's interpretation of `elicitation: {}`).
+ * URL-mode callers who want that surface explicitly can add it — future
+ * enhancement; today the handler is a single entry point.
+ */
+function buildCapabilities(options) {
+    const caps = {};
+    if (options.samplingHandler)
+        caps.sampling = {};
+    if (options.elicitationHandler)
+        caps.elicitation = {};
+    if (options.rootsProvider)
+        caps.roots = { listChanged: true };
+    return caps;
+}
+export class McpClient {
+    sdk;
+    options;
+    connected = false;
+    /**
+     * Tracks the Streamable HTTP transport when that kind is in use, so
+     * `finishAuth()` can delegate to it. Set by `createTransport`, cleared
+     * on `close()`.
+     */
+    httpTransport;
+    resourceSubscribers = new Map();
+    listChangedHandlers = {
+        resources: new Set(),
+        prompts: new Set(),
+        tools: new Set(),
+    };
+    /**
+     * Subscribers per notification schema. First `on(schema, handler)` call for
+     * a schema registers a single fan-out handler with the SDK; subsequent
+     * calls just add to the Set. Removing the last subscriber keeps the SDK
+     * handler registered (no public API to unregister by schema) — empty
+     * fan-out is a cheap no-op.
+     */
+    notificationSubscribers = new Map();
+    constructor(options) {
+        this.options = options;
+        this.sdk = new Client(options.clientInfo, {
+            capabilities: buildCapabilities(options),
+            listChanged: {
+                resources: { onChanged: () => this.fireListChanged('resources') },
+                prompts: { onChanged: () => this.fireListChanged('prompts') },
+                tools: { onChanged: () => this.fireListChanged('tools') },
+            },
+        });
+        // Route resource-updated notifications through the generic fan-out so the
+        // same `on(ResourceUpdatedNotificationSchema, ...)` subscription API
+        // remains available without overwriting our per-URI subscriber dispatch.
+        this.on(ResourceUpdatedNotificationSchema, (notification) => {
+            const uri = notification.params.uri;
+            const subscribers = this.resourceSubscribers.get(uri);
+            if (!subscribers)
+                return;
+            for (const handler of subscribers) {
+                try {
+                    handler({ uri });
+                }
+                catch {
+                    // Swallow per-subscriber errors.
+                }
+            }
+        });
+        // Register server-initiated request handlers. Each is only wired when the
+        // caller supplied the corresponding handler/provider — that way the
+        // declared capability set matches what we can actually service.
+        if (options.samplingHandler) {
+            const handler = options.samplingHandler;
+            this.sdk.setRequestHandler(CreateMessageRequestSchema, (request) => handler(request.params));
+        }
+        if (options.elicitationHandler) {
+            const handler = options.elicitationHandler;
+            this.sdk.setRequestHandler(ElicitRequestSchema, (request) => handler(request.params));
+        }
+        if (options.rootsProvider) {
+            const provider = options.rootsProvider;
+            this.sdk.setRequestHandler(ListRootsRequestSchema, async () => ({
+                roots: await provider(),
+            }));
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Lifecycle
+    // -------------------------------------------------------------------------
+    /**
+     * Connect the underlying transport and run MCP `initialize`. Idempotent:
+     * calling twice is a no-op on the second call.
+     */
+    async connect() {
+        if (this.connected)
+            return;
+        const transport = this.createTransport();
+        await this.sdk.connect(transport);
+        this.connected = true;
+    }
+    /**
+     * Close the underlying transport and invalidate the client. Idempotent.
+     */
+    async close() {
+        if (!this.connected)
+            return;
+        await this.sdk.close();
+        this.connected = false;
+        this.httpTransport = undefined;
+        this.resourceSubscribers.clear();
+    }
+    /**
+     * Finalize an OAuth 2.1 authorization flow initiated by an `authProvider`.
+     *
+     * After `connect()` triggers `OAuthClientProvider.redirectToAuthorization`,
+     * the user completes consent at the authorization server and is redirected
+     * back to the caller's callback URL with a `code` query parameter. The
+     * caller passes that `code` here, which delegates to the Streamable HTTP
+     * transport's `finishAuth`: the SDK exchanges the code (with the stored
+     * PKCE verifier) at the token endpoint and persists the resulting token
+     * set via the provider's `saveTokens`. Retry `connect()` afterward.
+     *
+     * Throws if the client is not using the `streamable-http` transport or if
+     * `connect()` has not been called yet (the transport is constructed during
+     * `connect`).
+     */
+    async finishAuth(authorizationCode) {
+        if (this.options.transport.kind !== 'streamable-http') {
+            throw new Error(`McpClient.finishAuth() requires the 'streamable-http' transport ` +
+                `(got '${this.options.transport.kind}')`);
+        }
+        if (!this.httpTransport) {
+            throw new McpNotConnectedError('finishAuth');
+        }
+        await this.httpTransport.finishAuth(authorizationCode);
+    }
+    /** Server capabilities returned by `initialize`. Undefined before connect. */
+    getServerCapabilities() {
+        return this.sdk.getServerCapabilities();
+    }
+    // -------------------------------------------------------------------------
+    // Resources
+    // -------------------------------------------------------------------------
+    async listResources(options) {
+        this.assertConnected('listResources');
+        this.requireCapability('resources');
+        const result = await this.sdk.listResources(undefined, toSdkRequestOptions(options));
+        return result.resources;
+    }
+    async readResource(uri, options) {
+        this.assertConnected('readResource');
+        this.requireCapability('resources');
+        const result = await this.sdk.readResource({ uri }, toSdkRequestOptions(options));
+        return result.contents;
+    }
+    /**
+     * Subscribe to updates for a single resource URI. The returned function
+     * removes this subscription (and unsubscribes on the wire once no
+     * subscribers remain for the URI).
+     *
+     * Requires the server to advertise `resources.subscribe`; throws
+     * `McpCapabilityError` otherwise.
+     */
+    async subscribeResource(uri, handler, options) {
+        this.assertConnected('subscribeResource');
+        const caps = this.getServerCapabilities();
+        if (!caps?.resources)
+            throw new McpCapabilityError('resources');
+        if (!caps.resources.subscribe)
+            throw new McpCapabilityError('resources.subscribe');
+        let subscribers = this.resourceSubscribers.get(uri);
+        if (!subscribers) {
+            subscribers = new Set();
+            this.resourceSubscribers.set(uri, subscribers);
+            await this.sdk.subscribeResource({ uri }, toSdkRequestOptions(options));
+        }
+        subscribers.add(handler);
+        let disposed = false;
+        return async () => {
+            if (disposed)
+                return;
+            disposed = true;
+            const current = this.resourceSubscribers.get(uri);
+            if (!current)
+                return;
+            current.delete(handler);
+            if (current.size === 0) {
+                this.resourceSubscribers.delete(uri);
+                if (this.connected) {
+                    await this.sdk.unsubscribeResource({ uri });
+                }
+            }
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Prompts
+    // -------------------------------------------------------------------------
+    // -------------------------------------------------------------------------
+    // Tools
+    // -------------------------------------------------------------------------
+    /**
+     * Enumerate tools the server exposes. Requires the server to advertise the
+     * `tools` capability.
+     *
+     * Returns the SDK's `Tool` shape unchanged — name, description, input JSON
+     * Schema (as `inputSchema`), and any spec-defined annotations.
+     */
+    async listTools(options) {
+        this.assertConnected('listTools');
+        this.requireCapability('tools');
+        const result = await this.sdk.listTools(undefined, toSdkRequestOptions(options));
+        return result.tools;
+    }
+    /**
+     * Invoke a tool by name with the supplied structured arguments. Requires
+     * the server to advertise `tools`. Returns the full SDK `CallToolResult`
+     * (structured content + isError flag + optional `_meta`).
+     *
+     * Tool failures surface as `{ isError: true, content: [...] }` rather than
+     * thrown exceptions — the server is explicitly asked to communicate tool
+     * errors in-band per the MCP spec. Transport-level failures still throw.
+     */
+    async callTool(name, args, options) {
+        this.assertConnected('callTool');
+        this.requireCapability('tools');
+        const params = { name };
+        if (args !== undefined)
+            params.arguments = args;
+        const result = await this.sdk.callTool(params, undefined, toSdkRequestOptions(options));
+        return result;
+    }
+    // -------------------------------------------------------------------------
+    // Prompts
+    // -------------------------------------------------------------------------
+    async listPrompts(options) {
+        this.assertConnected('listPrompts');
+        this.requireCapability('prompts');
+        const result = await this.sdk.listPrompts(undefined, toSdkRequestOptions(options));
+        return result.prompts;
+    }
+    async getPrompt(name, args, options) {
+        this.assertConnected('getPrompt');
+        this.requireCapability('prompts');
+        const params = args === undefined ? { name } : { name, arguments: args };
+        const result = await this.sdk.getPrompt(params, toSdkRequestOptions(options));
+        return {
+            description: result.description,
+            messages: result.messages,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // List-changed subscriptions
+    // -------------------------------------------------------------------------
+    onResourcesListChanged(handler) {
+        return this.addListChanged('resources', handler);
+    }
+    onPromptsListChanged(handler) {
+        return this.addListChanged('prompts', handler);
+    }
+    onToolsListChanged(handler) {
+        return this.addListChanged('tools', handler);
+    }
+    // -------------------------------------------------------------------------
+    // Roots
+    // -------------------------------------------------------------------------
+    /**
+     * Notify the server that the client's roots have changed. The server will
+     * typically re-fetch via `roots/list`, which routes to the `rootsProvider`
+     * passed at construction. No-op if the client wasn't constructed with a
+     * `rootsProvider` — advertising list-changed without a provider is
+     * nonsensical, so we fail fast.
+     */
+    async notifyRootsListChanged() {
+        this.assertConnected('notifyRootsListChanged');
+        if (!this.options.rootsProvider) {
+            throw new Error('McpClient.notifyRootsListChanged() requires a rootsProvider at construction');
+        }
+        await this.sdk.sendRootsListChanged();
+    }
+    // -------------------------------------------------------------------------
+    // Completions
+    // -------------------------------------------------------------------------
+    /**
+     * Request argument completions from the server. The reference points at a
+     * prompt or resource-template; the server returns suggestion values for
+     * the named argument given the current partial value.
+     */
+    async complete(reference, argument, options) {
+        this.assertConnected('complete');
+        this.requireCapability('completions');
+        const params = { ref: reference, argument };
+        const result = await this.sdk.complete(params, toSdkRequestOptions(options));
+        return result.completion;
+    }
+    // -------------------------------------------------------------------------
+    // Logging (PR-0.3)
+    // -------------------------------------------------------------------------
+    /**
+     * Set the minimum log level the server should emit. Requires the server to
+     * advertise the `logging` capability.
+     */
+    async setLoggingLevel(level, options) {
+        this.assertConnected('setLoggingLevel');
+        this.requireCapability('logging');
+        await this.sdk.setLoggingLevel(level, toSdkRequestOptions(options));
+    }
+    /**
+     * Subscribe to server-emitted log messages. Returns an unregister function.
+     *
+     * Implemented on top of the generic `on()` fan-out, so multiple subscribers
+     * coexist cleanly (admin UI, CLI logger, telemetry exporter, …).
+     */
+    onLog(handler) {
+        return this.on(LoggingMessageNotificationSchema, (notification) => {
+            handler(notification.params);
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Generic notification subscription (PR-0.3)
+    // -------------------------------------------------------------------------
+    /**
+     * Subscribe to arbitrary server notifications by zod schema. First
+     * subscription per schema installs a single SDK handler that fans out to
+     * every registered subscriber; later subscriptions join the existing fan.
+     * Returns an unregister function.
+     *
+     * Typically callers use the purpose-built subscribers (`onLog`,
+     * `onResourcesListChanged`, `subscribeResource`) rather than this. Use
+     * `on()` for schemas the client doesn't yet expose a named subscriber for.
+     */
+    on(schema, handler) {
+        let subscribers = this.notificationSubscribers.get(schema);
+        if (!subscribers) {
+            subscribers = new Set();
+            this.notificationSubscribers.set(schema, subscribers);
+            const fanOut = (notification) => {
+                for (const h of subscribers ?? []) {
+                    try {
+                        h(notification);
+                    }
+                    catch {
+                        // Swallow per-subscriber errors.
+                    }
+                }
+            };
+            this.sdk.setNotificationHandler(schema, fanOut);
+        }
+        subscribers.add(handler);
+        return () => {
+            subscribers?.delete(handler);
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Health
+    // -------------------------------------------------------------------------
+    async ping(options) {
+        this.assertConnected('ping');
+        await this.sdk.ping(toSdkRequestOptions(options));
+    }
+    // -------------------------------------------------------------------------
+    // Internals
+    // -------------------------------------------------------------------------
+    createTransport() {
+        const t = this.options.transport;
+        switch (t.kind) {
+            case 'stdio':
+                return new StdioClientTransport({
+                    command: t.command,
+                    args: t.args,
+                    env: t.env,
+                    cwd: t.cwd,
+                });
+            case 'custom':
+                return t.transport;
+            case 'streamable-http': {
+                const url = t.url instanceof URL ? t.url : new URL(t.url);
+                const sdkOptions = {};
+                if (t.requestInit)
+                    sdkOptions.requestInit = t.requestInit;
+                if (t.fetch)
+                    sdkOptions.fetch = t.fetch;
+                if (t.sessionId)
+                    sdkOptions.sessionId = t.sessionId;
+                if (t.reconnectionOptions)
+                    sdkOptions.reconnectionOptions = t.reconnectionOptions;
+                if (t.authProvider)
+                    sdkOptions.authProvider = t.authProvider;
+                const transport = new StreamableHTTPClientTransport(url, sdkOptions);
+                this.httpTransport = transport;
+                return transport;
+            }
+        }
+    }
+    assertConnected(method) {
+        if (!this.connected)
+            throw new McpNotConnectedError(method);
+    }
+    requireCapability(capability) {
+        const caps = this.getServerCapabilities();
+        if (!caps?.[capability])
+            throw new McpCapabilityError(capability);
+    }
+    addListChanged(channel, handler) {
+        this.listChangedHandlers[channel].add(handler);
+        return () => {
+            this.listChangedHandlers[channel].delete(handler);
+        };
+    }
+    fireListChanged(channel) {
+        for (const handler of this.listChangedHandlers[channel]) {
+            try {
+                handler();
+            }
+            catch {
+                // Swallow per-subscriber errors.
+            }
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/hypervisor.d.ts

@@ -13,6 +13,7 @@
  *
  * Wire format: newline-delimited JSON-RPC 2.0 (stdin/stdout)
  */
+import type { McpMeterSink } from './metering.js';
 export interface MCPServerConfig {
     /** Unique name for this server (used in tool namespacing) */
     name: string;
@@ -89,6 +90,7 @@ export declare class MCPHypervisor {
     /** Tenant-scoped server instances: key = `${tenantId}:${serverName}` */
     private tenantServers;
     private credentialResolver;
+    private meterSink;
     private requestCounter;
     private pendingRequests;
     private healthCheckTimer;
@@ -156,6 +158,22 @@ export declare class MCPHypervisor {
      * Must be set before calling any tenant-scoped methods.
      */
     setCredentialResolver(resolver: MCPCredentialResolver): void;
+    /**
+     * Install a consumer-wired metering sink. Fires exactly once per
+     * tool-call boundary (success or failure) with an `McpMeterEvent`.
+     * Sinks may be sync or async — invocation is fire-and-forget; sink
+     * errors are logged at warn and never propagate into the call path.
+     *
+     * See `./metering.ts` for the event shape. Pass `null` to disable.
+     */
+    setUsageMeterSink(sink: McpMeterSink | null): void;
+    /**
+     * Fire the consumer-wired metering sink. Swallows errors so
+     * observability can never corrupt a successful tool call.
+     *
+     * @internal
+     */
+    private emitMeter;
     /**
      * Start an MCP server with tenant-specific credentials.
      * Each tenant gets its own isolated server process with credentials

package/dist/hypervisor.d.ts.map

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