@vibesdotdev/mcp 0.0.0-stage → 1.0.0-rc.0

package/dist/adapters/mcp/server.consumer.js

@@ -0,0 +1,300 @@
+import { loadPurposePresetOverrides } from '@vibesdotdev/tools/config/load';
+import { runtimePurposePresets } from '@vibesdotdev/tools/schemas/presets/registry';
+import { createBunMcpServer, StdioServerTransport } from "../index.js";
+import { CaughtFailureSchema, getRuntimeHttpListener, isCapabilityError, settle, valueFreeFailure } from '@vibesdotdev/kernel';
+import { getVibesClient } from '@vibesdotdev/kernel/client';
+import { buildServer, createMcpServerCatalogCache } from "./server.js";
+import { wrapTransportWithSchemaTightening } from "../zod-mcp.js";
+import { resolveMcpPreset } from "./tool-selection.js";
+import { announceCurrentAgentSessionIfDue } from '@vibesdotdev/external';
+import { getMcpSamplingCallback } from "./sampling-context.js";
+import { loadMcpConfig } from "../../config/load.js";
+import { createMcpRosterAnnouncer } from "./roster-announcer.js";
+import { requireMcpClient } from "../../client.js";
+import { resolveMcpTransportRegistry } from "./transport-registry.js";
+const SAMPLING_DESCRIPTOR_ID = 'transport-sampling';
+/** One roster announcer per root: a reload generation or plugin view never starts a second. */
+function getRosterAnnouncer(runtime, logger) {
+    const client = requireMcpClient(runtime);
+    return client.rosterAnnouncer ??= (() => {
+        const state = {};
+        return createMcpRosterAnnouncer(() => announceCurrentAgentSessionIfDue(runtime, state), (error) => logger.child('roster').warn('MCP roster announcement failed', { error: error.message }));
+    })();
+}
+/**
+ * Announce roster presence for one tool call. A freshly published generation
+ * has not resolved its MCP client yet, so the synchronous fast path misses:
+ * resolve the client through the runtime (which warms the generation for
+ * later calls) instead of failing the tool call. A genuinely missing
+ * composition still throws from the async resolution, as before.
+ */
+async function announceRosterForCall(runtime, logger) {
+    const fast = await settle(() => getRosterAnnouncer(runtime, logger)());
+    if (fast.ok)
+        return;
+    const failure = CaughtFailureSchema.parse(fast.cause);
+    if (!isCapabilityError(failure) || failure.code !== 'UNAVAILABLE')
+        throw fast.cause;
+    await getVibesClient('mcp', runtime);
+    getRosterAnnouncer(runtime, logger)();
+}
+function ensureSamplingLoaderRegistered(runtime, scopedValues) {
+    if (!runtime.hasKind('mcp/sampling'))
+        return;
+    const accessor = runtime.assets('mcp/sampling');
+    if (accessor.descriptor(SAMPLING_DESCRIPTOR_ID))
+        return;
+    runtime.registerDescriptor('mcp/sampling', {
+        kind: 'mcp/sampling',
+        id: SAMPLING_DESCRIPTOR_ID
+    });
+    runtime.registerLoader('mcp/sampling', SAMPLING_DESCRIPTOR_ID, async () => ({
+        impl: (req) => {
+            const callback = getMcpSamplingCallback(scopedValues);
+            if (!callback) {
+                throw new Error('No MCP transport connected; sampling unavailable');
+            }
+            return callback(req);
+        }
+    }), { priority: 1000 });
+}
+/**
+ * The transport registry's timers (expiry sweep, lease heartbeat) belong to
+ * the runtime serving the transports (RC07): attached when the adapter
+ * starts, stopped when it shuts down or the runtime is disposed.
+ */
+function withSessionRegistryTimers(runtime, createAdapter, logger) {
+    let owner = null;
+    let detach;
+    let closing = null;
+    let adapter;
+    const shutdown = () => {
+        if (closing)
+            return closing;
+        detach?.();
+        detach = undefined;
+        const membershipClose = owner?.dispose() ?? Promise.resolve();
+        closing = Promise.allSettled([membershipClose, Promise.resolve().then(() => adapter?.shutdown())]).then((results) => {
+            const failures = results.flatMap((result) => result.status === 'rejected' ? [result.reason] : []);
+            if (failures.length === 1)
+                throw failures[0];
+            if (failures.length > 1)
+                throw new AggregateError(failures, 'MCP adapter shutdown failed.');
+        });
+        return closing;
+    };
+    return {
+        async start() {
+            if (closing)
+                throw new Error('The MCP adapter is shut down.');
+            const { attachMcpMembershipOwner } = await import('@vibesdotdev/session/mcp/utils/participant');
+            const registry = await resolveMcpTransportRegistry(runtime);
+            if (runtime.hasContext('session/manager')) {
+                owner = await attachMcpMembershipOwner(runtime, registry);
+            }
+            else {
+                // Session is optional for hosts exposing unrelated tools. These hosts
+                // own expiry, not membership leases.
+                logger.child('session').warn('MCP membership renewal unavailable', { reason: 'session-manager-absent' });
+                detach = registry.attachLifecycle(runtime);
+            }
+            try {
+                adapter = await createAdapter((id) => owner?.bind(id) ?? (() => { }));
+                await adapter.start();
+            }
+            catch (error) {
+                try {
+                    await shutdown();
+                }
+                catch (cleanupError) {
+                    throw new AggregateError([error, cleanupError], 'MCP adapter startup and cleanup failed.');
+                }
+                throw error;
+            }
+        },
+        shutdown
+    };
+}
+export function createMcpAdapter(runtime, options, logger) {
+    return withSessionRegistryTimers(runtime, async (bind) => createTransportAdapter(runtime, {
+        ...options, customPresets: { ...await loadPurposePresetOverrides(runtime), ...options.customPresets }
+    }, logger, bind), logger);
+}
+function createTransportAdapter(runtime, options, logger, bindMembershipOwner) {
+    const consumerOptions = {
+        ...options,
+        beforeToolCall: async () => {
+            // Nothing is bound into the environment: a tool that calls a Vibes API
+            // takes the caller's bearer from auth's resolveCallerBearer, by the
+            // host's declared capability (rc05 §2.2).
+            if (runtime.scope.lifecycle !== 'finite') {
+                // Presence publishing remains coalesced background work, as at startup;
+                // a slow optional cloud roster must never gate a local session bind.
+                await announceRosterForCall(runtime, logger);
+            }
+            await options.beforeToolCall?.();
+        }
+    };
+    if (runtime.hasKind('mcp/sampling') && !consumerOptions.scopedValues) {
+        throw new Error('MCP sampling requires a host scoped-values binding; refusing process-global callback state');
+    }
+    ensureSamplingLoaderRegistered(runtime, consumerOptions.scopedValues);
+    const omitOutputSchema = resolveMcpPreset(options.mcpClientId, options.preset, runtimePurposePresets(runtime, options.customPresets)).preset.omitOutputSchemaOnWire === true;
+    if (options.mode === 'http') {
+        let legacyRestoreIdentityTail = Promise.resolve();
+        // Use Bun.serve with Web Standard MCP transport from @vibesdotdev/mcp.
+        // The catalog fold is shared across sessions; only the McpServer (which
+        // owns transport state) is per-connection. Host and port are read from
+        // the MCP config manifest at start so a stored value is honoured.
+        const catalog = createMcpServerCatalogCache(runtime, consumerOptions, logger);
+        const serverOptionsBase = {
+            omitOutputSchema,
+            bindMembershipOwner,
+            // Session expiry and the restore lane's yield are this runtime's (RC07).
+            lifecycle: runtime.lifecycle,
+            // A request's `x-vibes-workspace-path` rides its invocation overlay (M-a).
+            runInRequestWorkspace: (workspace, fn) => runtime.runInvocation(fn, { workspace }),
+            buildServer: (connection) => buildServer(runtime, {
+                ...consumerOptions,
+                resolveTransportSessionId: () => connection?.transportSessionId,
+                resolveConnectionIdentity: () => connection?.identity,
+                resolveVerifiedConnectionIdentity: () => connection?.verified
+            }, logger, catalog.get()),
+            logger,
+            bindCachedDurableRestore: async ({ transportSessionId, sessionId, participantId }) => {
+                const manager = await runtime.context('session/manager');
+                const authoritative = await manager.ensureParticipantSession(participantId);
+                if (authoritative?.id !== sessionId) {
+                    throw new Error(`Cached MCP restore ${participantId}/${sessionId} no longer matches Session authority`);
+                }
+                const { bindRuntimeConnectionReceipt } = await import('@vibesdotdev/session/mcp/utils/participant');
+                bindRuntimeConnectionReceipt(runtime, transportSessionId, participantId, sessionId);
+            },
+            resolveReadOnlyDurableRestore: async ({ sessionId, participantId, newSession, transportSessionId, clientInfo }) => {
+                if (newSession)
+                    return null;
+                if (!participantId && !clientInfo?.harnessSessionId)
+                    return null;
+                let releaseIdentityLane;
+                if (!participantId) {
+                    const preceding = legacyRestoreIdentityTail;
+                    legacyRestoreIdentityTail = new Promise((resolve) => {
+                        releaseIdentityLane = resolve;
+                    });
+                    await preceding;
+                }
+                try {
+                    const manager = await runtime.context('session/manager');
+                    const { bindRuntimeConnectionReceipt, resolveExistingMcpParticipant, resolveExistingParticipantReference } = await import('@vibesdotdev/session/mcp/utils/participant');
+                    const resolved = participantId
+                        ? await resolveExistingParticipantReference(participantId, manager)
+                        : await resolveExistingMcpParticipant(clientInfo
+                            ? {
+                                name: clientInfo.name,
+                                version: clientInfo.version || undefined,
+                                agentId: clientInfo.agentId || undefined,
+                                harnessSessionId: clientInfo.harnessSessionId || undefined,
+                                transport: 'http',
+                                connectionId: transportSessionId
+                            }
+                            : undefined, transportSessionId, manager);
+                    if (!resolved)
+                        return null;
+                    const authoritativeParticipantId = resolved.participantId;
+                    const authoritative = await manager.ensureParticipantSession(authoritativeParticipantId);
+                    if (!authoritative)
+                        return null;
+                    if (sessionId && authoritative.id !== sessionId)
+                        return null;
+                    bindRuntimeConnectionReceipt(runtime, transportSessionId, authoritativeParticipantId, authoritative.id);
+                    return { sessionId: authoritative.id, participantId: authoritativeParticipantId };
+                }
+                finally {
+                    releaseIdentityLane?.();
+                }
+            }
+        };
+        if (options.authenticate)
+            serverOptionsBase.authenticate = options.authenticate;
+        if (options.relayAttestation)
+            serverOptionsBase.relayAttestation = options.relayAttestation;
+        let httpAdapter;
+        return {
+            async start() {
+                const mcpSettings = await loadMcpConfig(runtime);
+                httpAdapter = createBunMcpServer({
+                    ...serverOptionsBase,
+                    listener: await getRuntimeHttpListener(runtime),
+                    port: options.port ?? mcpSettings.httpPort,
+                    hostname: options.host ?? mcpSettings.httpHost
+                });
+                await httpAdapter.start();
+            },
+            async shutdown() {
+                await httpAdapter?.shutdown();
+            }
+        };
+    }
+    const server = buildServer(runtime, consumerOptions, logger);
+    const transport = new StdioServerTransport();
+    transport.onerror = (err) => {
+        logger.child('transport').error('Stdio transport error', {
+            error: valueFreeFailure(CaughtFailureSchema.parse(err))
+        });
+        return err;
+    };
+    // Tighten outgoing tools/list responses by stripping redundant `pattern`
+    // fields when `format` already carries the constraint. Saves significant
+    // bytes on tools whose schemas reference UUIDs, date-times, etc.
+    // Per-preset wire policy. `omitOutputSchemaOnWire` drops `outputSchema` from
+    // tools/list WITHOUT weakening result validation — the SDK validates against the
+    // REGISTERED Zod object (`validateToolOutput`), a separate read from the wire
+    // projection. Measured on the real cursor wire 2026-07-25: outputSchema is
+    // 72,084 B of a 204,965 B catalog (35.2%, 57 of 75 tools), enough alone to put
+    // that client back under WIRE_CATALOG_BUDGET_BYTES. OFF unless a preset opts in.
+    wrapTransportWithSchemaTightening(transport, { omitOutputSchema });
+    let stopHeartbeat;
+    let releaseMembership;
+    const announce = getRosterAnnouncer(runtime, logger);
+    return {
+        async start() {
+            releaseMembership = bindMembershipOwner(null);
+            await server.connect(transport);
+            // Announce agent session presence to the ambient roster, then keep it
+            // fresh on the runtime's lifecycle timer (RC07). A finite host starts
+            // no background tick; it announces once.
+            announce();
+            if (runtime.scope.lifecycle !== 'finite') {
+                stopHeartbeat = runtime.lifecycle.interval(announce, 60_000);
+            }
+            server.server.onerror = (err) => {
+                logger.child('sdk').error('MCP protocol error', {
+                    error: valueFreeFailure(CaughtFailureSchema.parse(err))
+                });
+                return err;
+            };
+            const previousOnClose = server.server.onclose;
+            server.server.onclose = () => {
+                releaseMembership?.();
+                releaseMembership = undefined;
+                previousOnClose?.();
+                stopHeartbeat?.();
+                logger.child('sdk').info('MCP connection closed');
+                void settle(() => options.onStdioClose?.()).then((closed) => {
+                    if (closed.ok)
+                        return;
+                    logger.child('sdk').warn('MCP stdio close hook failed', {
+                        error: valueFreeFailure(closed.cause)
+                    });
+                });
+            };
+        },
+        async shutdown() {
+            releaseMembership?.();
+            releaseMembership = undefined;
+            stopHeartbeat?.();
+            await server.close();
+        }
+    };
+}
+//# sourceMappingURL=server.consumer.js.map

package/dist/adapters/mcp/server.consumer.js.map

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

package/dist/adapters/mcp/server.d.ts

@@ -0,0 +1,56 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { VibesRuntime } from '@vibesdotdev/kernel/api/runtime';
+import type { LoggerImplementation } from '@vibesdotdev/logging/kinds/logger';
+import type { ToolCallContext } from '@vibesdotdev/tools/kinds/tool';
+import type { McpAdapterOptions } from '@vibesdotdev/mcp';
+import { type CapabilityTier } from '@vibesdotdev/tools/schemas/runtime/capability-tier';
+import type { McpConfig } from '../../config/mcp.config.descriptor.ts';
+import { type HarnessIdentitySource } from './serve-identity.ts';
+import { type McpLoaderSettlement, type McpToolCatalog, type McpToolCatalogCache } from './tool-catalog.ts';
+export interface ResolvedMcpClientCapabilityCeiling {
+    profile?: string;
+    ceiling: CapabilityTier;
+}
+/**
+ * Resolve the effective capability tier ceiling for an MCP connection from the
+ * runtime's `mcp` ConfigManifest (`clientCapabilityCeilings`).
+ *
+ * Verified transport harness identity (`admitConnectionCaller`) takes
+ * precedence over server-level `mcpClientId` and `preset`. Unconfigured
+ * profiles fall back to the tools default ceiling (`'1'`).
+ */
+export declare function resolveMcpClientCapabilityCeiling(config: Pick<McpConfig, 'clientCapabilityCeilings'>, input: {
+    admittedCaller?: ToolCallContext['caller'];
+    mcpClientId?: string;
+    preset?: string;
+}, source?: HarnessIdentitySource): ResolvedMcpClientCapabilityCeiling;
+/**
+ * Project-local catalog ids (CLI `list --source=local` parity). Explicit
+ * options win (tests, serve bootstrap); otherwise the tools this runtime's
+ * discovery pass registered from `.vibes/tools`.
+ *
+ * This is the one node-scoped read in the build path, so it lives here rather
+ * than in `tool-catalog.ts`, which stays isomorphic.
+ */
+export declare function resolveLocalToolIds(runtime: VibesRuntime, options: McpAdapterOptions): readonly string[];
+/**
+ * The catalog cache a serving surface should hold: one fold of the registry,
+ * shared by every connection, re-folded the moment the registry moves.
+ *
+ * `loaderSettlement` stays `'advisory'` unless the caller can name the
+ * registration bound for its serving surface (see {@link McpLoaderSettlement}).
+ * A settled cache excludes descriptors whose loader is unresolvable at fold
+ * time, and admits them on the next fold if one registers — the revision key
+ * is the guarantee.
+ */
+export declare function createMcpServerCatalogCache(runtime: VibesRuntime, options: McpAdapterOptions, logger: LoggerImplementation, loaderSettlement?: McpLoaderSettlement): McpToolCatalogCache;
+/**
+ * Construct one `McpServer` for one connection.
+ *
+ * The catalog fold (discover → enable → select → instructions) is NOT done
+ * here: pass a `catalog` from `createMcpToolCatalogCache` so many connections
+ * share one fold. When omitted the fold happens inline, which keeps every
+ * single-server caller (stdio, tests) working exactly as before.
+ */
+export declare function buildServer(runtime: VibesRuntime, options: McpAdapterOptions, logger: LoggerImplementation, catalog?: McpToolCatalog): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/adapters/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiF,MAAM,yCAAyC,CAAC;AAuBnJ,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAKrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAoB1D,OAAO,EAGN,KAAK,cAAc,EAEnB,MAAM,oDAAoD,CAAC;AAQ5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAEvE,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAcnF,OAAO,EAIN,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,kCAAkC;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAChD,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,0BAA0B,CAAC,EACnD,KAAK,EAAE;IACN,cAAc,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,MAAM,CAAC,EAAE,qBAAqB,GAC5B,kCAAkC,CA8BpC;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,GAAG,SAAS,MAAM,EAAE,CAExG;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,oBAAoB,EAC5B,gBAAgB,GAAE,mBAAgC,GAChD,mBAAmB,CAQrB;AA4YD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAC1B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE,cAKR,GACC,SAAS,CAwWX"}