@1mcp/agent 0.39.0-beta.2 → 0.39.0-beta.4

package/build/core/capabilities/metaToolProvider.js

@@ -1,8 +1,9 @@
 import { getConfiguredServerTargets } from '../../config/configuredServerTargets.js';
 import { gatewayFailureFromUnknown } from '../../gateway/contracts/gatewayFailure.js';
+import { writeLocalDiagnostic } from '../../logger/localDiagnostics.js';
 import logger, { errorIf } from '../../logger/logger.js';
 import { zodToInputSchema, zodToOutputSchema } from '../../utils/schemaUtils.js';
-import { CapabilityCatalog } from './capabilityCatalog.js';
+import { CapabilityCatalog, } from './capabilityCatalog.js';
 import { ToolInvokeInputSchema, ToolInvokeOutputSchema, ToolListInputSchema, ToolListOutputSchema, ToolSchemaInputSchema, ToolSchemaOutputSchema, } from './schemas/metaToolSchemas.js';
 /**
  * MetaToolProvider provides meta-tools for lazy loading:
@@ -18,6 +19,7 @@ import { ToolInvokeInputSchema, ToolInvokeOutputSchema, ToolListInputSchema, Too
  * ```
  */
 export class MetaToolProvider {
+    refreshCapabilities;
     getToolRegistry;
     schemaCache;
     outboundConnections;
@@ -25,7 +27,8 @@ export class MetaToolProvider {
     defaultVisibility;
     capabilityCatalog;
     templateHashProvider;
-    constructor(getToolRegistry, schemaCache, outboundConnections, loadSchema, defaultVisibility, templateHashProvider) {
+    constructor(getToolRegistry, schemaCache, outboundConnections, loadSchema, defaultVisibility, templateHashProvider, refreshCapabilities) {
+        this.refreshCapabilities = refreshCapabilities;
         this.getToolRegistry = getToolRegistry;
         this.schemaCache = schemaCache;
         this.outboundConnections = outboundConnections;
@@ -40,6 +43,7 @@ export class MetaToolProvider {
             defaultVisibility,
             templateHashProvider,
             getServerConfigs: getConfiguredServerTargets,
+            refreshCapabilities: this.refreshCapabilities,
         });
     }
     /**
@@ -55,6 +59,7 @@ export class MetaToolProvider {
             defaultVisibility: visibility,
             templateHashProvider: this.templateHashProvider,
             getServerConfigs: getConfiguredServerTargets,
+            refreshCapabilities: this.refreshCapabilities,
         });
     }
     /**
@@ -67,11 +72,17 @@ export class MetaToolProvider {
      * Call a meta-tool by name
      */
     async callMetaTool(name, args, visibility, signal, toolRegistry) {
-        const query = { signal, toolRegistry };
+        const query = { signal, ...(toolRegistry ? { toolRegistry } : {}) };
         switch (name) {
             case 'tool_list': {
                 const parsed = ToolListInputSchema.safeParse(args);
                 if (!parsed.success) {
+                    writeLocalDiagnostic('warn', 'tool.meta-validation-failed', {
+                        requestedTool: name,
+                        phase: 'meta_input_validation',
+                        outcome: 'validation_failed',
+                        error: parsed.error,
+                    });
                     return {
                         tools: [],
                         totalCount: 0,
@@ -88,6 +99,12 @@ export class MetaToolProvider {
             case 'tool_schema': {
                 const parsed = ToolSchemaInputSchema.safeParse(args);
                 if (!parsed.success) {
+                    writeLocalDiagnostic('warn', 'tool.meta-validation-failed', {
+                        requestedTool: name,
+                        phase: 'meta_input_validation',
+                        outcome: 'validation_failed',
+                        error: parsed.error,
+                    });
                     return {
                         schema: {},
                         error: {
@@ -101,6 +118,12 @@ export class MetaToolProvider {
             case 'tool_invoke': {
                 const parsed = ToolInvokeInputSchema.safeParse(args);
                 if (!parsed.success) {
+                    writeLocalDiagnostic('warn', 'tool.meta-validation-failed', {
+                        requestedTool: name,
+                        phase: 'meta_input_validation',
+                        outcome: 'validation_failed',
+                        error: parsed.error,
+                    });
                     return {
                         result: {},
                         server: '',
@@ -142,7 +165,11 @@ export class MetaToolProvider {
      */
     async listAvailableTools(args, visibility, query = {}) {
         try {
-            const result = await this.capabilityCatalog.listVisibleTools(args, visibility, query);
+            const needsRecovery = !args.cursor && !query.toolRegistry && (await this.capabilityCatalog.requiresToolListingRecovery(visibility));
+            const result = await this.capabilityCatalog.listVisibleTools(args, visibility, {
+                ...query,
+                ...(needsRecovery ? { refreshIntent: 'force' } : {}),
+            });
             // Format tools for response
             const tools = result.tools.map((tool) => ({
                 name: tool.name,
@@ -159,15 +186,13 @@ export class MetaToolProvider {
                 servers,
                 hasMore: result.hasMore,
                 ...(result.nextCursor ? { nextCursor: result.nextCursor } : {}),
+                ...(result._meta ? { _meta: result._meta } : {}),
             };
             return response;
         }
         catch (error) {
             const failure = gatewayFailureFromUnknown(error);
-            errorIf(() => ({
-                message: 'Error in tool_list meta-tool',
-                meta: { failure },
-            }));
+            errorIf(() => ({ message: 'metaToolProvider.error.in.tool.list.meta.tool.eff4b338' }));
             return {
                 tools: [],
                 totalCount: 0,
@@ -210,10 +235,7 @@ export class MetaToolProvider {
         }
         catch (error) {
             const failure = gatewayFailureFromUnknown(error);
-            errorIf(() => ({
-                message: 'Error in tool_schema meta-tool',
-                meta: { failure },
-            }));
+            errorIf(() => ({ message: 'metaToolProvider.error.in.tool.schema.meta.tool.4ec3a241' }));
             return {
                 schema: {},
                 error: {
@@ -238,6 +260,7 @@ export class MetaToolProvider {
      * Implement tool_invoke
      */
     async callTool(args, visibility, query = {}) {
+        const startedAt = performance.now();
         try {
             const result = await this.capabilityCatalog.invokeVisibleTool(args, visibility, query);
             if (result.error) {
@@ -256,7 +279,16 @@ export class MetaToolProvider {
         }
         catch (error) {
             const failure = gatewayFailureFromUnknown(error, 'transport');
-            logger.error('Meta-tool invocation failed', { failure });
+            logger.error('metaToolProvider.meta.tool.invocation.failed.aaeb1f9d', { error: error });
+            writeLocalDiagnostic('warn', 'tool.meta-failed', {
+                requestedTool: 'tool_invoke',
+                server: args.server,
+                tool: args.toolName,
+                outcome: query.signal?.aborted ? 'cancelled' : 'failed',
+                durationMs: performance.now() - startedAt,
+                error,
+            });
+            writeLocalDiagnostic('debug', 'tool.meta-failure-details', () => ({ error }));
             return {
                 result: {},
                 server: args.server,

package/build/core/capabilities/metaToolProvider.js.map

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

package/build/core/capabilities/runtimeCapabilityCatalog.d.ts

@@ -1,7 +1,7 @@
 import { type MCPServerParams, type OutboundConnection, type OutboundConnections } from '../types/index.js';
 import { type Tool } from '../../sdk/contracts/index.js';
-import { type CapabilityPaginationResult } from './capabilityPagination.js';
-import type { CapabilityVisibility } from './capabilityVisibility.js';
+import { type CapabilityPaginationResult, type CapabilityResponseBudget } from './capabilityPagination.js';
+import { type CapabilityVisibility } from './capabilityVisibility.js';
 import { type CapabilityKind, type CatalogEntry, type CatalogGeneration } from './catalogGeneration.js';
 /** Only backend replacement is eligible for the aggregate's single collection retry. */
 export declare class RuntimeCatalogBackendChangedError extends Error {
@@ -30,12 +30,19 @@ export interface PreparedToolCall {
 }
 export interface RuntimeCapabilitySnapshot {
     readonly generation: CatalogGeneration;
+    /** Synchronous completeness facts from this captured observation, independent of pagination walks. */
+    readonly capabilityMeta?: Partial<Record<CapabilityKind, Record<string, unknown>>>;
     prepareToolCall(identity: string, args: unknown, signal?: AbortSignal): Promise<PreparedToolCall>;
+    /** The same admitted schema projection used by tools/list, with its captured source fence. */
+    getToolDefinition(identity: string): {
+        tool: Record<string, unknown>;
+        assertCurrent(): void;
+    } | undefined;
     readonly connections: ReadonlyMap<string, OutboundConnection>;
     isCurrent(): boolean;
     /** Whether a captured backend failed to enumerate this kind, leaving the snapshot partial. */
     hasFailedSources(kind: CapabilityKind): boolean;
-    /** Issue a session-scoped, backend-bound route for a resource absent from discovery. */
+    /** Issue an owner- or session-scoped, backend-bound route for a resource absent from discovery. */
     projectUnlistedResource(connectionKey: string, upstreamIdentity: string): string;
     resolve(kind: CapabilityKind, publicIdentity: string): {
         entry: CatalogEntry;
@@ -49,8 +56,16 @@ export interface RuntimeCapabilitySnapshot {
         internalOnly?: boolean;
         visibility?: CapabilityVisibility;
         serverConfigs?: Record<string, MCPServerParams>;
+        /** Set when the page becomes a client response; see {@link CapabilityResponseBudget}. */
+        responseBudget?: CapabilityResponseBudget<T>;
     }): Promise<CapabilityPaginationResult<T>>;
 }
+/** Provenance alone grants no authority: each read must also assert its current owner and route. */
+export declare function isIssuedRuntimeResourceEntry(entry: CatalogEntry): boolean;
+export declare const RUNTIME_CATALOG_SCOPE_TTL_MS: number;
+export declare const MAX_RUNTIME_CATALOG_SCOPES = 256;
+/** Reclaim revoked listener owners without changing legacy session or cursor ownership. */
+export declare function pruneRuntimeResourceRoutes(connections: OutboundConnections): void;
 /** Release all visibility variants and in-flight publications owned by a disconnected session. */
 export declare function evictRuntimeCapabilityCatalogSession(connections: OutboundConnections, sessionId: string): void;
 /** Acquire all route and projection facts before dispatching any capability operation. */

package/build/core/capabilities/runtimeCapabilityCatalog.d.ts.map

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

package/build/core/capabilities/runtimeCapabilityCatalog.js

@@ -2,13 +2,15 @@ import { createHash, randomUUID } from 'node:crypto';
 import { isDeepStrictEqual } from 'node:util';
 import { requestLegacyAdapter } from '../client/legacyAdapterRequest.js';
 import { isSourceToolDisabled } from '../server/disabledTools.js';
+import { parseTemplateConnectionKey } from '../server/templateIdentity.js';
 import { applySourceToolDescription } from '../server/toolDescriptionOverrides.js';
 import { ClientStatus, } from '../types/index.js';
 import { SchemaBoundaryError } from '../validation/schemaBoundary.js';
 import { admitToolSchemas, prepareToolValidation, projectToolSchemas, } from '../validation/toolSchemaBoundary.js';
 import { ErrorCode, OneMcpProtocolError } from '../../sdk/contracts/index.js';
 import { MCPError } from '../../utils/core/errorTypes.js';
-import { CapabilityCursorCapacityError, compareCodePoints, registerCapabilityPaginationNotifications, unregisterCapabilityPaginationConnections, walkCapabilityPages, } from './capabilityPagination.js';
+import { CapabilityCursorCapacityError, compareCodePoints, createCapabilityPartialMeta, getCapabilityPaginationGeneration, registerCapabilityPaginationNotifications, unregisterCapabilityPaginationConnections, walkCapabilityPages, } from './capabilityPagination.js';
+import { isResourceRouteOwnerActive, } from './capabilityVisibility.js';
 import { buildCatalogGeneration, } from './catalogGeneration.js';
 import { clearConfiguredToolSnapshot, publishCompleteConfiguredToolTargetSnapshots, publishConfiguredToolSnapshot, } from './configuredToolSnapshot.js';
 /** Only backend replacement is eligible for the aggregate's single collection retry. */
@@ -25,20 +27,78 @@ const METHODS = {
     resourceTemplates: 'resources/templates/list',
 };
 const states = new WeakMap();
+const issuedResourceEntries = new WeakSet();
+/** Provenance alone grants no authority: each read must also assert its current owner and route. */
+export function isIssuedRuntimeResourceEntry(entry) {
+    return issuedResourceEntries.has(entry);
+}
 let activeAcquisitions = 0;
 const MAX_ACTIVE_ACQUISITIONS = 256;
+export const RUNTIME_CATALOG_SCOPE_TTL_MS = 15 * 60 * 1000;
+export const MAX_RUNTIME_CATALOG_SCOPES = 256;
+function resourceRouteIsCurrent(scope, route) {
+    if (Date.now() >= route.expiresAt)
+        return false;
+    if (route.owner && !isResourceRouteOwnerActive(route.owner))
+        return false;
+    const source = scope.resourceSources.get(route.entry.route.connectionKey);
+    return (!!source &&
+        getCapabilityPaginationGeneration(source, 'resources') === route.resourcesEpoch &&
+        getCapabilityPaginationGeneration(source, 'resourceTemplates') === route.templatesEpoch);
+}
+function pruneResourceRoutes(scope, connections) {
+    const retainedSources = new Set();
+    for (const [identity, route] of scope.resourceRoutes) {
+        const key = route.entry.route.connectionKey;
+        if (!resourceRouteIsCurrent(scope, route) ||
+            connections.get(key) !== route.connection ||
+            route.connection.adapter !== route.adapter ||
+            route.connection.status !== ClientStatus.Connected) {
+            scope.resourceRoutes.delete(identity);
+        }
+        else
+            retainedSources.add(key);
+    }
+    for (const [key, source] of scope.resourceSources) {
+        if (retainedSources.has(key))
+            continue;
+        unregisterCapabilityPaginationConnections(source);
+        scope.resourceSources.delete(key);
+    }
+}
+function releaseResourceRoutes(scope) {
+    scope.resourceRoutes.clear();
+    for (const source of scope.resourceSources.values())
+        unregisterCapabilityPaginationConnections(source);
+    scope.resourceSources.clear();
+}
+function resourceRouteOwnedBy(route, visibility) {
+    if (visibility?.resourceOwner)
+        return route.owner === visibility.resourceOwner;
+    return route.owner === undefined && route.sessionId === visibility?.sessionId;
+}
+/** Reclaim revoked listener owners without changing legacy session or cursor ownership. */
+export function pruneRuntimeResourceRoutes(connections) {
+    for (const scope of states.get(connections)?.scopes.values() ?? [])
+        pruneResourceRoutes(scope, connections);
+}
 /** Release all visibility variants and in-flight publications owned by a disconnected session. */
 export function evictRuntimeCapabilityCatalogSession(connections, sessionId) {
     const state = states.get(connections);
     if (!state)
         return;
     for (const [key, scope] of state.scopes) {
+        for (const [identity, route] of scope.resourceRoutes) {
+            if (!route.owner && route.sessionId === sessionId)
+                scope.resourceRoutes.delete(identity);
+        }
+        pruneResourceRoutes(scope, connections);
         if (scope.sessionId !== sessionId)
             continue;
         state.scopes.delete(key);
         unregisterCapabilityPaginationConnections(scope.paginationConnections);
         scope.paginationConnections.clear();
-        scope.resourceRoutes.clear();
+        releaseResourceRoutes(scope);
     }
 }
 /** Acquire all route and projection facts before dispatching any capability operation. */
@@ -62,21 +122,23 @@ async function collectRuntimeCapabilityCatalog(connections, visibility, options)
         states.set(connections, state);
     }
     for (const [key, retained] of state.scopes) {
-        if (Date.now() - retained.lastAccess < 15 * 60 * 1000)
+        pruneResourceRoutes(retained, connections);
+        if (Date.now() - retained.lastAccess < RUNTIME_CATALOG_SCOPE_TTL_MS)
             continue;
         state.scopes.delete(key);
         unregisterCapabilityPaginationConnections(retained.paginationConnections);
         retained.paginationConnections.clear();
-        retained.resourceRoutes.clear();
+        releaseResourceRoutes(retained);
     }
     const captured = new Map(Array.from(connections).filter(([key, connection]) => connection.status === ClientStatus.Connected && (!visibility || visibility.serverCandidates.has(key))));
     const capturedAdapters = new Map(Array.from(captured, ([key, connection]) => [key, connection.adapter]));
     const { continuation, signal, ...catalogOptions } = options;
     signal?.throwIfAborted();
+    const scopeSessionId = isSessionIndependent(visibility) ? undefined : visibility?.sessionId;
     const scope = createHash('sha256')
         .update(JSON.stringify([
         Array.from(captured.keys()).sort(),
-        visibility?.sessionId,
+        scopeSessionId,
         visibility?.filterSelection,
         catalogOptions,
         visibility ? Array.from(visibility.serverCandidates).sort(([a], [b]) => compareCodePoints(a, b)) : null,
@@ -111,14 +173,16 @@ async function collectRuntimeCapabilityCatalog(connections, visibility, options)
     const started = state.nextId++;
     let currentScope = state.scopes.get(scope);
     if (!currentScope) {
-        if (state.scopes.size >= 256)
+        if (state.scopes.size >= MAX_RUNTIME_CATALOG_SCOPES)
             throw new CapabilityCursorCapacityError();
         currentScope = {
-            sessionId: visibility?.sessionId,
+            sessionId: scopeSessionId,
             latestStarted: started,
             lastAccess: Date.now(),
             paginationConnections: new Map(captured),
             resourceRoutes: new Map(),
+            resourceSources: new Map(),
+            admissionOutcomes: new Map(),
         };
         state.scopes.set(scope, currentScope);
     }
@@ -292,8 +356,33 @@ async function collectRuntimeCapabilityCatalog(connections, visibility, options)
     }
     if (!scopedState.observedTools || started > scopedState.observedTools.started) {
         scopedState.observedTools = { started, fingerprints: sourceFingerprints };
+        for (const [routeKey, outcome] of scopedState.admissionOutcomes) {
+            if (sourceFingerprints.has(routeKey))
+                continue;
+            const provider = sourcePages.find((page) => page.kind === 'tools' && page.key === outcome.connectionKey);
+            // Failed listing does not prove a previously observed tool was removed.
+            if (provider?.error)
+                continue;
+            scopedState.admissionOutcomes.delete(routeKey);
+        }
     }
+    const recordAdmission = (routeKey, connectionKey, error) => {
+        if (!scopedState.observedTools?.fingerprints.has(routeKey))
+            return;
+        const previous = scopedState.admissionOutcomes.get(routeKey);
+        if (previous && previous.started > started)
+            return;
+        if (!previous && scopedState.admissionOutcomes.size >= 100000)
+            throw new CapabilityCursorCapacityError();
+        scopedState.admissionOutcomes.set(routeKey, { started, connectionKey, error });
+        if (!error)
+            return;
+        const connection = captured.get(connectionKey);
+        if (connection)
+            publishConfiguredToolSnapshot(connection, [], false);
+    };
     const schemaContracts = new Map();
+    const admissionTimeouts = [];
     for (let index = 0; index < sources.length;) {
         const source = sources[index];
         if (source.kind !== 'tools') {
@@ -310,12 +399,26 @@ async function collectRuntimeCapabilityCatalog(connections, visibility, options)
                 signal,
             }));
             signal?.throwIfAborted();
+            recordAdmission(routeKey, source.connectionKey);
             index++;
         }
         catch (error) {
             signal?.throwIfAborted();
-            if (!(error instanceof SchemaBoundaryError) || error.retryable)
+            recordAdmission(routeKey, source.connectionKey, error instanceof SchemaBoundaryError ? error : new SchemaBoundaryError('schema_invalid'));
+            if (!(error instanceof SchemaBoundaryError))
+                throw error;
+            if (source.origin === 'internal')
                 throw error;
+            if (error.phase !== 'admission')
+                throw error;
+            if (error.code === 'schema_evaluation_unavailable')
+                throw error;
+            if (error.code === 'schema_evaluation_timeout') {
+                admissionTimeouts.push(source.connectionKey);
+            }
+            else if (error.retryable) {
+                throw error;
+            }
             sources.splice(index, 1);
         }
     }
@@ -357,6 +460,7 @@ async function collectRuntimeCapabilityCatalog(connections, visibility, options)
         }
     const entriesJson = JSON.stringify([
         generation.entries,
+        admissionTimeouts,
         sourcePages.map((provider) => ({
             kind: provider.kind,
             key: provider.key,
@@ -374,18 +478,29 @@ async function collectRuntimeCapabilityCatalog(connections, visibility, options)
         }
         return lastSignature;
     };
+    const capabilityMeta = {};
+    for (const kind of Object.keys(METHODS)) {
+        const meta = createCapabilityPartialMeta(String(generation.id), sourcePages.filter((provider) => provider.kind === kind && provider.error).map((provider) => provider.key), kind === 'tools' ? admissionTimeouts : []);
+        if (meta)
+            capabilityMeta[kind] = meta;
+    }
     const snapshot = Object.freeze({
         generation,
-        async prepareToolCall(identity, args, signal) {
+        ...(Object.keys(capabilityMeta).length > 0 ? { capabilityMeta: Object.freeze(capabilityMeta) } : {}),
+        getToolDefinition(identity) {
             const resolved = snapshot.resolve('tools', identity);
             if (!resolved)
-                throw new SchemaBoundaryError('schema_invalid');
+                return undefined;
             const routeKey = JSON.stringify([resolved.entry.route.connectionKey, resolved.entry.route.upstreamIdentity]);
             const contract = schemaContracts.get(routeKey);
             if (!contract)
                 throw new SchemaBoundaryError('schema_invalid');
             const assertContractCurrent = () => {
                 assertCurrent();
+                // Admission outcomes invalidate routes even when a newer pending read suppresses publication.
+                const failure = scopedState.admissionOutcomes.get(routeKey)?.error;
+                if (failure)
+                    throw new SchemaBoundaryError(failure.code, failure.retryable, failure.phase);
                 // A known changed/removed source invalidates just this route, including an
                 // admission that fails. Starting an otherwise identical read does not.
                 if (scopedState.observedTools?.fingerprints.get(routeKey) !== sourceFingerprints.get(routeKey))
@@ -398,13 +513,25 @@ async function collectRuntimeCapabilityCatalog(connections, visibility, options)
                     throw new SchemaBoundaryError('schema_invalid');
             };
             assertContractCurrent();
+            return Object.freeze({
+                tool: Object.freeze(projectToolSchemas(resolved.entry.publicObject, contract)),
+                assertCurrent: assertContractCurrent,
+            });
+        },
+        async prepareToolCall(identity, args, signal) {
+            const definition = snapshot.getToolDefinition(identity);
+            if (!definition)
+                throw new SchemaBoundaryError('schema_invalid');
+            const resolved = snapshot.resolve('tools', identity);
+            const routeKey = JSON.stringify([resolved.entry.route.connectionKey, resolved.entry.route.upstreamIdentity]);
+            const contract = schemaContracts.get(routeKey);
             const validateOutput = await prepareToolValidation(contract, args, {
                 routeKey,
                 generation: String(started),
                 signal,
             });
-            assertContractCurrent();
-            return Object.freeze(Object.assign(validateOutput, { assertCurrent: assertContractCurrent }));
+            definition.assertCurrent();
+            return Object.freeze(Object.assign(validateOutput, { assertCurrent: definition.assertCurrent }));
         },
         connections: readonlyConnections(captured),
         isCurrent,
@@ -413,17 +540,27 @@ async function collectRuntimeCapabilityCatalog(connections, visibility, options)
         },
         projectUnlistedResource(connectionKey, upstreamIdentity) {
             assertCurrent();
+            if (visibility?.resourceOwner && !isResourceRouteOwnerActive(visibility.resourceOwner))
+                throw new Error('Resource route owner is unavailable');
+            pruneResourceRoutes(scopedState, connections);
             const connection = captured.get(connectionKey);
             if (!connection)
                 throw new Error('Unknown resource backend');
             for (const [identity, route] of scopedState.resourceRoutes) {
-                if (route.entry.route.connectionKey === connectionKey &&
+                if (resourceRouteOwnedBy(route, visibility) &&
+                    route.entry.route.connectionKey === connectionKey &&
                     route.entry.route.upstreamIdentity === upstreamIdentity)
                     return identity;
             }
             if (scopedState.resourceRoutes.size >= 1000)
                 throw new Error('Resource route capacity exceeded');
-            // This namespace cannot collide with canonical identities, which always contain the MCP separator.
+            let source = scopedState.resourceSources.get(connectionKey);
+            if (!source) {
+                source = new Map([[connectionKey, connection]]);
+                scopedState.resourceSources.set(connectionKey, source);
+                registerCapabilityPaginationNotifications(source, connection);
+            }
+            // Generated resource identities use a scheme extension; retained legacy identities contain the MCP separator.
             const identity = `urn:1mcp:resource:${randomUUID()}`;
             const server = visibility?.serverCandidates.get(connectionKey) ?? connection.name ?? connectionKey;
             const entry = Object.freeze({
@@ -438,12 +575,24 @@ async function collectRuntimeCapabilityCatalog(connections, visibility, options)
                 sourceObject: Object.freeze({ name: upstreamIdentity, uri: upstreamIdentity }),
                 publicObject: Object.freeze({ name: upstreamIdentity, uri: identity }),
             });
-            scopedState.resourceRoutes.set(identity, { entry, connection, adapter: connection.adapter });
+            issuedResourceEntries.add(entry);
+            scopedState.resourceRoutes.set(identity, {
+                entry,
+                connection,
+                adapter: connection.adapter,
+                ...(visibility?.resourceOwner ? { owner: visibility.resourceOwner } : { sessionId: visibility?.sessionId }),
+                expiresAt: Date.now() + RUNTIME_CATALOG_SCOPE_TTL_MS,
+                resourcesEpoch: getCapabilityPaginationGeneration(source, 'resources'),
+                templatesEpoch: getCapabilityPaginationGeneration(source, 'resourceTemplates'),
+            });
             return identity;
         },
         resolve(kind, identity) {
             assertCurrent();
-            const issued = kind === 'resources' ? scopedState.resourceRoutes.get(identity) : undefined;
+            const routed = kind === 'resources' ? scopedState.resourceRoutes.get(identity) : undefined;
+            const issued = routed && resourceRouteOwnedBy(routed, visibility) && resourceRouteIsCurrent(scopedState, routed)
+                ? routed
+                : undefined;
             const entry = generation.resolve(kind, identity, keys) ??
                 (issued &&
                     captured.get(issued.entry.route.connectionKey) === issued.connection &&
@@ -556,6 +705,7 @@ async function collectRuntimeCapabilityCatalog(connections, visibility, options)
                 failedProviderIds: sourcePages
                     .filter((provider) => provider.kind === kind && provider.error)
                     .map((provider) => provider.key),
+                upstreamToolAdmissionTimeouts: kind === 'tools' ? admissionTimeouts : undefined,
                 extraGenerationSignature: signature(listOptions.serverConfigs ?? options.serverConfigs),
                 providers,
             });
@@ -572,7 +722,7 @@ async function collectRuntimeCapabilityCatalog(connections, visibility, options)
             else
                 publishConfiguredToolSnapshot(connection, generation.entries
                     .filter((entry) => entry.route.kind === 'tools' && entry.route.connectionKey === key)
-                    .map((entry) => entry.sourceObject));
+                    .map((entry) => entry.sourceObject), !admissionTimeouts.includes(key));
         }
         publishCompleteConfiguredToolTargetSnapshots(connections);
     }
@@ -585,6 +735,20 @@ async function collectRuntimeCapabilityCatalog(connections, visibility, options)
 function isUnimplementedResourceTemplates(kind, error) {
     return (kind === 'resourceTemplates' && error instanceof OneMcpProtocolError && error.code === ErrorCode.MethodNotFound);
 }
+/**
+ * Static servers look the same to every session, so their catalog scope can be shared.
+ * Stateless inbound requests run each page in a fresh session; a shared scope lets the
+ * next request resume a cursor. Session-scoped template instances keep their own scope.
+ */
+function isSessionIndependent(visibility) {
+    if (!visibility)
+        return true;
+    for (const key of visibility.serverCandidates.keys()) {
+        if (parseTemplateConnectionKey(key).kind !== 'static')
+            return false;
+    }
+    return true;
+}
 function getCapabilityIdentity(kind, value) {
     if (kind === 'resources')
         return value.uri;