@farming-labs/docs 0.2.78 → 0.2.80

package/dist/mcp.mjs

@@ -1,15 +1,13 @@
 import { a as emitDocsAnalyticsEvent, i as emitDocsAgentTraceEvent, n as createDocsAgentTraceContext, r as createDocsAgentTraceId } from "./analytics-Bx44lg6d.mjs";
-import { $n as resolveDocsMcpResourceLocation, An as normalizeAgentScopeValues, Dn as agentVersionConstraintsOverlap, E as DOCS_MARKDOWN_SECTION_INDEX_FORMAT, En as agentVersionConstraintMatches, Fn as isDocsRetrievalCanonicalUrl, In as normalizeDocsRelated, Kn as isDocsMcpOAuthScopeToken, Ln as renderDocsRelatedMarkdownLines, Mn as DocsPaginationCursorError, Nn as paginateDocsItems, On as normalizeAgentFramework, P as buildDocsMarkdownSectionIndex, Qn as resolveDocsMcpProtectedResourceMetadataLocation, Xn as normalizeDocsMcpAuthorizationServerUrls, Yn as isDocsMcpResourcePath, Zn as normalizeDocsMcpEndpointPath, dn as performDocsSearchWithMetadata, en as buildDocsSearchFacets, kn as normalizeAgentLocale, ln as normalizeDocsSearchFilters, qn as isDocsMcpProtectedResourceMetadataPath, un as performDocsSearch, wn as resolveDocsAudienceMdxContent, wt as toDocsMarkdownUrl } from "./agent-Ba94vwM2.mjs";
+import { $n as normalizeDocsMcpEndpointPath, An as normalizeAgentFramework, E as DOCS_MARKDOWN_SECTION_INDEX_FORMAT, En as resolveDocsAudienceMdxContent, Fn as paginateDocsItems, Jn as isDocsMcpOAuthScopeToken, Jt as resolveDocsContentChangesConfig, Kt as isDocsContentChangeGeneration, Ln as isDocsRetrievalCanonicalUrl, Mn as normalizeAgentScopeValues, On as agentVersionConstraintMatches, P as buildDocsMarkdownSectionIndex, Pn as DocsPaginationCursorError, Qn as normalizeDocsMcpAuthorizationServerUrls, Rn as normalizeDocsRelated, Ut as DocsContentChangesRequestError, Wt as createDocsContentChangeFeed, Yn as isDocsMcpProtectedResourceMetadataPath, Zn as isDocsMcpResourcePath, dn as performDocsSearch, er as resolveDocsMcpProtectedResourceMetadataLocation, fn as performDocsSearchWithMetadata, jn as normalizeAgentLocale, kn as agentVersionConstraintsOverlap, tn as buildDocsSearchFacets, tr as resolveDocsMcpResourceLocation, un as normalizeDocsSearchFilters, wt as toDocsMarkdownUrl, yn as resolveLocalDocsMcpSearchConfig, zn as renderDocsRelatedMarkdownLines } from "./agent-Cj50nyeV.mjs";
 import { S as upsertPageAgentContractMarkdown, _ as hasStructuredPageAgentContract, o as findDocsMarkdownSection, s as parseDocsMarkdownSections, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
 import "./standards-discovery-BKlEnK_H.mjs";
-import { f as emitDocsTelemetryAgentSurfaceEvent, h as emitDocsTelemetryProjectEvent, l as resolvePageSidebarFolderIndexBehavior, m as emitDocsTelemetryMcpToolEvent, s as stripGeneratedAgentProvenance } from "./agent-provenance-D8UBpnMc.mjs";
+import { f as emitDocsTelemetryAgentSurfaceEvent, h as emitDocsTelemetryProjectEvent, l as resolvePageSidebarFolderIndexBehavior, m as emitDocsTelemetryMcpToolEvent, s as stripGeneratedAgentProvenance } from "./agent-provenance-C_jgqNTW.mjs";
 import matter from "gray-matter";
 import fs from "node:fs";
 import path from "node:path";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
-import { ErrorCode, ListPromptsRequestSchema, ListResourceTemplatesRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, McpError, isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import { serveStdio } from "@modelcontextprotocol/server/stdio";
+import { InMemoryServerEventBus, McpServer, ProtocolError, ProtocolErrorCode, ResourceTemplate, createMcpHandler, isInitializeRequest } from "@modelcontextprotocol/server";
 import * as z from "zod/v4";
 
 //#region src/mcp.ts
@@ -21,6 +19,9 @@ const MAX_MCP_CONTEXT_TOKEN_BUDGET = 32e3;
 const DOCS_MCP_PROTOCOL_LIST_PAGE_SIZE = 10;
 const DOCS_MCP_TOOL_LIST_PAGE_SIZE = 25;
 const DOCS_MCP_PAGINATION_META_KEY = "dev.farming-labs/pagination";
+const DOCS_MCP_CONTENT_CHANGES_CURRENT_URI = "docs://changes/current";
+const DOCS_MCP_CONTENT_CHANGES_URI_TEMPLATE = "docs://changes/{generation}";
+const DEFAULT_DOCS_MCP_CONTENT_CHANGE_POLL_INTERVAL_MS = 3e4;
 const UTF8_ENCODER = new TextEncoder();
 const DEFAULT_DOCS_MCP_MAX_BODY_BYTES = 1024 * 1024;
 const DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS = 600;
@@ -29,6 +30,8 @@ const DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS = Object.freeze([
 	"Authorization",
 	"Content-Type",
 	"Last-Event-ID",
+	"MCP-Method",
+	"MCP-Name",
 	"MCP-Protocol-Version",
 	"MCP-Session-Id"
 ]);
@@ -1568,6 +1571,13 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 						default: true,
 						description: "Expose the list_search_facets tool for body-free framework, version, package, and tag discovery."
 					},
+					{
+						path: "mcp.tools.listContentChanges",
+						name: "listContentChanges",
+						type: "boolean",
+						default: true,
+						description: "Expose list_content_changes polling and docs://changes resources when agent.contentChanges is enabled."
+					},
 					{
 						path: "mcp.tools.readPage",
 						name: "readPage",
@@ -1880,6 +1890,10 @@ const listDocsInputSchema = z.object({
 	cursor: paginationCursorInputSchema
 });
 const getNavigationInputSchema = z.object({ locale: z.string().trim().min(1).max(128).optional() });
+const listContentChangesInputSchema = z.object({
+	since: z.string().refine(isDocsContentChangeGeneration, "Expected a SHA-256 index generation").optional(),
+	locale: z.string().trim().min(1).max(128).optional()
+});
 const getConfigSchemaInputSchema = z.object({
 	option: z.string().trim().min(1).optional(),
 	query: z.string().trim().min(1).optional()
@@ -1987,6 +2001,37 @@ const retrievalSourceScopeOutputSchema = z.object({
 	])).max(4).optional()
 });
 const retrievalSourceDigestOutputSchema = z.string().regex(/^sha256:[a-f\d]{64}$/iu);
+const contentChangeDocumentOutputSchema = z.object({
+	url: z.string(),
+	canonicalUrl: z.string().max(4096).refine(isDocsRetrievalCanonicalUrl, "Expected a safe HTTP(S) URL or root-relative path"),
+	digest: retrievalSourceDigestOutputSchema,
+	lastModified: z.string().optional()
+});
+const contentChangesOutputSchema = z.object({
+	format: z.literal("docs-content-changes.v1"),
+	audience: z.enum(["human", "agent"]),
+	locale: z.string().optional(),
+	since: retrievalSourceDigestOutputSchema.nullable(),
+	indexGeneration: retrievalSourceDigestOutputSchema,
+	mode: z.enum([
+		"snapshot",
+		"delta",
+		"reset"
+	]),
+	resetRequired: z.boolean(),
+	documentCount: z.number().int().nonnegative(),
+	counts: z.object({
+		added: z.number().int().nonnegative(),
+		changed: z.number().int().nonnegative(),
+		deleted: z.number().int().nonnegative()
+	}),
+	added: z.array(contentChangeDocumentOutputSchema),
+	changed: z.array(contentChangeDocumentOutputSchema.extend({
+		previousDigest: retrievalSourceDigestOutputSchema,
+		previousLastModified: z.string().optional()
+	})),
+	deleted: z.array(contentChangeDocumentOutputSchema)
+});
 const retrievalSourceOutputSchema = z.object({
 	canonicalUrl: z.string().max(4096).refine(isDocsRetrievalCanonicalUrl, "Expected a safe HTTP(S) URL or root-relative path"),
 	scope: retrievalSourceScopeOutputSchema,
@@ -2228,6 +2273,7 @@ function resolveDocsMcpConfig(mcp, defaults = {}) {
 			readTask: true,
 			searchDocs: true,
 			searchFacets: true,
+			listContentChanges: true,
 			getNavigation: true,
 			getCodeExamples: true,
 			getConfigSchema: true,
@@ -2250,6 +2296,7 @@ function resolveDocsMcpConfig(mcp, defaults = {}) {
 			readTask: config.tools?.readTask ?? true,
 			searchDocs: config.tools?.searchDocs ?? true,
 			searchFacets: config.tools?.searchFacets ?? true,
+			listContentChanges: config.tools?.listContentChanges ?? true,
 			getNavigation: config.tools?.getNavigation ?? true,
 			getCodeExamples: config.tools?.getCodeExamples ?? true,
 			getConfigSchema: config.tools?.getConfigSchema ?? true,
@@ -2368,6 +2415,54 @@ function nowMs() {
 function durationMs(startedAt) {
 	return Math.max(0, Date.now() - startedAt);
 }
+function createDocsMcpContentChangeMonitor(options) {
+	let context;
+	let generation;
+	let timer;
+	let running = false;
+	let closed = false;
+	const schedule = () => {
+		if (closed || timer || running || options.isActive?.() === false) return;
+		timer = setTimeout(async () => {
+			timer = void 0;
+			if (closed || context === void 0 || options.isActive?.() === false) return;
+			running = true;
+			try {
+				const nextGeneration = await options.readGeneration(context);
+				if (generation && nextGeneration !== generation) {
+					generation = nextGeneration;
+					await options.notify();
+				} else generation = nextGeneration;
+			} catch {} finally {
+				running = false;
+				schedule();
+			}
+		}, options.pollIntervalMs);
+		if (options.unrefTimer) timer.unref?.();
+	};
+	return {
+		async start(nextContext) {
+			if (closed) return;
+			context = nextContext;
+			if (timer) {
+				clearTimeout(timer);
+				timer = void 0;
+			}
+			try {
+				generation = await options.readGeneration(nextContext);
+			} catch {
+				generation = void 0;
+			}
+			schedule();
+		},
+		close() {
+			closed = true;
+			context = void 0;
+			if (timer) clearTimeout(timer);
+			timer = void 0;
+		}
+	};
+}
 function createStructuredTextResult(structuredContent, text) {
 	return {
 		content: [{
@@ -2399,7 +2494,7 @@ function paginateDocsMcpProtocolItems(items, options) {
 			pageSize: DOCS_MCP_PROTOCOL_LIST_PAGE_SIZE
 		});
 	} catch (error) {
-		if (error instanceof DocsPaginationCursorError) throw new McpError(ErrorCode.InvalidParams, error.message);
+		if (error instanceof DocsPaginationCursorError) throw new ProtocolError(ProtocolErrorCode.InvalidParams, error.message);
 		throw error;
 	}
 }
@@ -2430,10 +2525,10 @@ function paginateDocsMcpSdkListResult(result, field, options) {
 function installDocsMcpSdkListPaginationInterceptor(server, scope) {
 	const originalSetRequestHandler = server.server.setRequestHandler;
 	const setRequestHandler = originalSetRequestHandler.bind(server.server);
-	const interceptedSetRequestHandler = ((requestSchema, handler) => {
+	const interceptedSetRequestHandler = ((method, handler) => {
 		const sdkHandler = handler;
-		if (Object.is(requestSchema, ListResourcesRequestSchema)) {
-			setRequestHandler(ListResourcesRequestSchema, async (request, extra) => {
+		if (method === "resources/list") {
+			setRequestHandler("resources/list", async (request, extra) => {
 				return paginateDocsMcpSdkListResult(await sdkHandler(request, extra), "resources", {
 					kind: "mcp.protocol/resources-list",
 					scope,
@@ -2446,8 +2541,8 @@ function installDocsMcpSdkListPaginationInterceptor(server, scope) {
 			});
 			return;
 		}
-		if (Object.is(requestSchema, ListResourceTemplatesRequestSchema)) {
-			setRequestHandler(ListResourceTemplatesRequestSchema, async (request, extra) => {
+		if (method === "resources/templates/list") {
+			setRequestHandler("resources/templates/list", async (request, extra) => {
 				return paginateDocsMcpSdkListResult(await sdkHandler(request, extra), "resourceTemplates", {
 					kind: "mcp.protocol/resource-templates-list",
 					scope,
@@ -2460,8 +2555,8 @@ function installDocsMcpSdkListPaginationInterceptor(server, scope) {
 			});
 			return;
 		}
-		if (Object.is(requestSchema, ListToolsRequestSchema)) {
-			setRequestHandler(ListToolsRequestSchema, async (request, extra) => {
+		if (method === "tools/list") {
+			setRequestHandler("tools/list", async (request, extra) => {
 				return paginateDocsMcpSdkListResult(await sdkHandler(request, extra), "tools", {
 					kind: "mcp.protocol/tools-list",
 					scope,
@@ -2471,8 +2566,8 @@ function installDocsMcpSdkListPaginationInterceptor(server, scope) {
 			});
 			return;
 		}
-		if (Object.is(requestSchema, ListPromptsRequestSchema)) {
-			setRequestHandler(ListPromptsRequestSchema, async (request, extra) => {
+		if (method === "prompts/list") {
+			setRequestHandler("prompts/list", async (request, extra) => {
 				return paginateDocsMcpSdkListResult(await sdkHandler(request, extra), "prompts", {
 					kind: "mcp.protocol/prompts-list",
 					scope,
@@ -2482,7 +2577,7 @@ function installDocsMcpSdkListPaginationInterceptor(server, scope) {
 			});
 			return;
 		}
-		setRequestHandler(requestSchema, handler);
+		setRequestHandler(method, handler);
 	});
 	server.server.setRequestHandler = interceptedSetRequestHandler;
 	return () => {
@@ -2499,27 +2594,26 @@ function installDocsMcpSdkRegistrationPagination(server, scope) {
 		}
 	} });
 	server.registerTool = wrapRegistration(server.registerTool);
-	server.tool = wrapRegistration(server.tool);
 	server.registerResource = wrapRegistration(server.registerResource);
-	server.resource = wrapRegistration(server.resource);
 	server.registerPrompt = wrapRegistration(server.registerPrompt);
-	server.prompt = wrapRegistration(server.prompt);
 }
 async function createDocsMcpServer(options) {
 	const resolved = resolveDocsMcpConfig(options.mcp, {
 		defaultName: options.defaultName ?? options.source.siteTitle ?? DEFAULT_MCP_NAME,
 		defaultVersion: options.defaultVersion
 	});
-	const toolSearchConfig = resolveMcpToolSearchConfig(options.search, resolved.route);
+	const toolSearchConfig = resolveLocalDocsMcpSearchConfig(options.search, options.mcp, options.requestContext?.request?.url);
 	const protocolScope = stableDocsMcpPaginationScope({
 		name: resolved.name,
 		version: resolved.version
 	});
+	const contentChangesEnabled = resolveDocsContentChangesConfig(options.contentChanges).enabled && resolved.tools.listContentChanges !== false;
 	const server = new McpServer({
 		name: resolved.name,
 		version: resolved.version
 	});
 	installDocsMcpSdkRegistrationPagination(server, protocolScope);
+	if (contentChangesEnabled) server.server.registerCapabilities({ resources: { subscribe: true } });
 	const registerResource = (name, uri, metadata, callback) => {
 		return server.registerResource(name, uri, metadata, callback);
 	};
@@ -2556,6 +2650,26 @@ async function createDocsMcpServer(options) {
 	const defaultPages = dedupePages(await getSourcePages());
 	const defaultTree = await getSourceNavigation();
 	const defaultSkills = await getSourceSkills();
+	const contentChangeFeed = options.contentChangeFeed ?? createDocsContentChangeFeed(options.contentChanges);
+	async function resolveContentChanges(since, locale) {
+		if (!contentChangesEnabled) throw new ProtocolError(ProtocolErrorCode.MethodNotFound, "Content changes are disabled.");
+		if (since && !isDocsContentChangeGeneration(since)) throw new ProtocolError(ProtocolErrorCode.InvalidParams, "Content-change `since` must be a SHA-256 index generation.");
+		const resolvedLocale = resolveSourceLocale(locale);
+		try {
+			return await contentChangeFeed.resolve({
+				pages: toSearchSourcePages(dedupePages(await options.source.getPages(resolvedLocale, options.requestContext))),
+				search: options.search,
+				audience: "agent",
+				locale: resolvedLocale,
+				baseUrl: options.source.baseUrl ?? (options.requestContext?.request ? new URL(options.requestContext.request.url).origin : void 0),
+				...since ? { since } : {},
+				...options.requestContext?.request ? { request: options.requestContext.request.clone() } : {}
+			});
+		} catch (error) {
+			if (error instanceof DocsContentChangesRequestError) throw new ProtocolError(ProtocolErrorCode.InvalidParams, error.message);
+			throw error;
+		}
+	}
 	registerResource("docs-navigation", "docs://navigation", {
 		title: "Docs Navigation",
 		description: "Structured navigation tree for the documentation site.",
@@ -2565,6 +2679,65 @@ async function createDocsMcpServer(options) {
 		mimeType: "text/plain",
 		text: renderNavigationTree(defaultTree)
 	}] }));
+	if (contentChangesEnabled) {
+		const readChanges = async (generation) => {
+			const result = await resolveContentChanges(generation && generation !== "current" ? generation : void 0);
+			return { contents: [{
+				uri: generation && generation !== "current" ? `docs://changes/${generation}` : DOCS_MCP_CONTENT_CHANGES_CURRENT_URI,
+				mimeType: "application/json",
+				text: JSON.stringify(result, null, 2)
+			}] };
+		};
+		registerResource("docs-content-changes-current", DOCS_MCP_CONTENT_CHANGES_CURRENT_URI, {
+			title: "Current docs content changes",
+			description: "Stable subscription target for body-free documentation change notifications.",
+			mimeType: "application/json"
+		}, async () => readChanges());
+		server.registerResource("docs-content-changes-by-generation", new ResourceTemplate(DOCS_MCP_CONTENT_CHANGES_URI_TEMPLATE, { list: async () => {
+			return { resources: [{
+				uri: `docs://changes/${(await resolveContentChanges()).indexGeneration}`,
+				name: "Docs changes from current generation",
+				title: "Docs changes from current generation",
+				description: "Read this URI later to retrieve changes since the listed generation.",
+				mimeType: "application/json"
+			}] };
+		} }), {
+			title: "Docs content changes by generation",
+			description: "Body-free documentation changes from a SHA-256 index generation to the current generation.",
+			mimeType: "application/json"
+		}, async (_uri, variables) => {
+			const generation = variables.generation;
+			if (typeof generation !== "string" || !isDocsContentChangeGeneration(generation)) throw new ProtocolError(ProtocolErrorCode.InvalidParams, "Change resource generation must be a SHA-256 index generation.");
+			return readChanges(generation);
+		});
+		registerTool("list_content_changes", {
+			title: "List docs content changes",
+			description: "Synchronize body-free document metadata. Save indexGeneration and pass it as since on the next poll. A reset response means the named snapshot is no longer available.",
+			inputSchema: listContentChangesInputSchema,
+			outputSchema: contentChangesOutputSchema,
+			annotations: { readOnlyHint: true }
+		}, async ({ since, locale }) => {
+			const startedAt = nowMs();
+			const result = await resolveContentChanges(since, locale);
+			trackMcpTool("list_content_changes", {
+				locale,
+				resultCount: result.counts.added + result.counts.changed + result.counts.deleted
+			});
+			await emitDocsAnalyticsEvent(options.analytics, {
+				type: "mcp_tool",
+				source: "mcp",
+				locale,
+				properties: {
+					tool: "list_content_changes",
+					mode: result.mode,
+					resetRequired: result.resetRequired,
+					resultCount: result.counts.added + result.counts.changed + result.counts.deleted,
+					durationMs: durationMs(startedAt)
+				}
+			});
+			return createStructuredTextResult(result);
+		});
+	}
 	for (const page of defaultPages) {
 		const resourceUri = toPageResourceUri(page.url);
 		registerResource(`page-${slugToKey(page.slug)}`, resourceUri, {
@@ -4051,20 +4224,48 @@ function createDocsMcpHttpHandler(options) {
 			data: { reason: "mcp_disabled" }
 		}),
 		DELETE: async () => createJsonErrorResponse(404, disabledMessage),
-		OPTIONS: async () => createJsonErrorResponse(404, disabledMessage)
+		OPTIONS: async () => createJsonErrorResponse(404, disabledMessage),
+		close: async () => {}
 	};
-	async function createStatelessTransport(requestContext) {
-		const server = await createDocsMcpServer({
+	const contentChangesEnabled = resolveDocsContentChangesConfig(options.contentChanges).enabled && resolved.tools.listContentChanges !== false;
+	const contentChangeFeed = options.contentChangeFeed ?? createDocsContentChangeFeed(options.contentChanges);
+	const eventBus = new InMemoryServerEventBus();
+	const mcpHandler = createMcpHandler(async (context) => {
+		const internalAuth = context.authInfo;
+		return createDocsMcpServer({
 			...options,
-			requestContext
+			contentChangeFeed,
+			requestContext: {
+				transport: "http",
+				...context.requestInfo ? { request: context.requestInfo.clone() } : {},
+				...internalAuth?.principal ? { auth: internalAuth.principal } : {}
+			}
 		});
-		const transport = new WebStandardStreamableHTTPServerTransport({ sessionIdGenerator: void 0 });
-		await server.connect(transport);
-		return {
-			server,
-			transport
-		};
+	}, {
+		legacy: "stateless",
+		bus: eventBus
+	});
+	const configuredPollInterval = options.contentChangePollIntervalMs;
+	const contentChangePollIntervalMs = typeof configuredPollInterval === "number" && Number.isFinite(configuredPollInterval) && configuredPollInterval >= 10 ? Math.floor(configuredPollInterval) : DEFAULT_DOCS_MCP_CONTENT_CHANGE_POLL_INTERVAL_MS;
+	async function readMonitoredGeneration(context) {
+		const locale = options.source.resolveLocale?.(void 0, context);
+		const pages = dedupePages(await options.source.getPages(locale, context));
+		return (await contentChangeFeed.resolve({
+			pages: toSearchSourcePages(pages),
+			search: options.search,
+			audience: "agent",
+			locale,
+			baseUrl: options.source.baseUrl ?? (context.request ? new URL(context.request.url).origin : void 0),
+			...context.request ? { request: context.request.clone() } : {}
+		})).indexGeneration;
 	}
+	const contentChangeMonitor = createDocsMcpContentChangeMonitor({
+		pollIntervalMs: contentChangePollIntervalMs,
+		readGeneration: readMonitoredGeneration,
+		notify: () => mcpHandler.notify.resourceUpdated(DOCS_MCP_CONTENT_CHANGES_CURRENT_URI),
+		isActive: () => eventBus.listenerCount > 0,
+		unrefTimer: true
+	});
 	async function handle(request) {
 		const originalUrl = new URL(request.url);
 		const method = request.method.toUpperCase();
@@ -4147,26 +4348,77 @@ function createDocsMcpHttpHandler(options) {
 			code: -32700,
 			message: "Parse error: Invalid JSON"
 		}));
-		return withCors(await (await createStatelessTransport({
+		const requestContext = {
 			transport: "http",
 			request: request.clone(),
 			auth
-		})).transport.handleRequest(request, parsedBody === void 0 ? void 0 : { parsedBody }));
+		};
+		const isContentChangeSubscription = contentChangesEnabled && method === "POST" && typeof parsedBody === "object" && parsedBody !== null && !Array.isArray(parsedBody) && parsedBody.method === "subscriptions/listen";
+		const authInfo = auth ? {
+			token: "",
+			clientId: auth.id,
+			scopes: auth.scopes ?? [],
+			principal: auth
+		} : void 0;
+		const response = await mcpHandler.fetch(request, {
+			...parsedBody === void 0 ? {} : { parsedBody },
+			...authInfo ? { authInfo } : {}
+		});
+		if (isContentChangeSubscription) await contentChangeMonitor.start(requestContext);
+		return withCors(response);
 	}
 	return {
 		GET: async ({ request }) => handle(request),
 		POST: async ({ request }) => handle(request),
 		DELETE: async ({ request }) => handle(request),
-		OPTIONS: async ({ request }) => handle(request)
+		OPTIONS: async ({ request }) => handle(request),
+		close: async () => {
+			contentChangeMonitor.close();
+			await mcpHandler.close();
+		}
 	};
 }
 async function runDocsMcpStdio(options) {
-	const server = await createDocsMcpServer({
-		...options,
-		requestContext: { transport: "stdio" }
+	const resolved = resolveDocsMcpConfig(options.mcp, {
+		defaultName: options.defaultName ?? options.source.siteTitle ?? DEFAULT_MCP_NAME,
+		defaultVersion: options.defaultVersion
+	});
+	const contentChangesEnabled = resolveDocsContentChangesConfig(options.contentChanges).enabled && resolved.tools.listContentChanges !== false;
+	const contentChangeFeed = options.contentChangeFeed ?? createDocsContentChangeFeed(options.contentChanges);
+	const configuredPollInterval = options.contentChangePollIntervalMs;
+	const pollIntervalMs = typeof configuredPollInterval === "number" && Number.isFinite(configuredPollInterval) && configuredPollInterval >= 10 ? Math.floor(configuredPollInterval) : DEFAULT_DOCS_MCP_CONTENT_CHANGE_POLL_INTERVAL_MS;
+	serveStdio(async () => {
+		const requestContext = { transport: "stdio" };
+		const server = await createDocsMcpServer({
+			...options,
+			contentChangeFeed,
+			requestContext
+		});
+		if (!contentChangesEnabled) return server;
+		const readGeneration = async () => {
+			const locale = options.source.resolveLocale?.(void 0, requestContext);
+			const pages = dedupePages(await options.source.getPages(locale, requestContext));
+			return (await contentChangeFeed.resolve({
+				pages: toSearchSourcePages(pages),
+				search: options.search,
+				audience: "agent",
+				locale,
+				baseUrl: options.source.baseUrl
+			})).indexGeneration;
+		};
+		const monitor = createDocsMcpContentChangeMonitor({
+			pollIntervalMs,
+			readGeneration: () => readGeneration(),
+			notify: () => server.server.sendResourceUpdated({ uri: DOCS_MCP_CONTENT_CHANGES_CURRENT_URI })
+		});
+		await monitor.start(requestContext);
+		const closeServer = server.close.bind(server);
+		server.close = async () => {
+			monitor.close();
+			await closeServer();
+		};
+		return server;
 	});
-	const transport = new StdioServerTransport();
-	await server.connect(transport);
 }
 async function isDocsMcpOriginAllowed(request, allowedOrigins) {
 	const origin = request.headers.get("origin");
@@ -4766,22 +5018,6 @@ function countConfigSchemaOptions(options) {
 function normalizeConfigSchemaToken(value) {
 	return value.trim().toLowerCase().replace(/^docs\.config\.?/, "").replace(/[`'"]/g, "").replace(/[_\-\s]+/g, "");
 }
-function isSelfMcpSearchEndpoint(search, route) {
-	if (!search || search === true || typeof search !== "object" || search.provider !== "mcp") return false;
-	const endpoint = search.endpoint.trim();
-	if (!endpoint.startsWith("/")) return false;
-	return normalizeDocsMcpRoute(endpoint) === normalizeDocsMcpRoute(route);
-}
-function resolveMcpToolSearchConfig(search, route) {
-	if (!isSelfMcpSearchEndpoint(search, route)) return search;
-	const config = search;
-	return {
-		provider: "simple",
-		enabled: config.enabled,
-		maxResults: config.maxResults,
-		chunking: config.chunking
-	};
-}
 function toAgentContractSummary(value) {
 	const agent = normalizePageAgentFrontmatter(value);
 	const hasContract = hasStructuredPageAgentContract(agent);
@@ -5607,4 +5843,4 @@ function toPageResourceUri(url) {
 }
 
 //#endregion
-export { DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, buildDocsMcpContext, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio };
+export { DEFAULT_DOCS_MCP_CONTENT_CHANGE_POLL_INTERVAL_MS, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, DOCS_MCP_CONTENT_CHANGES_CURRENT_URI, DOCS_MCP_CONTENT_CHANGES_URI_TEMPLATE, buildDocsMcpContext, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio };

package/dist/{prompt-references-CoDorsvS.mjs → prompt-references-CMMoF6AY.mjs}

@@ -1,7 +1,7 @@
-import { At as DEFAULT_SITEMAP_XML_ROUTE, Ot as DEFAULT_SITEMAP_MD_ROUTE, Vn as DEFAULT_MCP_WELL_KNOWN_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-Ba94vwM2.mjs";
+import { At as DEFAULT_SITEMAP_XML_ROUTE, Ot as DEFAULT_SITEMAP_MD_ROUTE, Un as DEFAULT_MCP_WELL_KNOWN_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-Cj50nyeV.mjs";
 import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
 import { C as DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, S as DOCS_AGENT_MANIFEST_FORMAT, T as DOCS_AGENT_MANIFEST_VERSION, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, w as DOCS_AGENT_MANIFEST_SCHEMA_URI } from "./standards-discovery-BKlEnK_H.mjs";
-import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-C_v2HK43.mjs";
+import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-BukukxNm.mjs";
 import matter from "gray-matter";
 
 //#region src/define-docs.ts