@jshookmcp/jshook 0.2.7 → 0.2.9

package/dist/index.mjs

@@ -1,22 +1,31 @@
 #!/usr/bin/env node
-import { t as logger } from "./logger-BmWzC2lM.mjs";
-import { $t as SEARCH_BM25_K1, A as COMPOUND_EVENT_WINDOW_MS, At as PREDICTIVE_MAX_HISTORY, Cn as SEARCH_VECTOR_LEARN_TOP_N, Dn as SHUTDOWN_TIMEOUT_MS, En as SEARCH_WORKFLOW_DOMAIN_BOOST_MULTIPLIER, Ft as RUNTIME_ERROR_WINDOW_MS, Ot as PREDICTIVE_CONFIDENCE_THRESHOLD, Pt as RUNTIME_ERROR_THRESHOLD, Qt as SEARCH_BM25_B, Sn as SEARCH_VECTOR_LEARN_DOWN, Xt as SEARCH_AFFINITY_BOOST_FACTOR, Yt as SEARCH_AFFINITY_BASE_WEIGHT, Zt as SEARCH_AFFINITY_TOP_N, _n as SEARCH_TRIGRAM_THRESHOLD, a as ACTIVATION_TTL_MINUTES, an as SEARCH_PARAM_TOKEN_WEIGHT, cn as SEARCH_RECENCY_MAX_BOOST, dn as SEARCH_RRF_BM25_BLEND, en as SEARCH_CACHE_VECTOR_WEIGHT_TOLERANCE, fn as SEARCH_RRF_K, gn as SEARCH_TIER_PENALTY, gt as MCP_HTTP_REQUEST_TIMEOUT_MS, h as AUTOPRUNE_MANUAL_INACTIVITY_MS, hn as SEARCH_TFIDF_COSINE_WEIGHT, ht as MCP_HTTP_KEEPALIVE_TIMEOUT_MS, i as ACTIVATION_EVENT_HISTORY_MAX, in as SEARCH_EXACT_NAME_MATCH_MULTIPLIER, j as COMPOUND_LONG_WINDOW_MS, jt as PREDICTIVE_MAX_SECOND_ORDER_KEYS, kt as PREDICTIVE_DECAY_FACTOR, ln as SEARCH_RECENCY_TRACKER_MAX, m as AUTOPRUNE_CHECK_INTERVAL_MS, mn as SEARCH_SYNONYM_EXPANSION_LIMIT, mt as MCP_HTTP_HEADERS_TIMEOUT_MS, n as ACTIVATION_COMPOUND_EVAL_EVERY, nn as SEARCH_DOMAIN_HUB_BOOST_MULTIPLIER, on as SEARCH_PREFIX_MATCH_MULTIPLIER, ot as HTTP_CLEANUP_INTERVAL_MS, p as AUTOPRUNE_AUTO_INACTIVITY_MS, pn as SEARCH_RRF_RESCALE_FACTOR, pt as MCP_HTTP_FORCE_CLOSE_TIMEOUT_MS, r as ACTIVATION_COOLDOWN_MS, rn as SEARCH_DOMAIN_HUB_THRESHOLD, sn as SEARCH_QUERY_CACHE_CAPACITY, st as HTTP_RATE_LIMIT_MAX_IPS, t as ACTIVATION_BOOST_WINDOW_MS, tn as SEARCH_COVERAGE_PRECISION_FACTOR, un as SEARCH_RECENCY_WINDOW_MS, vn as SEARCH_TRIGRAM_WEIGHT, wn as SEARCH_VECTOR_LEARN_UP, xn as SEARCH_VECTOR_ENABLED, yn as SEARCH_VECTOR_COSINE_WEIGHT } from "./constants-CCvsN80K.mjs";
-import { A as validateToolNameArray, B as asTextResponse, C as getAvailableToolNames, D as getToolInputSchema, E as getToolDomainFromContext, F as createServerEventBus, H as UnifiedCacheManager, I as getInjectionInstructions, L as generateAntiDebugBypass, M as isBrowserOrNetworkTask, N as isMaintenanceTask, O as isToolActive, P as matchWorkflowRoute, R as ToolError, S as rerankResultsForContext, T as getToolDescription, U as TokenBudgetManager, V as DetailedDataManager, _ as buildPresetRecommendations, a as getToolsForProfile, b as buildWorkflowToolSequence, c as getAllDomains, d as initRegistry, h as startArtifactRetentionScheduler, i as getToolsByDomains, j as detectWorkflowIntent, k as normalizeToolName, l as getAllManifests, m as getArtifactRetentionConfig, n as getProfileDomains, o as parseToolDomains, p as cleanupArtifacts, r as getToolDomain, s as buildHandlerMapFromRegistry, t as allTools, u as getAllRegistrations, v as buildRouteMatchMetadata, w as getRoutingState, x as getEffectivePrerequisites, y as buildWorkflowRouteRecommendation, z as asErrorResponse } from "./ToolCatalog-CnwmMIw3.mjs";
-import { f as getConfig, h as DEFAULT_SEARCH_CONFIG, m as validateConfig } from "./artifacts-BbdOMET5.mjs";
-import { n as listExtensions, r as reloadExtensions, t as ensureWorkflowsLoaded } from "./ExtensionManager-CZ6IveoV.mjs";
+import { t as logger } from "./logger-Dh_xb7_2.mjs";
+import { $n as SEARCH_WORKFLOW_DOMAIN_BOOST_MULTIPLIER, $t as PREDICTIVE_DECAY_FACTOR, A as COMPOUND_EVENT_WINDOW_MS, An as SEARCH_PREFIX_MATCH_MULTIPLIER, Bn as SEARCH_TIER_PENALTY_FULL, Cn as SEARCH_BM25_K1, Ct as MCP_HTTP_REQUEST_TIMEOUT_MS, Dn as SEARCH_DOMAIN_HUB_THRESHOLD, En as SEARCH_DOMAIN_HUB_BOOST_MULTIPLIER, Fn as SEARCH_RRF_BM25_BLEND, Gn as SEARCH_VECTOR_BM25_SKIP_THRESHOLD, Hn as SEARCH_TIER_PENALTY_WORKFLOW, In as SEARCH_RRF_K, Jn as SEARCH_VECTOR_ENABLED, Kn as SEARCH_VECTOR_COSINE_WEIGHT, Ln as SEARCH_RRF_RESCALE_FACTOR, Mn as SEARCH_RECENCY_MAX_BOOST, Nn as SEARCH_RECENCY_TRACKER_MAX, On as SEARCH_EXACT_NAME_MATCH_MULTIPLIER, Pn as SEARCH_RECENCY_WINDOW_MS, Qt as PREDICTIVE_CONFIDENCE_THRESHOLD, Rn as SEARCH_SYNONYM_EXPANSION_LIMIT, Sn as SEARCH_BM25_B, St as MCP_HTTP_KEEPALIVE_TIMEOUT_MS, Tn as SEARCH_COVERAGE_PRECISION_FACTOR, Un as SEARCH_TRIGRAM_THRESHOLD, Vn as SEARCH_TIER_PENALTY_SEARCH, Wn as SEARCH_TRIGRAM_WEIGHT, Xn as SEARCH_VECTOR_LEARN_TOP_N, Yn as SEARCH_VECTOR_LEARN_DOWN, Zn as SEARCH_VECTOR_LEARN_UP, a as ACTIVATION_TTL_MINUTES, an as RUNTIME_ERROR_WINDOW_MS, bn as SEARCH_AFFINITY_BOOST_FACTOR, bt as MCP_HTTP_FORCE_CLOSE_TIMEOUT_MS, en as PREDICTIVE_MAX_HISTORY, er as SHUTDOWN_TIMEOUT_MS, h as AUTOPRUNE_MANUAL_INACTIVITY_MS, i as ACTIVATION_EVENT_HISTORY_MAX, in as RUNTIME_ERROR_THRESHOLD, j as COMPOUND_LONG_WINDOW_MS, jn as SEARCH_QUERY_CACHE_CAPACITY, kn as SEARCH_PARAM_TOKEN_WEIGHT, lt as HTTP_CLEANUP_INTERVAL_MS, m as AUTOPRUNE_CHECK_INTERVAL_MS, n as ACTIVATION_COMPOUND_EVAL_EVERY, p as AUTOPRUNE_AUTO_INACTIVITY_MS, r as ACTIVATION_COOLDOWN_MS, t as ACTIVATION_BOOST_WINDOW_MS, tn as PREDICTIVE_MAX_SECOND_ORDER_KEYS, ut as HTTP_RATE_LIMIT_MAX_IPS, wn as SEARCH_CACHE_VECTOR_WEIGHT_TOLERANCE, xn as SEARCH_AFFINITY_TOP_N, xt as MCP_HTTP_HEADERS_TIMEOUT_MS, yn as SEARCH_AFFINITY_BASE_WEIGHT, yt as MCP_COMPACT_SCHEMA, zn as SEARCH_TIER_PENALTY } from "./constants-B0OANIBL.mjs";
+import { a as TokenBudgetManager, i as UnifiedCacheManager, n as getArtifactRetentionConfig, r as startArtifactRetentionScheduler, t as cleanupArtifacts } from "./artifactRetention-CFEprwPw.mjs";
+import { t as DetailedDataManager } from "./DetailedDataManager-BQQcxh64.mjs";
+import { r as asTextResponse, t as asErrorResponse } from "./response-BQVP-xUn.mjs";
+import { a as getToolsForProfile, c as ensureAllDomainsLoaded, d as getAllKnownDomains, f as getAllManifests, h as getLoaderMetadata, i as getToolsByDomains, l as ensureDomainLoaded, m as initRegistry, n as getProfileDomains, o as parseToolDomains, p as getAllRegistrations, r as getToolDomain, s as buildHandlerMapFromRegistry, t as allTools, u as getAllDomains } from "./ToolCatalog-C0JGZoOm.mjs";
+import { t as ToolError } from "./ToolError-jh9whhMd.mjs";
+import { i as generateAntiDebugBypass, l as ProcessRegistry, r as getInjectionInstructions } from "./HookGeneratorBuilders.core.generators.storage-CtcdK78Q.mjs";
+import { c as getConfig, d as DEFAULT_SEARCH_CONFIG, u as validateConfig } from "./outputPaths-B1uGmrWZ.mjs";
+import { i as reloadExtensions, n as ensureWorkflowsLoaded, r as listExtensions } from "./ExtensionManager-CWYgw0YW.mjs";
+import { _ as isMaintenanceTask, a as getEffectivePrerequisites, c as getRoutingState, d as getToolInputSchema, f as isToolActive, g as isBrowserOrNetworkTask, h as detectWorkflowIntent, i as buildWorkflowToolSequence, l as getToolDescription, m as validateToolNameArray, n as buildRouteMatchMetadata, o as rerankResultsForContext, p as normalizeToolName, r as buildWorkflowRouteRecommendation, s as getAvailableToolNames, t as buildPresetRecommendations, u as getToolDomainFromContext, v as matchWorkflowRoute } from "./ToolRouter.policy-BWV67ZK-.mjs";
+import { n as createServerEventBus } from "./EventBus-DgPmwpeu.mjs";
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { CompleteRequestSchema, ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
 import { promises } from "fs";
 import { join } from "path";
 import { createHash } from "crypto";
-import { fileURLToPath } from "node:url";
-import { ZodError, z } from "zod";
-import { randomUUID, timingSafeEqual } from "node:crypto";
-import { readFileSync as readFileSync$1 } from "node:fs";
 import { createServer } from "node:http";
+import { randomUUID, timingSafeEqual } from "node:crypto";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { Worker } from "worker_threads";
+import { ZodError, z } from "zod";
+import { readFileSync as readFileSync$1 } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 //#region src/utils/cache.ts
 var CacheManager = class {
 	config;
@@ -404,7 +413,7 @@ var ToolCallContextGuard = class {
 		if (!this.isContextSensitive(toolName)) return response;
 		if (response.isError) return response;
 		const provider = this.getProvider();
-		if (!provider) return response;
+		if (!provider || typeof provider.getContextMeta !== "function") return response;
 		const meta = provider.getContextMeta();
 		if (!meta.pageId && meta.tabIndex === null) return response;
 		const content = response.content;
@@ -1024,6 +1033,16 @@ async function closeServer(ctx) {
 	if (ctx.shutdownStarted) return ctx.shutdownPromise ?? Promise.resolve();
 	ctx.shutdownStarted = true;
 	ctx.shutdownPromise = (async () => {
+		const getInst = typeof ctx.getDomainInstance === "function" ? ctx.getDomainInstance.bind(ctx) : null;
+		if (getInst) {
+			const scheduler = getInst("snapshotScheduler");
+			if (scheduler) try {
+				await scheduler.flushAll();
+				scheduler.dispose();
+			} catch (error) {
+				logger.warn("snapshot flush on shutdown failed:", error);
+			}
+		}
 		for (const [, entry] of ctx.domainTtlEntries) clearTimeout(entry.timer);
 		ctx.domainTtlEntries.clear();
 		ctx.detailedData.shutdown();
@@ -1097,6 +1116,11 @@ async function closeServer(ctx) {
 		} catch (error) {
 			logger.warn("MCP server close failed:", error);
 		}
+		try {
+			await ProcessRegistry.terminateAll();
+		} catch (error) {
+			logger.warn("ProcessRegistry cleanup failed:", error);
+		}
 		logger.success("MCP server closed");
 	})();
 	return ctx.shutdownPromise;
@@ -1757,7 +1781,10 @@ var EmbeddingEngine = class {
 	}
 	ensureWorker() {
 		if (this.worker) return;
-		this.worker = new Worker(new URL("./EmbeddingWorker.js", import.meta.url));
+		const workerPath = new URL("./EmbeddingWorker.js", import.meta.url);
+		this.worker = new Worker(workerPath);
+		if (typeof this.worker.unref === "function") this.worker.unref();
+		ProcessRegistry.register(this.worker);
 		this.worker.on("message", (msg) => {
 			const req = this.pending.get(msg.id);
 			if (!req) return;
@@ -1865,7 +1892,7 @@ var TrigramIndex = class TrigramIndex {
 	* @param threshold  Minimum Jaccard similarity to include in results (default 0.3).
 	* @returns Map from document index to similarity score (0–1).
 	*/
-	search(query, threshold = .3) {
+	search(query, threshold = SEARCH_TRIGRAM_THRESHOLD) {
 		const queryTrigrams = TrigramIndex.extractTrigrams(query);
 		if (queryTrigrams.size === 0) return /* @__PURE__ */ new Map();
 		const results = /* @__PURE__ */ new Map();
@@ -2022,6 +2049,13 @@ const PARAM_DESCRIPTION_STOP_WORDS = new Set([
 * and tool metadata for indexing.
 */
 const QueryNormalizer = {
+	/**
+	* Extract parameter names and description tokens from a tool's inputSchema.
+	* Handles both simple flat properties and nested object properties.
+	*
+	* @param inputSchema The tool's inputSchema object
+	* @returns Array of normalized tokens from parameter names and descriptions
+	*/
 	extractParamTokens(inputSchema) {
 		const tokens = [];
 		if (!inputSchema || typeof inputSchema !== "object") return tokens;
@@ -2043,6 +2077,13 @@ const QueryNormalizer = {
 		}
 		return tokens;
 	},
+	/**
+	* Extract a short description from a full tool description.
+	* Takes the first sentence and truncates to 120 characters if needed.
+	*
+	* @param description The full tool description
+	* @returns A shortened description suitable for display
+	*/
 	extractShortDescription(description) {
 		if (!description) return "";
 		const firstSentence = description.match(/^[^.!?\n]+[.!?]?/);
@@ -2052,9 +2093,21 @@ const QueryNormalizer = {
 		}
 		return description.length > 120 ? description.slice(0, 117) + "..." : description;
 	},
+	/**
+	* Check if a query contains CJK (Chinese, Japanese, Korean) characters.
+	*
+	* @param query The search query
+	* @returns true if the query contains CJK characters
+	*/
 	containsCJK(query) {
 		return /[\u4e00-\u9fff\u3040-\u309f\u30a0-\u30ff\uac00-\ud7af]/.test(query);
 	},
+	/**
+	* Normalize a tool name for comparison (lowercase, underscores to hyphens/spaces).
+	*
+	* @param query The search query
+	* @returns Normalized query string
+	*/
 	normalizeToolName(query) {
 		return query.toLowerCase().replace(/[\s-]+/g, "_");
 	}
@@ -2065,10 +2118,10 @@ const QueryNormalizer = {
 * Hybrid BM25 + RRF multi-signal tool search engine for progressive tool discovery.
 *
 * Enhancements:
-* - BM25 keyword scoring with synonym-expanded queries
-* - TF-IDF cosine similarity as an independent RRF signal
+* - BM25 keyword scoring with synonym-expanded queries and field weights
 * - Trigram fuzzy matching for typo tolerance
 * - RRF (Reciprocal Rank Fusion) combining all signals
+* - Dense vector similarity (384-dim embeddings) as semantic signal
 * - Tool affinity graph with prefix-group expansion (§4.1.4 dependency hull)
 * - Query category adaptive domain weights (§4.1.3 task-type encoding)
 * - Parameter name indexing for schema-aware search
@@ -2127,8 +2180,6 @@ var ToolSearchEngine = class {
 	domainOverrides;
 	domainScoreMultipliers;
 	toolScoreMultipliers;
-	/** IDF values per term, used for TF-IDF cosine computation. */
-	idfMap;
 	/** Name → doc index for O(1) lookup during affinity expansion. */
 	docNameIndex = /* @__PURE__ */ new Map();
 	/** Prefix-group affinity graph: docIndex → neighbor edges. */
@@ -2157,7 +2208,8 @@ var ToolSearchEngine = class {
 		this.toolScoreMultipliers = toolScoreMultipliers;
 		this.docCount = source.length;
 		this.bm25Scorer = new BM25ScorerImpl(searchConfig);
-		this.embeddingEngine = searchConfig?.vectorEnabled ?? SEARCH_VECTOR_ENABLED ? new EmbeddingEngine() : null;
+		const vectorEnabled = searchConfig?.vectorEnabled ?? SEARCH_VECTOR_ENABLED;
+		this.embeddingEngine = vectorEnabled ? new EmbeddingEngine() : null;
 		this.feedbackTracker = new FeedbackTracker(searchConfig);
 		this.intentBoost = new IntentBoostImpl(searchConfig?.intentToolBoostRules);
 		let totalLength = 0;
@@ -2186,9 +2238,7 @@ var ToolSearchEngine = class {
 				length: allTokens.length,
 				nameTokens,
 				nameTokenSet,
-				nameTokenCount: nameTokenSet.size,
-				tfidfWeights: /* @__PURE__ */ new Map(),
-				tfidfMagnitude: 0
+				nameTokenCount: nameTokenSet.size
 			};
 			this.docs.push(doc);
 			this.docNameIndex.set(tool.name, i);
@@ -2245,31 +2295,30 @@ var ToolSearchEngine = class {
 		}
 		this.avgDocLength = this.docCount > 0 ? totalLength / this.docCount : 1;
 		this.sortedKeys = [...this.invertedIndex.keys()].toSorted();
-		const idfMap = /* @__PURE__ */ new Map();
-		for (const [term, postings] of this.invertedIndex) idfMap.set(term, Math.log(1 + this.docCount / postings.length));
-		this.idfMap = idfMap;
-		for (let i = 0; i < this.docCount; i++) {
-			const doc = this.docs[i];
-			const rawTf = /* @__PURE__ */ new Map();
-			for (const token of doc.tokens) rawTf.set(token, (rawTf.get(token) ?? 0) + 1);
-			const tfidfWeights = /* @__PURE__ */ new Map();
-			let magnitudeSq = 0;
-			for (const [term, tf] of rawTf) {
-				const idf = idfMap.get(term) ?? 0;
-				const w = (1 + Math.log(tf)) * idf;
-				tfidfWeights.set(term, w);
-				magnitudeSq += w * w;
-			}
-			doc.tfidfWeights = tfidfWeights;
-			doc.tfidfMagnitude = Math.sqrt(magnitudeSq);
-		}
 		this.affinityGraph = this.buildAffinityGraph();
 		this.trigramIndex = new TrigramIndex(this.docs.map((d) => d.name));
 		this.queryCache = new LRUCache(SEARCH_QUERY_CACHE_CAPACITY);
 	}
-	async search(query, topK = 10, activeToolNames, visibleDomains) {
-		const queryTokens = this.bm25Scorer.tokenise(query, { expandSynonyms: true });
+	async search(query, topK = 10, activeToolNames, visibleDomains, profile) {
+		let queryTokens = this.bm25Scorer.tokenise(query);
 		if (queryTokens.length === 0) return [];
+		if (queryTokens.length > 6) {
+			const inVocab = queryTokens.filter((t) => this.invertedIndex.has(t));
+			if (inVocab.length >= 3) {
+				const scored = inVocab.map((t) => {
+					const df = this.invertedIndex.get(t).length;
+					return {
+						token: t,
+						idf: Math.log((this.docCount - df + .5) / (df + .5) + 1)
+					};
+				});
+				scored.sort((a, b) => b.idf - a.idf);
+				const kept = new Set(scored.slice(0, 6).map((s) => s.token));
+				queryTokens = queryTokens.filter((t) => kept.has(t));
+			}
+		}
+		const synonymTokens = this.bm25Scorer.tokenise(queryTokens.join(" "), { expandSynonyms: true }).filter((t) => !queryTokens.includes(t));
+		queryTokens.push(...synonymTokens);
 		const explicitToolMention = (() => {
 			const lower = query.toLowerCase();
 			if (!/(?:\b(?:call|use|run|invoke|execute)\b|调用|执行|使用|运行)/i.test(lower)) return null;
@@ -2340,11 +2389,10 @@ var ToolSearchEngine = class {
 			const toolMultiplier = this.toolScoreMultipliers?.get(doc.name) ?? 1;
 			if (toolMultiplier !== 1) scores[i] *= toolMultiplier;
 		}
-		this.applyAffinityExpansion(scores);
-		this.applyDomainHubExpansion(scores);
+		this.applyGraphExpansion(scores);
 		this.applyIntentBonusBand(scores, intentToolBonuses);
 		this.applyRecencyBoost(scores);
-		this.applyTierPenalty(scores, visibleDomains);
+		this.applyTierPenalty(scores, visibleDomains, profile);
 		if (explicitToolMention) {
 			const explicitIdx = this.docNameIndex.get(explicitToolMention);
 			if (explicitIdx !== void 0) {
@@ -2414,9 +2462,9 @@ var ToolSearchEngine = class {
 	* tier. The penalty is a soft multiplier in [0, 1]; 1 disables the feature.
 	* Tools without a resolved domain are left untouched.
 	*/
-	applyTierPenalty(scores, visibleDomains) {
+	applyTierPenalty(scores, visibleDomains, profile) {
 		if (!visibleDomains || visibleDomains.size === 0) return;
-		const penalty = SEARCH_TIER_PENALTY;
+		const penalty = profile ? profile === "full" ? SEARCH_TIER_PENALTY_FULL : profile === "workflow" ? SEARCH_TIER_PENALTY_WORKFLOW : SEARCH_TIER_PENALTY_SEARCH : SEARCH_TIER_PENALTY;
 		if (penalty >= 1 || penalty <= 0) return;
 		for (let i = 0; i < this.docCount; i++) {
 			if (scores[i] <= 0) continue;
@@ -2489,28 +2537,34 @@ var ToolSearchEngine = class {
 	* independently contribute — a document with BM25=0 but high trigram
 	* similarity can still surface.
 	*/
-	async applyRRFFusion(queryTokens, query, scores) {
+	async applyRRFFusion(_queryTokens, query, scores) {
 		const k = SEARCH_RRF_K;
 		const trigramWeight = SEARCH_TRIGRAM_WEIGHT;
-		const tfidfWeight = SEARCH_TFIDF_COSINE_WEIGHT;
 		const bm25Ranked = this.rankByScores(scores);
-		const cosineScores = this.computeTfidfCosineScores(queryTokens);
-		const cosineRanked = this.rankByMap(cosineScores);
 		const trigramScores = this.trigramIndex.search(query, SEARCH_TRIGRAM_THRESHOLD);
 		const trigramRanked = this.rankByMap(trigramScores);
-		const vectorScores = await this.computeVectorCosineScores(query);
-		const vectorRanked = this.rankByMap(vectorScores);
-		if (vectorRanked.size > 0) {
-			const ranking = /* @__PURE__ */ new Map();
-			for (const [docIdx, rank] of vectorRanked) ranking.set(this.docs[docIdx].name, rank);
-			this.feedbackTracker.recordVectorRanking(ranking);
+		let vectorScores;
+		let vectorRanked;
+		if (SEARCH_VECTOR_BM25_SKIP_THRESHOLD > 0 && bm25Ranked.size > 0) {
+			const topBm25Idx = [...bm25Ranked.entries()].find(([, r]) => r === 0)?.[0];
+			if ((topBm25Idx !== void 0 ? scores[topBm25Idx] : 0) >= SEARCH_VECTOR_BM25_SKIP_THRESHOLD) {
+				vectorScores = /* @__PURE__ */ new Map();
+				vectorRanked = /* @__PURE__ */ new Map();
+			} else {
+				vectorScores = await this.computeVectorCosineScores(query);
+				vectorRanked = this.rankByMap(vectorScores);
+			}
+		} else {
+			vectorScores = await this.computeVectorCosineScores(query);
+			vectorRanked = this.rankByMap(vectorScores);
 		}
+		const ranking = /* @__PURE__ */ new Map();
+		for (const [docIdx, rank] of vectorRanked) ranking.set(this.docs[docIdx].name, rank);
+		this.feedbackTracker.recordVectorRanking(ranking);
 		for (let i = 0; i < this.docCount; i++) {
 			let rrfScore = 0;
 			const bm25Rank = bm25Ranked.get(i);
 			if (bm25Rank !== void 0) rrfScore += 1 / (k + bm25Rank);
-			const cosineRank = cosineRanked.get(i);
-			if (cosineRank !== void 0 && tfidfWeight > 0) rrfScore += tfidfWeight * (1 / (k + cosineRank));
 			const trigramRank = trigramRanked.get(i);
 			if (trigramRank !== void 0 && trigramWeight > 0) rrfScore += trigramWeight * (1 / (k + trigramRank));
 			const vectorRank = vectorRanked.get(i);
@@ -2524,38 +2578,6 @@ var ToolSearchEngine = class {
 		}
 	}
 	/**
-	* Compute raw TF-IDF cosine similarity scores for each document.
-	* Returns Map<docIndex, cosineScore>.
-	*/
-	computeTfidfCosineScores(queryTokens) {
-		const queryTf = /* @__PURE__ */ new Map();
-		for (const token of queryTokens) queryTf.set(token, (queryTf.get(token) ?? 0) + 1);
-		const queryWeights = /* @__PURE__ */ new Map();
-		let queryMagSq = 0;
-		for (const [term, tf] of queryTf) {
-			const idf = this.idfMap.get(term) ?? 0;
-			if (idf === 0) continue;
-			const w = (1 + Math.log(tf)) * idf;
-			queryWeights.set(term, w);
-			queryMagSq += w * w;
-		}
-		if (queryMagSq === 0) return /* @__PURE__ */ new Map();
-		const queryMagnitude = Math.sqrt(queryMagSq);
-		const results = /* @__PURE__ */ new Map();
-		for (let i = 0; i < this.docCount; i++) {
-			const doc = this.docs[i];
-			if (doc.tfidfMagnitude === 0) continue;
-			let dot = 0;
-			for (const [term, qw] of queryWeights) {
-				const dw = doc.tfidfWeights.get(term);
-				if (dw !== void 0) dot += qw * dw;
-			}
-			if (dot <= 0) continue;
-			results.set(i, dot / (queryMagnitude * doc.tfidfMagnitude));
-		}
-		return results;
-	}
-	/**
 	* Rank documents by Float64Array scores.
 	* Returns Map<docIndex, rank> (0-based, lower = better).
 	*/
@@ -2697,51 +2719,41 @@ var ToolSearchEngine = class {
 		return graph;
 	}
 	/**
-	* Boost affinity neighbors of top results (§4.1.4).
-	* For each of the top-N scored documents, add a fraction of its score
-	* to its prefix-group neighbors, encouraging co-retrieval.
+	* Combined graph-based expansion: affinity (prefix-group co-retrieval) +
+	* domain hub (coherence boost for well-represented domains).
+	* Single sort of scored documents feeds both expansion strategies.
 	*/
-	applyAffinityExpansion(scores) {
-		if (this.affinityGraph.size === 0) return;
-		const topN = SEARCH_AFFINITY_TOP_N;
+	applyGraphExpansion(scores) {
 		const scored = [];
 		for (let i = 0; i < this.docCount; i++) if (scores[i] > 0) scored.push({
 			idx: i,
 			score: scores[i]
 		});
+		if (scored.length === 0) return;
 		scored.sort((a, b) => b.score - a.score);
-		const boostFactor = SEARCH_AFFINITY_BOOST_FACTOR;
-		const limit = Math.min(topN, scored.length);
-		for (let rank = 0; rank < limit; rank++) {
-			const { idx, score } = scored[rank];
-			const neighbors = this.affinityGraph.get(idx);
-			if (!neighbors) continue;
-			const rankDecay = 1 / (1 + rank);
-			for (const { docIndex, weight } of neighbors) if (scores[docIndex] > 0) scores[docIndex] += score * weight * rankDecay * boostFactor;
+		if (this.affinityGraph.size > 0) {
+			const topN = SEARCH_AFFINITY_TOP_N;
+			const boostFactor = SEARCH_AFFINITY_BOOST_FACTOR;
+			const limit = Math.min(topN, scored.length);
+			for (let rank = 0; rank < limit; rank++) {
+				const { idx, score } = scored[rank];
+				const neighbors = this.affinityGraph.get(idx);
+				if (!neighbors) continue;
+				const rankDecay = 1 / (1 + rank);
+				for (const { docIndex, weight } of neighbors) if (scores[docIndex] > 0) scores[docIndex] += score * weight * rankDecay * boostFactor;
+			}
 		}
-	}
-	/**
-	* Domain hub expansion (§4.1.4): when a domain is heavily represented
-	* in top results, slightly boost remaining tools from that domain.
-	*/
-	applyDomainHubExpansion(scores) {
 		const threshold = SEARCH_DOMAIN_HUB_THRESHOLD;
-		if (threshold <= 0) return;
-		const scored = [];
-		for (let i = 0; i < this.docCount; i++) if (scores[i] > 0) scored.push({
-			idx: i,
-			score: scores[i]
-		});
-		if (scored.length < threshold) return;
-		scored.sort((a, b) => b.score - a.score);
-		const top10 = scored.slice(0, 10);
-		const domainCounts = /* @__PURE__ */ new Map();
-		for (const { idx } of top10) {
-			const domain = this.docs[idx].domain;
-			if (domain) domainCounts.set(domain, (domainCounts.get(domain) ?? 0) + 1);
-		}
-		for (const [domain, count] of domainCounts) if (count >= threshold) {
-			for (let i = 0; i < this.docCount; i++) if (scores[i] > 0 && this.docs[i].domain === domain) scores[i] *= SEARCH_DOMAIN_HUB_BOOST_MULTIPLIER;
+		if (threshold > 0 && scored.length >= threshold) {
+			const top10 = scored.slice(0, 10);
+			const domainCounts = /* @__PURE__ */ new Map();
+			for (const { idx } of top10) {
+				const domain = this.docs[idx].domain;
+				if (domain) domainCounts.set(domain, (domainCounts.get(domain) ?? 0) + 1);
+			}
+			for (const [domain, count] of domainCounts) if (count >= threshold) {
+				for (let i = 0; i < this.docCount; i++) if (scores[i] > 0 && this.docs[i].domain === domain) scores[i] *= SEARCH_DOMAIN_HUB_BOOST_MULTIPLIER;
+			}
 		}
 	}
 };
@@ -2781,18 +2793,22 @@ function getVisibleDomainsForTier(ctx) {
 	}
 	return visible;
 }
+function getBaseTier(ctx) {
+	return ctx.baseTier;
+}
 function getExtensionDomainMap(ctx) {
 	const map = /* @__PURE__ */ new Map();
 	for (const record of ctx.extensionToolsByName.values()) map.set(record.name, record.domain);
 	return map;
 }
-function getCombinedTools(ctx) {
+async function getCombinedTools(ctx) {
+	await ensureAllDomainsLoaded();
 	const tools = new Map(allTools.map((tool) => [tool.name, tool]));
 	for (const record of ctx.extensionToolsByName.values()) tools.set(record.name, record.tool);
 	return [...tools.values()];
 }
-function getToolByName(ctx) {
-	return new Map(getCombinedTools(ctx).map((tool) => [tool.name, tool]));
+async function getToolByName(ctx) {
+	return new Map((await getCombinedTools(ctx)).map((tool) => [tool.name, tool]));
 }
 const searchEngineCache = /* @__PURE__ */ new WeakMap();
 /**
@@ -2805,11 +2821,12 @@ function buildSearchSignature(ctx) {
 	extParts.sort();
 	return [ctx.extensionWorkflowRuntimeById.size, extParts.join("|")].join("::");
 }
-function getSearchEngine(ctx) {
+async function getSearchEngine(ctx) {
+	await ensureAllDomainsLoaded();
 	const signature = buildSearchSignature(ctx);
 	const cached = searchEngineCache.get(ctx);
 	if (cached?.signature === signature) return cached.engine;
-	const tools = getCombinedTools(ctx);
+	const tools = await getCombinedTools(ctx);
 	const extensionDomains = getExtensionDomainMap(ctx);
 	const domainScoreMultipliers = /* @__PURE__ */ new Map();
 	const toolScoreMultipliers = /* @__PURE__ */ new Map();
@@ -2826,14 +2843,14 @@ function getSearchEngine(ctx) {
 	});
 	return engine;
 }
-/** Generate domain summary description from discovered manifests. */
+/** Generate domain summary description. Uses metadata when not all domains are loaded. */
 function buildDomainDescription(ctx) {
 	const groups = {};
 	for (const r of getAllRegistrations()) groups[r.domain] = (groups[r.domain] ?? 0) + 1;
 	for (const record of ctx.extensionToolsByName.values()) groups[record.domain] = (groups[record.domain] ?? 0) + 1;
-	const totalTools = getAllRegistrations().length + ctx.extensionToolsByName.size;
-	const parts = Object.entries(groups).toSorted((a, b) => b[1] - a[1]).map(([domain, count]) => `${domain} (${count})`).join(" | ");
-	return `Search ${totalTools} tools across ${Object.keys(groups).length} capability domains. This includes built-in tools plus any loaded plugin/workflow tools (${ctx.extensionToolsByName.size} currently loaded). In search-tier sessions, call this before assuming a capability is unavailable. Use activate_tools for exact matches, activate_domain for an entire domain. Domains: ${parts}.`;
+	const loadedCount = getAllRegistrations().length;
+	const extensionCount = ctx.extensionToolsByName.size;
+	return `Search ${loadedCount + extensionCount} tools across ${Object.keys(groups).length} capability domains. This includes built-in tools plus any loaded plugin/workflow tools (${extensionCount} currently loaded). In search-tier sessions, call this before assuming a capability is unavailable. Use activate_tools for exact matches, activate_domain for an entire domain. Domains: ${Object.entries(groups).toSorted((a, b) => b[1] - a[1]).map(([domain, count]) => `${domain} (${count})`).join(" | ")}. Query tip: before searching, distill your intent into key concepts (action verb + target + domain). Pass distilled keywords, not full sentences — the search engine works on token matching, not semantic understanding.`;
 }
 //#endregion
 //#region src/server/MCPServer.search.handlers.domain.ts
@@ -2846,12 +2863,13 @@ async function handleActivateDomain(ctx, args) {
 		success: false,
 		error: "domain must be a non-empty string"
 	}));
-	const validDomains = new Set(getAllDomains());
+	const validDomains = new Set(getAllKnownDomains());
 	for (const record of ctx.extensionToolsByName.values()) validDomains.add(record.domain);
 	if (!validDomains.has(domain)) return asTextResponse(JSON.stringify({
 		success: false,
 		error: `Unknown domain "${domain}". Valid: ${[...validDomains].join(", ")}`
 	}));
+	await ensureDomainLoaded(domain);
 	const ttlMinutes = typeof args.ttlMinutes === "number" ? args.ttlMinutes : ACTIVATION_TTL_MINUTES;
 	const domainTools = [...getToolsByDomains([domain]), ...[...ctx.extensionToolsByName.values()].filter((record) => record.domain === domain).map((record) => record.tool)];
 	const activeNames = getActiveToolNames(ctx);
@@ -3409,7 +3427,8 @@ var ActivationController = class {
 		this.boostRules = [...DEFAULT_BOOST_RULES, ...customRules].toSorted((a, b) => b.priority - a.priority);
 		this.compoundEngine = new CompoundConditionEngine();
 		this.predictiveBooster = new PredictiveBooster();
-		this.autoPruner = new AutoPruner(eventBus, new Set(getProfileDomains(ctx.baseTier)), (domain) => {
+		const baseDomains = new Set(getProfileDomains(ctx.baseTier));
+		this.autoPruner = new AutoPruner(eventBus, baseDomains, (domain) => {
 			logger.info(`[ActivationController] Auto-pruning domain "${domain}"`);
 		});
 		this.subscribe();
@@ -3641,10 +3660,27 @@ function handleToolError(toolName, error) {
 	logger.error(`Tool execution failed: ${toolName}`, error);
 	throw new McpError(ErrorCode.InternalError, `Execution Failed in ${toolName}: ${error instanceof Error ? error.message : String(error)}`);
 }
+function stripParamDescriptions(schema) {
+	const clone = { ...schema };
+	if (clone.properties) {
+		const props = {};
+		for (const [key, val] of Object.entries(clone.properties)) {
+			const { description: _d, ...rest } = val;
+			props[key] = stripParamDescriptions(rest);
+		}
+		clone.properties = props;
+	}
+	if (clone.items && typeof clone.items === "object") {
+		const { description: _d, ...rest } = clone.items;
+		clone.items = stripParamDescriptions(rest);
+	}
+	if (clone.additionalProperties && typeof clone.additionalProperties === "object" && !Array.isArray(clone.additionalProperties)) clone.additionalProperties = stripParamDescriptions(clone.additionalProperties);
+	return clone;
+}
 function registerSingleTool(ctx, toolDef) {
 	const builtTool = toolDef;
 	if (builtTool.__autocomplete) ctx.toolAutocompleteHandlers.set(toolDef.name, builtTool.__autocomplete);
-	const rawSchema = toolDef.inputSchema;
+	const rawSchema = MCP_COMPACT_SCHEMA && toolDef.inputSchema ? stripParamDescriptions(toolDef.inputSchema) : toolDef.inputSchema;
 	const shape = rawSchema && typeof rawSchema === "object" ? buildZodShape(rawSchema) : {};
 	const description = toolDef.description ?? toolDef.name;
 	if (Object.keys(shape).length > 0) {
@@ -3730,7 +3766,7 @@ async function routeToolRequest(request, ctx, searchEngine) {
 	const availableToolNames = getAvailableToolNames(ctx);
 	const routeMatch = matchWorkflowRoute(task, ctx);
 	let presetPlannedToolNames = null;
-	const searchResults = await searchEngine.search(task, maxRecommendations * 2, activeNames, visibleDomains);
+	const searchResults = await searchEngine.search(task, maxRecommendations * 2, activeNames, visibleDomains, getBaseTier(ctx));
 	let finalResults = [];
 	if (routeMatch?.workflow.route.kind === "preset") {
 		const presetTools = buildPresetRecommendations(routeMatch, routingState, ctx, availableToolNames);
@@ -3897,10 +3933,10 @@ async function routeToolRequest(request, ctx, searchEngine) {
 async function handleSearchTools(ctx, args) {
 	const query = args.query;
 	const topK = args.top_k ?? 10;
-	const engine = getSearchEngine(ctx);
+	const engine = await getSearchEngine(ctx);
 	const activeNames = getActiveToolNames(ctx);
 	const visibleDomains = getVisibleDomainsForTier(ctx);
-	const results = await engine.search(query, topK, activeNames, visibleDomains);
+	const results = await engine.search(query, topK, activeNames, visibleDomains, getBaseTier(ctx));
 	const topResult = results[0];
 	const topTool = topResult ? describeTool(topResult.name, ctx) : null;
 	const topExampleArgs = topTool ? generateExampleArgs(topTool.inputSchema) : void 0;
@@ -3927,12 +3963,14 @@ async function handleSearchTools(ctx, args) {
 		exampleArgs: topExampleArgs,
 		description: `Call ${topResult.name} directly. Use describe_tool("${topResult.name}") only if you need the full schema.`
 	});
+	const baseHint = "For guided tool discovery with workflow detection, use route_tool instead. Use activate_tools to enable specific tools, activate_domain for entire domains.";
+	const refinementHint = results.length < 3 ? " Few results — try distilling your query to key concepts (e.g. \"hook fetch\" instead of \"how to intercept fetch requests\")." : "";
 	const response = {
 		query,
 		resultCount: results.length,
 		results,
 		nextActions: searchNextActions,
-		hint: "For guided tool discovery with workflow detection, use route_tool instead. Use activate_tools to enable specific tools, activate_domain for entire domains."
+		hint: baseHint + refinementHint
 	};
 	return asTextResponse(JSON.stringify(response, null, 2));
 }
@@ -3950,6 +3988,7 @@ async function notifyToolListChanged(ctx, changed) {
 	}
 }
 async function activateToolNames(ctx, names) {
+	await ensureAllDomainsLoaded();
 	const activeNames = getActiveToolNames(ctx);
 	const activated = [];
 	const alreadyActive = [];
@@ -3960,7 +3999,7 @@ async function activateToolNames(ctx, names) {
 			alreadyActive.push(name);
 			continue;
 		}
-		const toolDef = getToolByName(ctx).get(name);
+		const toolDef = (await getToolByName(ctx)).get(name);
 		if (!toolDef) {
 			notFound.push(name);
 			continue;
@@ -4060,7 +4099,7 @@ async function handleRouteTool(ctx, args) {
 		success: false,
 		error: "task must be a non-empty string"
 	}));
-	const engine = getSearchEngine(ctx);
+	const engine = await getSearchEngine(ctx);
 	const autoActivate = context?.autoActivate === true;
 	let response = populateCallCommands(await routeToolRequest({
 		task,
@@ -4174,7 +4213,7 @@ async function handleCallTool(ctx, args) {
 	try {
 		const response = await ctx.executeToolWithTracking(name, toolArgs);
 		try {
-			getSearchEngine(ctx).recordToolCallFeedback(name, "");
+			(await getSearchEngine(ctx)).recordToolCallFeedback(name, "");
 		} catch {}
 		return attachCallToolMetadata(response, callMetadata);
 	} catch (error) {
@@ -4199,7 +4238,7 @@ function buildMetaToolDefinitions(ctx) {
 				properties: {
 					query: {
 						type: "string",
-						description: "Search query: keywords, tool name, domain name, or description fragment"
+						description: "Before calling, distill your intent into 2-5 key concepts: what action, on what target, in which domain. Pass only those distilled keywords — not the original user request."
 					},
 					top_k: {
 						type: "number",
@@ -4475,7 +4514,164 @@ Generally, you have three options to deploy hooks:
 	}] }));
 }
 //#endregion
+//#region src/server/persistence/RuntimeSnapshotScheduler.ts
+var RuntimeSnapshotScheduler = class {
+	sources = [];
+	debounceTimer = null;
+	periodicTimer = null;
+	debounceMs;
+	periodicMs;
+	disposed = false;
+	started = false;
+	constructor(options) {
+		this.debounceMs = options?.debounceMs ?? 2e3;
+		this.periodicMs = options?.periodicMs ?? 3e4;
+	}
+	register(filePath, source) {
+		const existing = this.sources.find((entry) => entry.filePath === filePath || entry.source === source);
+		if (existing) {
+			if (existing.filePath !== filePath || existing.source !== source) logger.warn(`skipping conflicting snapshot registration for ${filePath}`);
+			return;
+		}
+		const entry = {
+			source,
+			filePath
+		};
+		this.sources.push(entry);
+		if (this.started) this.restoreOne(entry).catch((err) => logger.warn(`snapshot restore failed for ${entry.filePath}:`, err));
+	}
+	async start() {
+		if (this.started || this.disposed) return;
+		this.started = true;
+		await this.restoreAll();
+		if (this.disposed || this.periodicTimer) return;
+		this.periodicTimer = setInterval(() => {
+			this.scheduleFlush().catch((err) => logger.warn("periodic snapshot failed:", err));
+		}, this.periodicMs);
+	}
+	notifyDirty() {
+		if (this.disposed) return;
+		if (this.debounceTimer) clearTimeout(this.debounceTimer);
+		this.debounceTimer = setTimeout(() => {
+			this.scheduleFlush().catch((err) => logger.warn("debounce snapshot failed:", err));
+		}, this.debounceMs);
+	}
+	async flushAll() {
+		if (this.debounceTimer) {
+			clearTimeout(this.debounceTimer);
+			this.debounceTimer = null;
+		}
+		await this.writeDirtySources();
+	}
+	dispose() {
+		this.disposed = true;
+		if (this.debounceTimer) {
+			clearTimeout(this.debounceTimer);
+			this.debounceTimer = null;
+		}
+		if (this.periodicTimer) {
+			clearInterval(this.periodicTimer);
+			this.periodicTimer = null;
+		}
+	}
+	async restoreAll() {
+		for (const entry of this.sources) await this.restoreOne(entry);
+	}
+	async restoreOne(entry) {
+		try {
+			const data = await readFile(entry.filePath, "utf-8");
+			const parsed = JSON.parse(data);
+			entry.source.restoreSnapshot(parsed);
+			logger.info(`restored snapshot from ${entry.filePath}`);
+		} catch {}
+	}
+	async scheduleFlush() {
+		await this.writeDirtySources();
+	}
+	async writeDirtySources() {
+		for (const entry of this.sources) {
+			if (!entry.source.isPersistDirty()) continue;
+			try {
+				await this.writeSnapshot(entry);
+			} catch (err) {
+				logger.warn(`snapshot write failed for ${entry.filePath}:`, err);
+			}
+		}
+	}
+	async writeSnapshot(entry) {
+		await mkdir(dirname(entry.filePath), { recursive: true });
+		const data = JSON.stringify(entry.source.exportSnapshot());
+		const tmpPath = entry.filePath + ".tmp";
+		await writeFile(tmpPath, data, "utf-8");
+		await rename(tmpPath, entry.filePath);
+		entry.source.markPersisted();
+	}
+};
+function getStateDir(baseDir) {
+	return resolve(baseDir, ".jshookmcp", "state");
+}
+//#endregion
 //#region src/server/MCPServer.ts
+function shouldCollectExecutionMetrics() {
+	return process.env.E2E_COLLECT_PERFORMANCE === "1";
+}
+function captureExecutionMetricMemory() {
+	const memory = process.memoryUsage();
+	return {
+		source: "server",
+		rssBytes: memory.rss,
+		privateBytes: null,
+		virtualBytes: null,
+		heapUsedBytes: memory.heapUsed,
+		heapTotalBytes: memory.heapTotal,
+		externalBytes: memory.external,
+		arrayBuffersBytes: memory.arrayBuffers
+	};
+}
+function buildExecutionMetrics(startedAt, startTime, timeoutMs, cpuStart, memoryBefore) {
+	const finishedAt = (/* @__PURE__ */ new Date()).toISOString();
+	const cpuUsage = process.cpuUsage(cpuStart);
+	const memoryAfter = captureExecutionMetricMemory();
+	return {
+		source: "server",
+		startedAt,
+		finishedAt,
+		elapsedMs: Number((performance.now() - startTime).toFixed(2)),
+		timeoutMs,
+		serverPid: process.pid,
+		cpuUserMicros: cpuUsage.user,
+		cpuSystemMicros: cpuUsage.system,
+		memoryBefore,
+		memoryAfter,
+		memoryDelta: {
+			rssBytes: memoryAfter.rssBytes - memoryBefore.rssBytes,
+			privateBytes: null,
+			virtualBytes: null,
+			heapUsedBytes: memoryAfter.heapUsedBytes - memoryBefore.heapUsedBytes,
+			heapTotalBytes: memoryAfter.heapTotalBytes - memoryBefore.heapTotalBytes,
+			externalBytes: memoryAfter.externalBytes - memoryBefore.externalBytes,
+			arrayBuffersBytes: memoryAfter.arrayBuffersBytes - memoryBefore.arrayBuffersBytes
+		}
+	};
+}
+function appendExecutionMetrics(response, metrics) {
+	const content = response.content;
+	if (!Array.isArray(content)) return response;
+	const firstText = content.find((entry) => typeof entry === "object" && entry !== null && entry.type === "text" && typeof entry.text === "string");
+	if (!firstText) return response;
+	try {
+		const parsed = JSON.parse(firstText.text);
+		if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return response;
+		const record = parsed;
+		if (!("_executionMetrics" in record)) {
+			record._executionMetrics = metrics;
+			firstText.text = JSON.stringify(record);
+		}
+	} catch {
+		return response;
+	}
+	return response;
+}
 var MCPServer = class {
 	config;
 	server;
@@ -4531,12 +4727,32 @@ var MCPServer = class {
 		this.enabledDomains = this.resolveEnabledDomains(this.selectedTools);
 		const depsEntries = [];
 		const manifests = getAllManifests();
-		for (const m of manifests) depsEntries.push([m.depKey, createDomainProxy(this, m.domain, `${m.domain}:${m.depKey}`, () => m.ensure(this))]);
-		for (const m of manifests) if (m.secondaryDepKeys) {
-			for (const key of m.secondaryDepKeys) if (!depsEntries.some(([k]) => k === key)) depsEntries.push([key, createDomainProxy(this, m.domain, `${m.domain}:${key}`, async () => {
-				await m.ensure(this);
-				return this[key];
-			})]);
+		const loadedByDomain = new Map(manifests.map((m) => [m.domain, m]));
+		const allMeta = getLoaderMetadata();
+		if (!Array.isArray(allMeta)) logger.warn("[MCPServer] getLoaderMetadata returned non-array, skipping domain proxy setup");
+		else for (const meta of allMeta) {
+			const loaded = loadedByDomain.get(meta.domain);
+			if (loaded) {
+				depsEntries.push([meta.depKey, createDomainProxy(this, meta.domain, `${meta.domain}:${meta.depKey}`, () => loaded.ensure(this))]);
+				if (loaded.secondaryDepKeys) {
+					for (const key of loaded.secondaryDepKeys) if (!depsEntries.some(([k]) => k === key)) depsEntries.push([key, createDomainProxy(this, meta.domain, `${meta.domain}:${key}`, async () => {
+						await loaded.ensure(this);
+						return this[key];
+					})]);
+				}
+			} else {
+				depsEntries.push([meta.depKey, createDomainProxy(this, meta.domain, `${meta.domain}:${meta.depKey}`, async () => {
+					const manifest = await ensureDomainLoaded(meta.domain);
+					if (!manifest) throw new Error(`Failed to load domain ${meta.domain}`);
+					return manifest.ensure(this);
+				})]);
+				for (const key of meta.secondaryDepKeys) if (!depsEntries.some(([k]) => k === key)) depsEntries.push([key, createDomainProxy(this, meta.domain, `${meta.domain}:${key}`, async () => {
+					const manifest = await ensureDomainLoaded(meta.domain);
+					if (!manifest) throw new Error(`Failed to load domain ${meta.domain}`);
+					await manifest.ensure(this);
+					return this[key];
+				})]);
+			}
 		}
 		this.handlerDeps = Object.fromEntries(depsEntries);
 		const selectedToolNames = new Set(this.selectedTools.map((t) => t.name));
@@ -4573,6 +4789,11 @@ var MCPServer = class {
 		this.samplingBridge = new LLMSamplingBridge(this.server);
 		this.elicitationBridge = new ElicitationBridge(this.server);
 		this.setDomainInstance("activationController", new ActivationController(this.eventBus, this));
+		const stateDir = getStateDir(process.cwd());
+		const snapshotScheduler = new RuntimeSnapshotScheduler();
+		this.setDomainInstance("snapshotScheduler", snapshotScheduler);
+		this.setDomainInstance("snapshotStateDir", stateDir);
+		snapshotScheduler.start().catch((err) => logger.warn("snapshot scheduler start failed:", err));
 		this.eventBus.on("tool:progress", async (payload) => {
 			try {
 				await this.server.server.notification({
@@ -4651,7 +4872,7 @@ var MCPServer = class {
 		}
 		this.cacheRegistrationPromise = (async () => {
 			try {
-				const { createCacheAdapters } = await import("./CacheAdapters-CzFNpD9a.mjs");
+				const { createCacheAdapters } = await import("./CacheAdapters-CDe5WPSV.mjs");
 				const codeCache = this.collector.getCache();
 				const codeCompressor = this.collector.getCompressor();
 				const adapters = createCacheAdapters(this.detailedData, codeCache, codeCompressor);
@@ -4672,6 +4893,12 @@ var MCPServer = class {
 	}
 	async executeToolWithTracking(name, args) {
 		let timeoutTimer;
+		const timeoutMs = 3e4;
+		const collectExecutionMetrics = shouldCollectExecutionMetrics();
+		const executionStartedAt = collectExecutionMetrics ? (/* @__PURE__ */ new Date()).toISOString() : null;
+		const executionStartTime = collectExecutionMetrics ? performance.now() : 0;
+		const executionCpuStart = collectExecutionMetrics ? process.cpuUsage() : null;
+		const executionMemoryBefore = collectExecutionMetrics ? captureExecutionMetricMemory() : null;
 		try {
 			timeoutTimer = setTimeout(() => {
 				try {
@@ -4680,7 +4907,7 @@ var MCPServer = class {
 				} catch {
 					logger.warn(`Telemetry Alert [ERR-03]: Tool execution hung (>30s) for '${name}'.`);
 				}
-			}, 3e4);
+			}, timeoutMs);
 			timeoutTimer.unref();
 			let response;
 			try {
@@ -4689,7 +4916,8 @@ var MCPServer = class {
 				if (timeoutTimer) clearTimeout(timeoutTimer);
 			}
 			this.contextGuard.recordCall(name);
-			const enriched = this.contextGuard.enrichResponse(name, response);
+			let enriched = this.contextGuard.enrichResponse(name, response);
+			if (collectExecutionMetrics && executionStartedAt && executionCpuStart && executionMemoryBefore) enriched = appendExecutionMetrics(enriched, buildExecutionMetrics(executionStartedAt, executionStartTime, timeoutMs, executionCpuStart, executionMemoryBefore));
 			try {
 				this.tokenBudget.recordToolCall(name, args, enriched);
 			} catch (trackingError) {
@@ -4903,7 +5131,8 @@ async function main() {
 			if (cleanup.removedFiles > 0) logger.info(`[artifacts] Startup cleanup removed ${cleanup.removedFiles} files (${cleanup.removedBytes} bytes)`);
 		}
 		logger.info("Creating MCP server instance...");
-		await initRegistry();
+		const explicitProfile = (process.env.MCP_TOOL_PROFILE ?? "").trim().toLowerCase();
+		await initRegistry(explicitProfile === "full" || explicitProfile === "workflow" || explicitProfile === "search" ? explicitProfile : "search");
 		const server = new MCPServer(config);
 		const stopArtifactRetentionScheduler = startArtifactRetentionScheduler();
 		const recoveryWindowMs = Math.max(1e3, RUNTIME_ERROR_WINDOW_MS);