@onlyne/mcp-core 3.1.0 → 3.2.0

package/dist/index.d.ts

@@ -0,0 +1,173 @@
+import type { Json, NodeId, ResourceDriver, ResourceRef } from '@onlyne/lib';
+import { type ListResourcesResult, type ReadResourceResult, type ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';
+/** Shared settings of one configured MCP server. */
+interface McpServerOptionsBase {
+    name: string;
+    /** Per-request timeout for tool calls and resource reads; the default matches the library's driver wait. */
+    timeoutMs?: number;
+    /**
+     * The local tool policy (RFC 0015 §4). Absent allows every tool the server lists; an empty
+     * list allows none. The policy is checked before any request leaves this node.
+     */
+    allowedTools?: string[];
+}
+/** An HTTP streamable MCP server; `url` is the endpoint and `headers` carry its API key. */
+export interface McpHttpServerOptions extends McpServerOptionsBase {
+    transport?: 'http';
+    url: string;
+    /** Extra headers per request: Hindsight puts its API key here when enabled. */
+    headers?: Record<string, string>;
+}
+/**
+ * A locally spawned MCP server. `command` and `args` are handed to spawn as-is; nothing is
+ * joined into a shell string, so a value can never become shell syntax.
+ */
+export interface McpStdioServerOptions extends McpServerOptionsBase {
+    transport: 'stdio';
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+}
+/** One MCP server connection: exactly one of the HTTP and stdio transport contracts. */
+export type McpServerOptions = McpHttpServerOptions | McpStdioServerOptions;
+/** One entry of `tools/list`, kept as the bridge and the scheduler need it. */
+export interface McpToolInfo {
+    name: string;
+    description?: string;
+    annotations?: {
+        readOnlyHint?: boolean;
+    };
+}
+/** One entry of `resources/list`, typed by the official SDK. */
+export type McpResourceInfo = ListResourcesResult['resources'][number];
+/** One page of `resources/list`; `nextCursor` is the server's own opaque cursor. */
+export type McpResourcePage = Pick<ListResourcesResult, 'resources' | 'nextCursor'>;
+/** The result of one `resources/read`: data only, never a message or a thread entry. */
+export type McpResourceRead = ReadResourceResult;
+/** The result of one tool call, classified for the operation's three-way outcome (RFC 0015 §3). */
+export type McpOutcome = {
+    kind: 'result';
+    content?: Json;
+    structuredContent?: Json;
+} | {
+    kind: 'rejected';
+    text: string;
+} | {
+    kind: 'unknown';
+    text: string;
+};
+/**
+ * One MCP server connection on the official SDK: `Client` over either the streamable HTTP
+ * transport or a spawned stdio child. The SDK owns the session id, the handshake, SSE parsing,
+ * reconnect semantics and the stdio process lifecycle; this class is the façade the bridge and
+ * the gateway see. The local tool policy lives here, at the choke point every caller (resource
+ * operations, scheduled mounts, direct host calls) shares.
+ */
+export declare class McpConnection {
+    #private;
+    constructor(options: McpServerOptions);
+    get name(): string;
+    get transport(): 'http' | 'stdio';
+    /** The HTTP endpoint; empty for a stdio server, which has no URL. */
+    get url(): string;
+    get tools(): McpToolInfo[];
+    /** The last `resources/list` result; empty when the server declares no resources capability. */
+    get resources(): McpResourceInfo[];
+    /** What the server negotiated at `initialize`; undefined before the first successful connect. */
+    get capabilities(): ServerCapabilities | undefined;
+    get canListResources(): boolean;
+    get canSubscribe(): boolean;
+    /** The URIs this node currently holds a subscription for. */
+    get subscriptions(): ReadonlyArray<string>;
+    /** The local policy decision for one tool name. */
+    allows(tool: string): boolean;
+    /** Connects, reads the tool list and records the negotiated capabilities. */
+    start(): Promise<void>;
+    refreshTools(): Promise<McpToolInfo[]>;
+    /**
+     * The catalog entry for one operation. A name the current list already holds answers from the
+     * list; any other name refreshes `tools/list` once — connecting first when the session is down
+     * — so a catalog a previous run cached cannot turn a reachable tool into
+     * `unsupported_delivery`, and a name the live server does not list stays `unsupported_delivery`.
+     * The local policy runs before either, so a denied tool never reaches the network (RFC 0015 §4).
+     */
+    resolveTool(name: string): Promise<McpToolInfo>;
+    call(name: string, arguments_: Json): Promise<McpOutcome>;
+    /** One page of `resources/list`; the cursor is the server's own value. */
+    listResources(cursor?: string): Promise<McpResourcePage>;
+    /** The complete catalog, walking `nextCursor` pages. */
+    refreshResources(): Promise<McpResourceInfo[]>;
+    /** A read-only `resources/read`; the contents are data and never become a message. */
+    readResource(uri: string): Promise<McpResourceRead>;
+    /** Subscribes this node to one resource's change notifications (RFC 0015 §4: a local action). */
+    subscribe(uri: string): Promise<void>;
+    /** Withdraws a subscription; a URI this node never subscribed costs no request. */
+    unsubscribe(uri: string): Promise<void>;
+    /** Withdraws every live subscription, leaving the session open. */
+    unsubscribeAll(): Promise<void>;
+    /**
+     * Aligns subscriptions with a catalog: subscribes newly listed resources and withdraws the
+     * ones that disappeared. A server without `resources.subscribe` simply holds no subscriptions.
+     */
+    syncSubscriptions(resources?: ReadonlyArray<McpResourceInfo>): Promise<string[]>;
+    /** Observes `notifications/resources/updated`; returns the unsubscribe function. */
+    onResourceUpdated(listener: (uri: string) => void): () => void;
+    /** Observes `notifications/resources/list_changed` with the refreshed catalog. */
+    onResourceListChanged(listener: (resources: ReadonlyArray<McpResourceInfo>, error?: string) => void): () => void;
+    /** Reports a subscription that could not be restored after a reconnect (RFC 0015 §5). */
+    onSubscriptionLost(listener: (uri: string, reason: string) => void): () => void;
+    close(): Promise<void>;
+}
+/** The resource clause one MCP server contributes: its id, operations and diagnostic data. */
+export interface McpResourceDef {
+    resource_ref: ResourceRef;
+    operations: string[];
+    binding: {
+        handler: NodeId;
+        cursor: string;
+    };
+    log_readers: NodeId[];
+    data: Json;
+}
+/** Extra server facts a registration can carry; both are optional for a down server. */
+export interface McpResourceOptions {
+    /** The `resources/list` catalog; absent when the server is unreachable or declares none. */
+    resources?: ReadonlyArray<McpResourceInfo>;
+    /** The capabilities negotiated at `initialize`, when the session is up. */
+    capabilities?: ServerCapabilities;
+}
+/**
+ * Builds the Onlyne resource a server maps to (RFC 0015 §2: one server, one tool set). The
+ * `data` field is the human- and machine-readable description: concrete tool names and resource
+ * URIs, the transport, the negotiated `features` (capabilities) and the local tool policy.
+ */
+export declare function resourceOf(owner: string, server: McpServerOptions, tools: ReadonlyArray<McpToolInfo>, controllers: string[], options?: McpResourceOptions): McpResourceDef;
+/** Host callbacks for the resource primitives; all are observations, never business writes. */
+export interface McpBridgeOptions {
+    onResourceUpdated?(server: string, uri: string): void;
+    onResourceListChanged?(server: string, resources: ReadonlyArray<McpResourceInfo>, error?: string): void;
+    onSubscriptionLost?(server: string, uri: string, reason: string): void;
+}
+/**
+ * The bridge from resource operations to `tools/call`, plus the read-only MCP resource
+ * primitives. `validate` asks the connection for the operation's catalog entry: a name the live
+ * session does not list refreshes `tools/list` once, so a catalog a previous run cached stays
+ * callable while a name the server really dropped never reaches `tools/call` (RFC 0015 §2, §4).
+ */
+export interface McpBridge extends ResourceDriver {
+    listResources(server: string, cursor?: string): Promise<McpResourcePage>;
+    readResource(server: string, uri: string): Promise<Json>;
+    subscribe(server: string, uri: string): Promise<void>;
+    unsubscribe(server: string, uri: string): Promise<void>;
+    /** Subscribes every listed resource and withdraws vanished ones; returns the live set. */
+    syncSubscriptions(server: string): Promise<string[]>;
+    /** Withdraws every subscription this bridge made. */
+    close(): Promise<void>;
+}
+export declare function createMcpBridge(servers: Array<{
+    server: McpServerOptions;
+    connection: McpConnection;
+}>, options?: McpBridgeOptions): McpBridge;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,550 @@
+import { OnlyneError } from '@onlyne/lib';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { ErrorCode, McpError, ResourceListChangedNotificationSchema, ResourceUpdatedNotificationSchema, } from '@modelcontextprotocol/sdk/types.js';
+const DEFAULT_TIMEOUT_MS = 30_000;
+/** A resources/list loop that never ends is a broken server, not a large catalog. */
+const MAX_RESOURCE_PAGES = 1_000;
+const wire = (value) => JSON.parse(JSON.stringify(value));
+const messageOf = (error) => (error instanceof Error ? error.message : String(error));
+/**
+ * One MCP server connection on the official SDK: `Client` over either the streamable HTTP
+ * transport or a spawned stdio child. The SDK owns the session id, the handshake, SSE parsing,
+ * reconnect semantics and the stdio process lifecycle; this class is the façade the bridge and
+ * the gateway see. The local tool policy lives here, at the choke point every caller (resource
+ * operations, scheduled mounts, direct host calls) shares.
+ */
+export class McpConnection {
+    #client;
+    #connecting;
+    #closed = false;
+    #options;
+    #allowed;
+    #tools = [];
+    #resources = [];
+    #subscribed = new Set();
+    #resourceUpdatedListeners = new Set();
+    #resourceListChangedListeners = new Set();
+    #subscriptionLostListeners = new Set();
+    constructor(options) {
+        this.#options = options;
+        this.#allowed = options.allowedTools === undefined ? undefined : new Set(options.allowedTools);
+    }
+    get name() { return this.#options.name; }
+    get transport() {
+        return this.#options.transport === 'stdio' ? 'stdio' : 'http';
+    }
+    /** The HTTP endpoint; empty for a stdio server, which has no URL. */
+    get url() { return this.#options.transport === 'stdio' ? '' : this.#options.url; }
+    get tools() { return this.#tools; }
+    /** The last `resources/list` result; empty when the server declares no resources capability. */
+    get resources() { return this.#resources; }
+    /** What the server negotiated at `initialize`; undefined before the first successful connect. */
+    get capabilities() {
+        return this.#client?.getServerCapabilities();
+    }
+    get canListResources() { return this.capabilities?.resources !== undefined; }
+    get canSubscribe() { return this.capabilities?.resources?.subscribe === true; }
+    /** The URIs this node currently holds a subscription for. */
+    get subscriptions() { return [...this.#subscribed]; }
+    /** The local policy decision for one tool name. */
+    allows(tool) {
+        return this.#allowed === undefined || this.#allowed.has(tool);
+    }
+    /** Connects, reads the tool list and records the negotiated capabilities. */
+    async start() {
+        this.#tools = await this.refreshTools();
+    }
+    async refreshTools() {
+        const client = await this.#ensureConnected();
+        const result = await client.listTools(undefined, this.#requestOptions());
+        this.#tools = result.tools.map(tool => ({
+            name: tool.name,
+            ...(tool.description === undefined ? {} : { description: tool.description }),
+            ...(tool.annotations === undefined ? {} : { annotations: { readOnlyHint: tool.annotations.readOnlyHint } }),
+        }));
+        return this.#tools;
+    }
+    /**
+     * The catalog entry for one operation. A name the current list already holds answers from the
+     * list; any other name refreshes `tools/list` once — connecting first when the session is down
+     * — so a catalog a previous run cached cannot turn a reachable tool into
+     * `unsupported_delivery`, and a name the live server does not list stays `unsupported_delivery`.
+     * The local policy runs before either, so a denied tool never reaches the network (RFC 0015 §4).
+     */
+    async resolveTool(name) {
+        if (!this.allows(name)) {
+            throw new OnlyneError('forbidden', `The local policy does not allow the tool ${name} on ${this.name}.`);
+        }
+        if (this.#closed) {
+            throw new OnlyneError('unavailable', `The MCP connection ${this.name} is closed.`);
+        }
+        const known = this.#tools.find(tool => tool.name === name);
+        if (known !== undefined)
+            return known;
+        try {
+            await this.refreshTools();
+        }
+        catch (error) {
+            if (error instanceof OnlyneError)
+                throw error;
+            throw new OnlyneError('unavailable', `The MCP server ${this.name} could not list its tools.`, { source: messageOf(error) });
+        }
+        const tool = this.#tools.find(candidate => candidate.name === name);
+        if (tool === undefined) {
+            throw new OnlyneError('unsupported_delivery', `The tool ${name} is not in ${this.name}'s tools/list.`);
+        }
+        return tool;
+    }
+    async call(name, arguments_) {
+        // The policy is checked before `#ensureConnected`, so a denied tool never reaches the network
+        // (and a scheduled mount cannot bypass the policy by calling the connection directly).
+        if (!this.allows(name)) {
+            throw new OnlyneError('forbidden', `The local policy does not allow the tool ${name} on ${this.name}.`);
+        }
+        try {
+            const client = await this.#ensureConnected();
+            const result = await client.callTool({ name, arguments: arguments_ }, undefined, this.#requestOptions());
+            if (result.isError === true) {
+                return { kind: 'rejected', text: textOf(result.content) };
+            }
+            return {
+                kind: 'result',
+                ...(result.content === undefined ? {} : { content: result.content }),
+                ...(result.structuredContent === undefined ? {} : { structuredContent: result.structuredContent }),
+            };
+        }
+        catch (error) {
+            if (error instanceof OnlyneError)
+                throw error;
+            // A transport failure clears the client handle so the next call attempts a fresh handshake.
+            this.#client = undefined;
+            return { kind: 'unknown', text: messageOf(error) };
+        }
+    }
+    /** One page of `resources/list`; the cursor is the server's own value. */
+    async listResources(cursor) {
+        return this.#resourceRequest('list resources', async () => {
+            const client = await this.#ensureConnected();
+            this.#requireResourceCapability(client);
+            const result = await client.listResources(cursor === undefined ? undefined : { cursor }, this.#requestOptions());
+            return {
+                resources: result.resources,
+                ...(result.nextCursor === undefined ? {} : { nextCursor: result.nextCursor }),
+            };
+        });
+    }
+    /** The complete catalog, walking `nextCursor` pages. */
+    async refreshResources() {
+        const resources = [];
+        const seen = new Set();
+        let cursor;
+        for (let page = 0; page < MAX_RESOURCE_PAGES; page++) {
+            const result = await this.listResources(cursor);
+            resources.push(...result.resources);
+            cursor = result.nextCursor;
+            if (cursor === undefined) {
+                this.#resources = resources;
+                return this.#resources;
+            }
+            if (seen.has(cursor)) {
+                throw new OnlyneError('unavailable', `The MCP server ${this.name} repeated a resources page cursor.`);
+            }
+            seen.add(cursor);
+        }
+        throw new OnlyneError('unavailable', `The MCP server ${this.name} returned more than ${MAX_RESOURCE_PAGES} resource pages.`);
+    }
+    /** A read-only `resources/read`; the contents are data and never become a message. */
+    async readResource(uri) {
+        this.#requireUri(uri);
+        return this.#resourceRequest(`read ${uri}`, async () => {
+            const client = await this.#ensureConnected();
+            this.#requireResourceCapability(client);
+            return client.readResource({ uri }, this.#requestOptions());
+        });
+    }
+    /** Subscribes this node to one resource's change notifications (RFC 0015 §4: a local action). */
+    async subscribe(uri) {
+        this.#requireUri(uri);
+        await this.#resourceRequest(`subscribe to ${uri}`, async () => {
+            const client = await this.#ensureConnected();
+            this.#requireSubscribeCapability(client);
+            if (this.#subscribed.has(uri))
+                return;
+            await client.subscribeResource({ uri }, this.#requestOptions());
+            this.#subscribed.add(uri);
+        });
+    }
+    /** Withdraws a subscription; a URI this node never subscribed costs no request. */
+    async unsubscribe(uri) {
+        this.#requireUri(uri);
+        const client = this.#client;
+        this.#subscribed.delete(uri);
+        if (client === undefined)
+            return;
+        await this.#resourceRequest(`unsubscribe from ${uri}`, () => client.unsubscribeResource({ uri }, this.#requestOptions()));
+    }
+    /** Withdraws every live subscription, leaving the session open. */
+    async unsubscribeAll() {
+        await Promise.all([...this.#subscribed].map(uri => this.unsubscribe(uri).catch(() => undefined)));
+    }
+    /**
+     * Aligns subscriptions with a catalog: subscribes newly listed resources and withdraws the
+     * ones that disappeared. A server without `resources.subscribe` simply holds no subscriptions.
+     */
+    async syncSubscriptions(resources) {
+        const client = await this.#resourceRequest('list resources', () => this.#ensureConnected());
+        if (client.getServerCapabilities()?.resources?.subscribe !== true)
+            return [];
+        const catalog = resources ?? await this.refreshResources();
+        const desired = new Set(catalog.map(resource => resource.uri));
+        for (const uri of [...this.#subscribed]) {
+            if (!desired.has(uri))
+                await this.unsubscribe(uri);
+        }
+        for (const uri of desired) {
+            if (!this.#subscribed.has(uri))
+                await this.subscribe(uri);
+        }
+        return [...this.#subscribed];
+    }
+    /** Observes `notifications/resources/updated`; returns the unsubscribe function. */
+    onResourceUpdated(listener) {
+        this.#resourceUpdatedListeners.add(listener);
+        return () => { this.#resourceUpdatedListeners.delete(listener); };
+    }
+    /** Observes `notifications/resources/list_changed` with the refreshed catalog. */
+    onResourceListChanged(listener) {
+        this.#resourceListChangedListeners.add(listener);
+        return () => { this.#resourceListChangedListeners.delete(listener); };
+    }
+    /** Reports a subscription that could not be restored after a reconnect (RFC 0015 §5). */
+    onSubscriptionLost(listener) {
+        this.#subscriptionLostListeners.add(listener);
+        return () => { this.#subscriptionLostListeners.delete(listener); };
+    }
+    async close() {
+        // RFC 0015 §4: closing the bridge withdraws its subscriptions before the session goes.
+        const client = this.#client;
+        await this.unsubscribeAll();
+        this.#closed = true;
+        this.#client = undefined;
+        this.#subscribed.clear();
+        if (client) {
+            await client.close().catch(() => undefined);
+        }
+        this.#resourceUpdatedListeners.clear();
+        this.#resourceListChangedListeners.clear();
+        this.#subscriptionLostListeners.clear();
+    }
+    /** Reconnecting re-runs initialize, as RFC 0015 §5 requires; the SDK throws when offline. */
+    async #ensureConnected() {
+        if (this.#closed) {
+            throw new OnlyneError('unavailable', `The MCP connection ${this.name} is closed.`);
+        }
+        if (this.#client !== undefined)
+            return this.#client;
+        // Concurrent first calls share one handshake: a second attempt would spawn a second child.
+        this.#connecting ??= this.#open();
+        const attempt = this.#connecting;
+        try {
+            return await attempt;
+        }
+        finally {
+            if (this.#connecting === attempt)
+                this.#connecting = undefined;
+        }
+    }
+    async #open() {
+        const client = new Client({ name: 'onlyne-mcp', version: '3.0.0' }, { capabilities: {} });
+        await client.connect(this.#transport(), this.#requestOptions());
+        if (this.#closed) {
+            // `close()` ran during the handshake and had no client to close, so this one must not leak.
+            await client.close().catch(() => undefined);
+            throw new OnlyneError('unavailable', `The MCP connection ${this.name} is closed.`);
+        }
+        this.#client = client;
+        this.#installNotificationHandlers(client);
+        await this.#restoreSubscriptions(client);
+        return client;
+    }
+    #transport() {
+        const options = this.#options;
+        if (options.transport === 'stdio') {
+            // The SDK spawns `command` with `args` directly (`shell: false`); no string is interpolated.
+            return new StdioClientTransport({
+                command: options.command,
+                ...(options.args === undefined ? {} : { args: [...options.args] }),
+                ...(options.env === undefined ? {} : { env: { ...options.env } }),
+                ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
+            });
+        }
+        return new StreamableHTTPClientTransport(new URL(options.url), {
+            requestInit: { headers: options.headers },
+        });
+    }
+    #installNotificationHandlers(client) {
+        client.setNotificationHandler(ResourceUpdatedNotificationSchema, notification => {
+            // The notification only reports the URI; the body is a later `resources/read` (RFC 0015 §2).
+            for (const listener of [...this.#resourceUpdatedListeners])
+                listener(notification.params.uri);
+        });
+        client.setNotificationHandler(ResourceListChangedNotificationSchema, () => {
+            void this.refreshResources().then(resources => {
+                for (const listener of [...this.#resourceListChangedListeners])
+                    listener(resources);
+            }, error => {
+                for (const listener of [...this.#resourceListChangedListeners])
+                    listener(this.#resources, messageOf(error));
+            });
+        });
+    }
+    /** RFC 0015 §5: a reconnect must re-subscribe; a failed restore is reported, not faked. */
+    async #restoreSubscriptions(client) {
+        const pending = [...this.#subscribed];
+        if (pending.length === 0)
+            return;
+        if (client.getServerCapabilities()?.resources?.subscribe !== true) {
+            for (const uri of pending) {
+                this.#subscribed.delete(uri);
+                this.#emitSubscriptionLost(uri, 'The server no longer declares the resources.subscribe capability.');
+            }
+            return;
+        }
+        for (const uri of pending) {
+            try {
+                await client.subscribeResource({ uri }, this.#requestOptions());
+            }
+            catch (error) {
+                this.#subscribed.delete(uri);
+                this.#emitSubscriptionLost(uri, messageOf(error));
+            }
+        }
+    }
+    #emitSubscriptionLost(uri, reason) {
+        for (const listener of [...this.#subscriptionLostListeners])
+            listener(uri, reason);
+    }
+    #requestOptions() {
+        return { resetTimeoutOnProgress: false, timeout: this.#options.timeoutMs ?? DEFAULT_TIMEOUT_MS };
+    }
+    #requireUri(uri) {
+        if (typeof uri !== 'string' || uri.length === 0) {
+            throw new OnlyneError('invalid_request', 'A resource URI is a non-empty string.');
+        }
+    }
+    #requireResourceCapability(client) {
+        if (client.getServerCapabilities()?.resources === undefined) {
+            throw new OnlyneError('unsupported_delivery', `The MCP server ${this.name} declares no resources capability.`);
+        }
+    }
+    #requireSubscribeCapability(client) {
+        if (client.getServerCapabilities()?.resources?.subscribe !== true) {
+            throw new OnlyneError('unsupported_delivery', `The MCP server ${this.name} does not declare resources.subscribe.`);
+        }
+    }
+    /** Maps SDK and transport failures for the resource primitives, never a bare string. */
+    async #resourceRequest(action, run) {
+        try {
+            return await run();
+        }
+        catch (error) {
+            if (error instanceof OnlyneError)
+                throw error;
+            if (error instanceof McpError) {
+                if (error.code === ErrorCode.MethodNotFound) {
+                    throw new OnlyneError('unsupported_delivery', `The MCP server ${this.name} does not support ${action}.`, { source: error.message });
+                }
+                if (error.code === ErrorCode.InvalidParams || error.code === ErrorCode.InvalidRequest) {
+                    throw new OnlyneError('invalid_request', `The MCP server ${this.name} rejected ${action}.`, { source: error.message });
+                }
+                if (error.code === ErrorCode.ConnectionClosed)
+                    this.#client = undefined;
+                throw new OnlyneError('unavailable', `The MCP server ${this.name} could not ${action}.`, { source: error.message, code: error.code });
+            }
+            this.#client = undefined;
+            throw new OnlyneError('unavailable', `The MCP transport failed while trying to ${action}.`, { source: messageOf(error) });
+        }
+    }
+}
+/** One line of a diagnostic description, bounded so a chatty server cannot bloat the data. */
+function summaryOf(text, limit = 160) {
+    if (text === undefined)
+        return '';
+    const line = text.replace(/\s+/g, ' ').trim();
+    return line.length <= limit ? line : `${line.slice(0, limit - 1)}…`;
+}
+/**
+ * Builds the Onlyne resource a server maps to (RFC 0015 §2: one server, one tool set). The
+ * `data` field is the human- and machine-readable description: concrete tool names and resource
+ * URIs, the transport, the negotiated `features` (capabilities) and the local tool policy.
+ */
+export function resourceOf(owner, server, tools, controllers, options = {}) {
+    const resources = options.resources ?? [];
+    const capabilities = options.capabilities;
+    const location = server.transport === 'stdio'
+        ? {
+            transport: 'stdio',
+            command: server.command,
+            ...(server.args === undefined || server.args.length === 0 ? {} : { args: server.args }),
+            ...(server.cwd === undefined ? {} : { cwd: server.cwd }),
+        }
+        : { transport: 'http', url: server.url };
+    const transport = location.transport;
+    const toolLine = tools.length === 0
+        ? 'no tools'
+        : `tools ${tools.map(tool => {
+            const summary = summaryOf(tool.description);
+            return summary.length === 0 ? tool.name : `${tool.name} (${summary})`;
+        }).join(', ')}`;
+    const resourceLine = resources.length === 0
+        ? 'no resources'
+        : `resources ${resources.map(resource => {
+            const summary = summaryOf(resource.description);
+            return summary.length === 0 ? resource.uri : `${resource.uri} (${summary})`;
+        }).join(', ')}`;
+    return {
+        resource_ref: { owner, id: server.name },
+        operations: tools.map(tool => tool.name),
+        binding: { handler: owner, cursor: '0' },
+        log_readers: controllers.length > 0 ? controllers : [owner],
+        data: wire({
+            kind: 'mcp_server',
+            ...location,
+            ...(server.allowedTools === undefined ? {} : { allowed_tools: server.allowedTools }),
+            tools: tools.map(tool => ({
+                name: tool.name,
+                ...(typeof tool.description === 'string' ? { description: summaryOf(tool.description, 200) } : {}),
+                ...(tool.annotations?.readOnlyHint === true ? { read_only: true } : {}),
+            })),
+            resources: resources.map(resource => ({
+                uri: resource.uri,
+                name: resource.name,
+                ...(typeof resource.description === 'string' ? { description: summaryOf(resource.description, 200) } : {}),
+                ...(typeof resource.mimeType === 'string' ? { mime_type: resource.mimeType } : {}),
+            })),
+            description: `MCP server ${server.name} over ${transport}: ${toolLine}; ${resourceLine}.`,
+            ...(capabilities === undefined ? {} : {
+                features: {
+                    tools: capabilities.tools !== undefined,
+                    resources: capabilities.resources !== undefined,
+                    resource_subscribe: capabilities.resources?.subscribe === true,
+                    resource_list_changed: capabilities.resources?.listChanged === true,
+                },
+            }),
+            ...(controllers.length > 0 ? {} : { note: 'owner only' }),
+        }),
+    };
+}
+export function createMcpBridge(servers, options = {}) {
+    const byServer = new Map(servers.map(entry => [entry.server.name, entry]));
+    const disposers = [];
+    let closed = false;
+    for (const entry of servers) {
+        const name = entry.server.name;
+        disposers.push(entry.connection.onResourceUpdated(uri => {
+            // A change notification is data: it never becomes an agent message or a thread entry.
+            options.onResourceUpdated?.(name, uri);
+        }));
+        disposers.push(entry.connection.onResourceListChanged((resources, error) => {
+            void entry.connection.syncSubscriptions(resources).then(() => { options.onResourceListChanged?.(name, resources, error); }, syncError => {
+                options.onResourceListChanged?.(name, resources, error ?? messageOf(syncError));
+            });
+        }));
+        disposers.push(entry.connection.onSubscriptionLost((uri, reason) => {
+            options.onSubscriptionLost?.(name, uri, reason);
+        }));
+    }
+    function requireServer(name) {
+        if (closed)
+            throw new OnlyneError('unavailable', 'The MCP bridge is closed.');
+        const entry = byServer.get(name);
+        if (entry === undefined) {
+            throw new OnlyneError('invalid_request', `No MCP server serves the resource ${name}.`);
+        }
+        return entry;
+    }
+    async function requireTool(ref, operation) {
+        const entry = requireServer(ref.id);
+        // `resolveTool` checks the policy before any request (a denied tool is `forbidden`, not
+        // `unsupported`) and refreshes the catalog once when the name is not in the pinned list.
+        const tool = await entry.connection.resolveTool(operation);
+        return { entry, tool };
+    }
+    return {
+        async validate(resource, operation, data) {
+            await requireTool(resource.resource_ref, operation);
+            // `arguments` for `tools/call` is an object when present (RFC 0015 §2).
+            if (data !== undefined && (data === null || typeof data !== 'object' || Array.isArray(data))) {
+                throw new OnlyneError('invalid_request', `The arguments for ${operation} are an object.`);
+            }
+        },
+        async execute(resource, request) {
+            const { entry, tool } = await requireTool(resource.resource_ref, request.operation);
+            const arguments_ = (request.data ?? {});
+            const outcome = await entry.connection.call(request.operation, arguments_);
+            if (outcome.kind === 'unknown') {
+                // The transport never gave an answer: the call may or may not have run (RFC 0015 §3).
+                return { state: 'unknown', error: { code: 'unavailable', message: 'The MCP server gave no answer.', retryable: true, details: { source: outcome.text } } };
+            }
+            if (outcome.kind === 'rejected') {
+                // A read-only tool cannot have side effects, so its failure is a settled abort; a
+                // side-effecting tool's failure proves nothing about what it already did.
+                if (tool.annotations?.readOnlyHint === true) {
+                    return { state: 'aborted', error: { code: 'unavailable', message: 'The tool reported failure.', retryable: false, details: { source: outcome.text } } };
+                }
+                return { state: 'unknown', error: { code: 'unavailable', message: 'The tool reported failure; the side effect is unconfirmed.', retryable: true, details: { source: outcome.text } } };
+            }
+            return {
+                state: 'committed',
+                data: wire({
+                    ...(outcome.content === undefined ? {} : { content: outcome.content }),
+                    ...(outcome.structuredContent === undefined ? {} : { structuredContent: outcome.structuredContent }),
+                }),
+            };
+        },
+        async listResources(server, cursor) {
+            return requireServer(server).connection.listResources(cursor);
+        },
+        async readResource(server, uri) {
+            // Data only: no message admission, no thread entry, no business-state write.
+            return wire(await requireServer(server).connection.readResource(uri));
+        },
+        async subscribe(server, uri) {
+            await requireServer(server).connection.subscribe(uri);
+        },
+        async unsubscribe(server, uri) {
+            await requireServer(server).connection.unsubscribe(uri);
+        },
+        async syncSubscriptions(server) {
+            return requireServer(server).connection.syncSubscriptions();
+        },
+        async close() {
+            if (closed)
+                return;
+            closed = true;
+            await Promise.all(servers.map(entry => entry.connection.unsubscribeAll()));
+            for (const dispose of disposers)
+                dispose();
+            disposers.length = 0;
+        },
+    };
+}
+/** An error result's content is text blocks; their `text` fields are the readable message. */
+function textOf(content) {
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map(block => {
+            if (typeof block !== 'object' || block === null || !('text' in block))
+                return '';
+            return typeof block.text === 'string' ? block.text : '';
+        })
+            .filter(text => text.length > 0)
+            .join('\n');
+    }
+    return JSON.stringify(content ?? '');
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@onlyne/mcp-core",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "MCP client session and resource driver that maps tools/list and tools/call onto Onlyne resource operations",
   "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -17,16 +17,21 @@
   "publishConfig": { "access": "public" },
   "engines": { "bun": ">=1.4.3" },
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
   },
-  "files": ["src", "README.md", "LICENSE"],
+  "files": ["dist", "README.md", "LICENSE"],
   "scripts": {
-    "check": "tsc --noEmit",
-    "test": "bun tests/verify.ts"
+    "build": "tsc",
+    "check": "tsc && tsc -p tsconfig.tests.json",
+    "test": "bun tests/verify.ts",
+    "prepack": "bun run build"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.32.2",
-    "@onlyne/lib": "^3.1.0"
+    "@onlyne/lib": "^3.2.0"
   },
   "devDependencies": {
     "@types/bun": "^1.3.0",

package/src/index.ts

@@ -1,198 +0,0 @@
-import type { Json, NodeId, Resource, ResourceDriver, ResourceRef } from '@onlyne/lib';
-import { OnlyneError } from '@onlyne/lib';
-import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamablehttp.js';
-
-export interface McpServerOptions {
-  name: string;
-  url: string;
-  /** Extra headers per request: Hindsight puts its API key here when enabled. */
-  headers?: Record<string, string>;
-  /** Per-request timeout for tool calls; the default matches the library's driver wait. */
-  timeoutMs?: number;
-}
-
-/** The result of one tool call, classified for the operation's three-way outcome (RFC 0015 §3). */
-export type McpOutcome =
-  | { kind: 'result'; content?: Json; structuredContent?: Json }
-  | { kind: 'rejected'; text: string }
-  | { kind: 'unknown'; text: string };
-
-const DEFAULT_TIMEOUT_MS = 30_000;
-const wire = (value: object): Json => JSON.parse(JSON.stringify(value)) as Json;
-
-/**
- * One MCP server connection on the official SDK: `Client` over the streamable HTTP transport.
- * The SDK owns the session id, the handshake, SSE parsing and the reconnect semantics; this
- * class is only the façade the bridge and the gateway see.
- */
-export class McpConnection {
-  #client: Client | undefined;
-  readonly #options: McpServerOptions;
-  #tools: Array<{ name: string; description?: string; annotations?: { readOnlyHint?: boolean } }> = [];
-
-  constructor(options: McpServerOptions) {
-    this.#options = options;
-  }
-
-  get url(): string { return this.#options.url; }
-
-  get tools(): Array<{ name: string; description?: string; annotations?: { readOnlyHint?: boolean } }> { return this.#tools; }
-
-  /** Connects and reads the tool list; the SDK handles initialize and the session handshake. */
-  async start(): Promise<void> {
-    this.#tools = await this.refreshTools();
-  }
-
-  async refreshTools(): Promise<Array<{ name: string; description?: string; annotations?: { readOnlyHint?: boolean } }>> {
-    const client = await this.#ensureConnected();
-    const result = await client.listTools();
-    this.#tools = result.tools.map(tool => ({
-      name: tool.name,
-      ...(tool.description === undefined ? {} : { description: tool.description }),
-      ...(tool.annotations === undefined ? {} : { annotations: { readOnlyHint: tool.annotations.readOnlyHint } }),
-    }));
-    return this.#tools;
-  }
-
-  async call(name: string, arguments_: Json): Promise<McpOutcome> {
-    try {
-      const client = await this.#ensureConnected();
-      const result = await client.callTool({ name, arguments: arguments_ as Record<string, unknown> },
-        undefined, { resetTimeoutOnProgress: false, timeout: this.#options.timeoutMs ?? DEFAULT_TIMEOUT_MS });
-      if (result.isError === true) {
-        return { kind: 'rejected', text: textOf(result.content) };
-      }
-      return {
-        kind: 'result',
-        ...(result.content === undefined ? {} : { content: result.content as Json }),
-        ...(result.structuredContent === undefined ? {} : { structuredContent: result.structuredContent as Json }),
-      };
-    } catch (error) {
-      // A transport failure clears the client handle so the next call attempts a fresh handshake.
-      this.#client = undefined;
-      return { kind: 'unknown', text: error instanceof Error ? error.message : String(error) };
-    }
-  }
-
-  async close(): Promise<void> {
-    const client = this.#client;
-    this.#client = undefined;
-    if (client) await client.close().catch(() => undefined);
-  }
-
-  /** Reconnecting re-runs initialize, as RFC 0015 §5 requires; the SDK throws when offline. */
-  async #ensureConnected(): Promise<Client> {
-    if (this.#client !== undefined) return this.#client;
-    const transport = new StreamableHTTPClientTransport(new URL(this.#options.url), {
-      requestInit: { headers: this.#options.headers },
-    });
-    const client = new Client({ name: 'onlyne-mcp', version: '3.0.0' }, { capabilities: {} });
-    await client.connect(transport);
-    this.#client = client;
-    return client;
-  }
-}
-
-/** The resource clause one MCP server contributes: its id, operations and diagnostic data. */
-export interface McpResourceDef {
-  resource_ref: ResourceRef;
-  operations: string[];
-  binding: { handler: NodeId; cursor: string };
-  log_readers: NodeId[];
-  data: Json;
-}
-
-/** Builds the Onlyne resource a server maps to (RFC 0015 §2: one server, one tool set). */
-export function resourceOf(
-  owner: string,
-  server: McpServerOptions,
-  tools: ReadonlyArray<{ name: string; description?: string }>,
-  controllers: string[],
-): McpResourceDef {
-  return {
-    resource_ref: { owner, id: server.name },
-    operations: tools.map(tool => tool.name),
-    binding: { handler: owner, cursor: '0' },
-    log_readers: controllers.length > 0 ? controllers : [owner],
-    data: wire({
-      kind: 'mcp_server',
-      url: server.url,
-      tools: tools.map(tool => ({
-        name: tool.name,
-        ...(typeof tool.description === 'string' ? { description: tool.description.slice(0, 200) } : {}),
-      })),
-      ...(controllers.length > 0 ? {} : { note: 'owner only' }),
-    }),
-  };
-}
-
-/**
- * The bridge from resource operations to `tools/call`. The tool list is pinned per server, so
- * `validate` answers from the cache and a request for an unknown tool never leaves the node
- * (RFC 0015 §2: `unsupported_delivery`, not sent).
- */
-export function createMcpBridge(servers: Array<{ server: McpServerOptions; connection: McpConnection }>): ResourceDriver {
-  const byServer = new Map(servers.map(entry => [entry.server.name, entry]));
-
-  function requireTool(ref: ResourceRef, operation: string): { entry: { server: McpServerOptions; connection: McpConnection }; tool: { name: string; annotations?: { readOnlyHint?: boolean } } } {
-    const entry = byServer.get(ref.id);
-    if (entry === undefined) {
-      throw new OnlyneError('invalid_request', `No MCP server serves the resource ${ref.id}.`);
-    }
-    const tool = entry.connection.tools.find(candidate => candidate.name === operation);
-    if (tool === undefined) {
-      throw new OnlyneError('unsupported_delivery', `The tool ${operation} is not in ${ref.id}'s tools/list.`);
-    }
-    return { entry, tool };
-  }
-
-  return {
-    async validate(resource: Resource, operation: string, data: Json | undefined): Promise<void> {
-      requireTool(resource.resource_ref, operation);
-      // `arguments` for `tools/call` is an object when present (RFC 0015 §2).
-      if (data !== undefined && (data === null || typeof data !== 'object' || Array.isArray(data))) {
-        throw new OnlyneError('invalid_request', `The arguments for ${operation} are an object.`);
-      }
-    },
-
-    async execute(resource: Resource, request): Promise<Omit<import('@onlyne/lib').OperationResult, 'operation_id'>> {
-      const { entry, tool } = requireTool(resource.resource_ref, request.operation);
-      const arguments_ = (request.data ?? {}) as Json;
-      const outcome = await entry.connection.call(request.operation, arguments_);
-      if (outcome.kind === 'unknown') {
-        // The transport never gave an answer: the call may or may not have run (RFC 0015 §3).
-        return { state: 'unknown', error: { code: 'unavailable', message: 'The MCP server gave no answer.', retryable: true, details: { source: outcome.text } } };
-      }
-      if (outcome.kind === 'rejected') {
-        // A read-only tool cannot have side effects, so its failure is a settled abort; a
-        // side-effecting tool's failure proves nothing about what it already did.
-        if (tool.annotations?.readOnlyHint === true) {
-          return { state: 'aborted', error: { code: 'unavailable', message: 'The tool reported failure.', retryable: false, details: { source: outcome.text } } };
-        }
-        return { state: 'unknown', error: { code: 'unavailable', message: 'The tool reported failure; the side effect is unconfirmed.', retryable: true, details: { source: outcome.text } } };
-      }
-      return {
-        state: 'committed',
-        data: wire({
-          ...(outcome.content === undefined ? {} : { content: outcome.content }),
-          ...(outcome.structuredContent === undefined ? {} : { structuredContent: outcome.structuredContent }),
-        }),
-      };
-    },
-  };
-}
-
-/** An error result's content is text blocks; their `text` fields are the readable message. */
-function textOf(content: unknown): string {
-  if (typeof content === 'string') return content;
-  if (Array.isArray(content)) {
-    return content
-      .map(block => (typeof block === 'object' && block !== null && 'text' in block && typeof (block as { text?: unknown }).text === 'string'
-        ? (block as { text: string }).text
-        : ''))
-      .filter(text => text.length > 0)
-      .join('\n');
-  }
-  return JSON.stringify(content ?? '');
-}