@jshookmcp/jshook 0.2.8 → 0.3.0

package/dist/index.mjs

@@ -1,22 +1,32 @@
 #!/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 asErrorResponse, C as getAvailableToolNames, D as getToolInputSchema, E as getToolDomainFromContext, F as createServerEventBus, H as DetailedDataManager, I as getInjectionInstructions, L as generateAntiDebugBypass, M as isBrowserOrNetworkTask, N as isMaintenanceTask, O as isToolActive, P as matchWorkflowRoute, R as ProcessRegistry, S as rerankResultsForContext, T as getToolDescription, U as UnifiedCacheManager, V as asTextResponse, W as TokenBudgetManager, _ 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 ToolError } from "./ToolCatalog-Bq4V2sbJ.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-D5-bO9D8.mjs";
+import { t as logger } from "./logger-Dh_xb7_2.mjs";
+import { $t as PREDICTIVE_CONFIDENCE_THRESHOLD, An as SEARCH_CACHE_VECTOR_WEIGHT_TOLERANCE, Bn as SEARCH_RECENCY_WINDOW_MS, Ct as MCP_HTTP_KEEPALIVE_TIMEOUT_MS, Dn as SEARCH_AFFINITY_TOP_N, En as SEARCH_AFFINITY_BOOST_FACTOR, Fn as SEARCH_PARAM_TOKEN_WEIGHT, Gn as SEARCH_TIER_PENALTY, Hn as SEARCH_RRF_K, In as SEARCH_PREFIX_MATCH_MULTIPLIER, Jn as SEARCH_TIER_PENALTY_WORKFLOW, Kn as SEARCH_TIER_PENALTY_FULL, Ln as SEARCH_QUERY_CACHE_CAPACITY, M as COMPOUND_LONG_WINDOW_MS, Mn as SEARCH_DOMAIN_HUB_BOOST_MULTIPLIER, Nn as SEARCH_DOMAIN_HUB_THRESHOLD, On as SEARCH_BM25_B, Pn as SEARCH_EXACT_NAME_MATCH_MULTIPLIER, Qn as SEARCH_VECTOR_COSINE_WEIGHT, Rn as SEARCH_RECENCY_MAX_BOOST, St as MCP_HTTP_HEADERS_TIMEOUT_MS, Tn as SEARCH_AFFINITY_BASE_WEIGHT, Un as SEARCH_RRF_RESCALE_FACTOR, Vn as SEARCH_RRF_BM25_BLEND, Wn as SEARCH_SYNONYM_EXPANSION_LIMIT, Xn as SEARCH_TRIGRAM_WEIGHT, Yn as SEARCH_TRIGRAM_THRESHOLD, Zn as SEARCH_VECTOR_BM25_SKIP_THRESHOLD, a as ACTIVATION_TTL_MINUTES, ar as SEARCH_WORKFLOW_DOMAIN_BOOST_MULTIPLIER, bt as MCP_COMPACT_SCHEMA, dn as RUNTIME_ERROR_WINDOW_MS, dt as HTTP_RATE_LIMIT_MAX_IPS, en as PREDICTIVE_DECAY_FACTOR, er as SEARCH_VECTOR_ENABLED, h as AUTOPRUNE_MANUAL_INACTIVITY_MS, i as ACTIVATION_EVENT_HISTORY_MAX, j as COMPOUND_EVENT_WINDOW_MS, jn as SEARCH_COVERAGE_PRECISION_FACTOR, kn as SEARCH_BM25_K1, m as AUTOPRUNE_CHECK_INTERVAL_MS, n as ACTIVATION_COMPOUND_EVAL_EVERY, nn as PREDICTIVE_MAX_SECOND_ORDER_KEYS, nr as SEARCH_VECTOR_LEARN_TOP_N, or as SHUTDOWN_TIMEOUT_MS, p as AUTOPRUNE_AUTO_INACTIVITY_MS, qn as SEARCH_TIER_PENALTY_SEARCH, r as ACTIVATION_COOLDOWN_MS, rr as SEARCH_VECTOR_LEARN_UP, t as ACTIVATION_BOOST_WINDOW_MS, tn as PREDICTIVE_MAX_HISTORY, tr as SEARCH_VECTOR_LEARN_DOWN, un as RUNTIME_ERROR_THRESHOLD, ut as HTTP_CLEANUP_INTERVAL_MS, wt as MCP_HTTP_REQUEST_TIMEOUT_MS, xt as MCP_HTTP_FORCE_CLOSE_TIMEOUT_MS, zn as SEARCH_RECENCY_TRACKER_MAX } from "./constants-CDZLOoVv.mjs";
+import { a as TokenBudgetManager, i as UnifiedCacheManager, n as getArtifactRetentionConfig, r as startArtifactRetentionScheduler, t as cleanupArtifacts } from "./artifactRetention-CPXkUJXp.mjs";
+import { t as DetailedDataManager } from "./DetailedDataManager-HT49OrvF.mjs";
+import { r as asTextResponse, t as asErrorResponse } from "./response-CWhh2aLo.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-5OJdMiF0.mjs";
+import { t as ToolError } from "./ToolError-jh9whhMd.mjs";
+import { t as ProcessRegistry } from "./ProcessRegistry-zGg12QbE.mjs";
+import { c as getConfig, d as DEFAULT_SEARCH_CONFIG, u as validateConfig } from "./outputPaths-um7lCRY3.mjs";
+import { i as reloadExtensions, n as ensureWorkflowsLoaded, r as listExtensions } from "./ExtensionManager-BDMsY2Dz.mjs";
+import { _ as isBrowserOrNetworkTask, a as buildWorkflowToolSequence, b as matchWorkflowRoute, c as getAvailableToolNames, d as getToolDomainFromContext, f as getToolInputSchema, g as detectWorkflowIntent, h as validateToolNameArray, i as buildWorkflowRouteRecommendation, l as getRoutingState, m as normalizeToolName, n as buildRouteMatchMetadata, o as getEffectivePrerequisites, p as isToolActive, r as buildStatelessComputeRecommendations, s as rerankResultsForContext, t as buildPresetRecommendations, u as getToolDescription, v as isMaintenanceTask, y as isStatelessComputeTask } from "./ToolRouter.policy-BGDAGyeH.mjs";
+import { i as generateAntiDebugBypass, r as getInjectionInstructions } from "./HookGeneratorBuilders.core.generators.storage-CTbB4Lcx.mjs";
+import { n as createServerEventBus } from "./EventBus-DFKvADm3.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;
@@ -298,7 +308,7 @@ var ToolExecutionRouter = class {
 * appends `_tabContext` metadata to responses so the LLM always knows which page
 * it is operating on, preventing silent context drift.
 *
-* Additionally, tracks consecutive identical tool calls and injects `_repeatWarning`
+* Additionally, tracks consecutive identical tool calls and injects `repeatWarning`
 * when the same tool is called ≥ MAX_CONSECUTIVE_REPEATS times in a row, helping
 * break LLM degeneration loops (e.g. stealth_inject called 5× instead of page_navigate).
 */
@@ -336,15 +346,21 @@ const REPEAT_GUARD_EXCLUDES = new Set([
 const DOMAIN_ALTERNATIVES = new Map([
 	["stealth", [
 		"page_navigate",
-		"page_screenshot",
-		"stealth_verify"
+		"page_evaluate",
+		"stealth_verify",
+		"page_screenshot"
 	]],
 	["page", [
-		"dom_get_structure",
-		"page_screenshot",
-		"console_get_logs"
+		"browser_jsdom_parse",
+		"js_bundle_search",
+		"network_get_requests",
+		"page_screenshot"
+	]],
+	["console", [
+		"page_evaluate",
+		"console_get_logs",
+		"page_screenshot"
 	]],
-	["console", ["page_evaluate", "page_screenshot"]],
 	["network", ["network_get_requests", "page_navigate"]],
 	["captcha", ["captcha_wait", "page_screenshot"]],
 	["ai_hook", [
@@ -352,8 +368,8 @@ const DOMAIN_ALTERNATIVES = new Map([
 		"page_evaluate",
 		"ai_hook_inject"
 	]],
-	["instrumentation", ["instrumentation_session_list", "instrumentation_artifact_query"]],
-	["evidence", ["evidence_query_url", "evidence_chain"]]
+	["instrumentation", ["instrumentation_session", "instrumentation_artifact"]],
+	["evidence", ["evidence_query", "evidence_chain"]]
 ]);
 var ToolCallContextGuard = class {
 	/** Memoize prefix-match results — tool names repeat heavily across calls. */
@@ -404,7 +420,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;
@@ -446,12 +462,17 @@ var ToolCallContextGuard = class {
 		return raw.replace(/\}\s*$/, `,"_tabContext":${compactJson}}`);
 	}
 	/**
-	* Inject a `_repeatWarning` into the response when a tool call loop is detected.
+	* Inject a `repeatWarning` into the response when a tool call loop is detected.
 	* Splices into JSON text content if possible, or appends a new text entry.
 	*/
 	injectRepeatWarning(toolName, response) {
 		const prefix = toolName.split("_")[0] ?? "";
-		const suggestions = (DOMAIN_ALTERNATIVES.get(prefix) ?? ["page_navigate", "page_screenshot"]).filter((t) => t !== toolName);
+		const suggestions = (toolName === "page_evaluate" ? [
+			"browser_jsdom_parse",
+			"js_bundle_search",
+			"network_get_requests",
+			"page_screenshot"
+		] : DOMAIN_ALTERNATIVES.get(prefix) ?? ["page_navigate", "page_evaluate"]).filter((t) => t !== toolName);
 		const warning = {
 			detected: true,
 			consecutiveCount: this.consecutiveCount,
@@ -467,7 +488,7 @@ var ToolCallContextGuard = class {
 			try {
 				const parsed = JSON.parse(raw);
 				if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
-					parsed._repeatWarning = warning;
+					parsed.repeatWarning = warning;
 					firstText.text = JSON.stringify(parsed, null, 2);
 					return;
 				}
@@ -475,7 +496,7 @@ var ToolCallContextGuard = class {
 		}
 		content.push({
 			type: "text",
-			text: JSON.stringify({ _repeatWarning: warning }, null, 2)
+			text: JSON.stringify({ repeatWarning: warning }, null, 2)
 		});
 	}
 };
@@ -1024,6 +1045,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();
@@ -1762,7 +1793,8 @@ 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) => {
@@ -1872,7 +1904,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();
@@ -2029,6 +2061,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;
@@ -2050,6 +2089,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]+[.!?]?/);
@@ -2059,28 +2105,27 @@ 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, "_");
 	}
 };
 //#endregion
-//#region src/server/search/ToolSearchEngineImpl.ts
-/**
-* 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
-* - Trigram fuzzy matching for typo tolerance
-* - RRF (Reciprocal Rank Fusion) combining all signals
-* - 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
-* - LRU query result cache (§4.3 CSAPC cross-session caching)
-*/
+//#region src/server/search/ToolSearchEngine.helpers.ts
 function findDelimitedIndex(haystack, needle, wordChar) {
 	if (!needle) return -1;
 	let idx = haystack.indexOf(needle);
@@ -2094,6 +2139,93 @@ function findDelimitedIndex(haystack, needle, wordChar) {
 	}
 	return -1;
 }
+function buildAffinityGraph(docs) {
+	const graph = /* @__PURE__ */ new Map();
+	const prefixGroups = /* @__PURE__ */ new Map();
+	for (let i = 0; i < docs.length; i++) {
+		const name = docs[i].name;
+		const underscoreIdx = name.indexOf("_");
+		if (underscoreIdx <= 0) continue;
+		const prefix = name.slice(0, underscoreIdx);
+		const group = prefixGroups.get(prefix) ?? [];
+		group.push(i);
+		prefixGroups.set(prefix, group);
+	}
+	for (const [, members] of prefixGroups) {
+		if (members.length < 2 || members.length > 15) continue;
+		const affinityWeight = SEARCH_AFFINITY_BASE_WEIGHT / Math.sqrt(members.length);
+		for (const src of members) {
+			const edges = graph.get(src) ?? [];
+			for (const dst of members) if (dst !== src) edges.push({
+				docIndex: dst,
+				weight: affinityWeight
+			});
+			graph.set(src, edges);
+		}
+	}
+	return graph;
+}
+function rankByScores(scores) {
+	const entries = [];
+	for (let i = 0; i < scores.length; i++) if (scores[i] > 0) entries.push({
+		idx: i,
+		score: scores[i]
+	});
+	entries.sort((a, b) => b.score - a.score);
+	const ranked = /* @__PURE__ */ new Map();
+	for (let rank = 0; rank < entries.length; rank++) ranked.set(entries[rank].idx, rank);
+	return ranked;
+}
+function rankByMap(scoreMap) {
+	const entries = [...scoreMap.entries()].toSorted((a, b) => b[1] - a[1]);
+	const ranked = /* @__PURE__ */ new Map();
+	for (let rank = 0; rank < entries.length; rank++) ranked.set(entries[rank][0], rank);
+	return ranked;
+}
+function blendRrfIntoScores(scores, rrfScores) {
+	for (let i = 0; i < scores.length; i++) {
+		const rrfScore = rrfScores[i];
+		if (rrfScore <= 0) continue;
+		const bm25Original = scores[i];
+		const rrfRescaled = rrfScore * SEARCH_RRF_RESCALE_FACTOR;
+		const blend = SEARCH_RRF_BM25_BLEND;
+		scores[i] = Math.max(bm25Original, rrfRescaled * blend) + rrfRescaled * blend;
+	}
+}
+function applyGraphExpansionToScores(options) {
+	const { scores, docs, affinityGraph } = options;
+	const scored = [];
+	for (let i = 0; i < scores.length; 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);
+	if (affinityGraph.size > 0) {
+		const limit = Math.min(SEARCH_AFFINITY_TOP_N, scored.length);
+		for (let rank = 0; rank < limit; rank++) {
+			const { idx, score } = scored[rank];
+			const neighbors = 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 * SEARCH_AFFINITY_BOOST_FACTOR;
+		}
+	}
+	if (SEARCH_DOMAIN_HUB_THRESHOLD > 0 && scored.length >= SEARCH_DOMAIN_HUB_THRESHOLD) {
+		const top10 = scored.slice(0, 10);
+		const domainCounts = /* @__PURE__ */ new Map();
+		for (const { idx } of top10) {
+			const domain = docs[idx].domain;
+			if (domain) domainCounts.set(domain, (domainCounts.get(domain) ?? 0) + 1);
+		}
+		for (const [domain, count] of domainCounts) {
+			if (count < SEARCH_DOMAIN_HUB_THRESHOLD) continue;
+			for (let i = 0; i < docs.length; i++) if (scores[i] > 0 && docs[i].domain === domain) scores[i] *= SEARCH_DOMAIN_HUB_BOOST_MULTIPLIER;
+		}
+	}
+}
+//#endregion
+//#region src/server/search/ToolSearchEngineImpl.ts
 function buildSearchCacheKey(query, topK, visibleDomains) {
 	if (!visibleDomains || visibleDomains.size === 0) return `${query}\0${topK}`;
 	return `${query}\0${topK}\0${[...visibleDomains].toSorted().join("|")}`;
@@ -2134,8 +2266,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. */
@@ -2164,7 +2294,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;
@@ -2193,9 +2324,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);
@@ -2252,31 +2381,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.affinityGraph = buildAffinityGraph(this.docs);
 		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;
@@ -2347,11 +2475,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) {
@@ -2421,9 +2548,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;
@@ -2496,96 +2623,41 @@ 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);
+		const bm25Ranked = rankByScores(scores);
+		const trigramRanked = rankByMap(this.trigramIndex.search(query, SEARCH_TRIGRAM_THRESHOLD));
+		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 = rankByMap(vectorScores);
+			}
+		} else {
+			vectorScores = await this.computeVectorCosineScores(query);
+			vectorRanked = rankByMap(vectorScores);
 		}
+		const ranking = /* @__PURE__ */ new Map();
+		for (const [docIdx, rank] of vectorRanked) ranking.set(this.docs[docIdx].name, rank);
+		this.feedbackTracker.recordVectorRanking(ranking);
+		const fusedRrfScores = new Float64Array(this.docCount);
 		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);
 			if (vectorRank !== void 0 && this.feedbackTracker.getVectorWeight() > 0) rrfScore += this.feedbackTracker.getVectorWeight() * (1 / (k + vectorRank));
-			if (rrfScore > 0) {
-				const bm25Original = scores[i];
-				const rrfRescaled = rrfScore * SEARCH_RRF_RESCALE_FACTOR;
-				const blend = SEARCH_RRF_BM25_BLEND;
-				scores[i] = Math.max(bm25Original, rrfRescaled * blend) + rrfRescaled * blend;
-			}
+			fusedRrfScores[i] = rrfScore;
 		}
-	}
-	/**
-	* 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).
-	*/
-	rankByScores(scores) {
-		const entries = [];
-		for (let i = 0; i < scores.length; i++) if (scores[i] > 0) entries.push({
-			idx: i,
-			score: scores[i]
-		});
-		entries.sort((a, b) => b.score - a.score);
-		const ranked = /* @__PURE__ */ new Map();
-		for (let rank = 0; rank < entries.length; rank++) ranked.set(entries[rank].idx, rank);
-		return ranked;
-	}
-	/**
-	* Rank documents by a score map.
-	* Returns Map<docIndex, rank> (0-based, lower = better).
-	*/
-	rankByMap(scoreMap) {
-		const entries = [...scoreMap.entries()].toSorted((a, b) => b[1] - a[1]);
-		const ranked = /* @__PURE__ */ new Map();
-		for (let rank = 0; rank < entries.length; rank++) ranked.set(entries[rank][0], rank);
-		return ranked;
+		blendRrfIntoScores(scores, fusedRrfScores);
 	}
 	/**
 	* Lazy-compute and cache tool description embeddings.
@@ -2674,82 +2746,16 @@ var ToolSearchEngine = class {
 	}
 	/**
 	* Build prefix-group affinity graph (§4.1.4 dependency hull).
-	* Tools sharing a name prefix (e.g. "breakpoint_set", "breakpoint_list")
+	* Tools sharing a name prefix (e.g. legacy "breakpoint_set"/"breakpoint_list"
+	* or unified families such as "memory_*")
 	* form an affinity group with mutual edges.
 	*/
-	buildAffinityGraph() {
-		const graph = /* @__PURE__ */ new Map();
-		const prefixGroups = /* @__PURE__ */ new Map();
-		for (let i = 0; i < this.docCount; i++) {
-			const name = this.docs[i].name;
-			const underscoreIdx = name.indexOf("_");
-			if (underscoreIdx <= 0) continue;
-			const prefix = name.slice(0, underscoreIdx);
-			const group = prefixGroups.get(prefix) ?? [];
-			group.push(i);
-			prefixGroups.set(prefix, group);
-		}
-		for (const [, members] of prefixGroups) {
-			if (members.length < 2 || members.length > 15) continue;
-			const affinityWeight = SEARCH_AFFINITY_BASE_WEIGHT / Math.sqrt(members.length);
-			for (const src of members) {
-				const edges = graph.get(src) ?? [];
-				for (const dst of members) if (dst !== src) edges.push({
-					docIndex: dst,
-					weight: affinityWeight
-				});
-				graph.set(src, edges);
-			}
-		}
-		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.
-	*/
-	applyAffinityExpansion(scores) {
-		if (this.affinityGraph.size === 0) return;
-		const topN = SEARCH_AFFINITY_TOP_N;
-		const scored = [];
-		for (let i = 0; i < this.docCount; i++) if (scores[i] > 0) scored.push({
-			idx: i,
-			score: scores[i]
-		});
-		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;
-		}
-	}
-	/**
-	* 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]
+	applyGraphExpansion(scores) {
+		applyGraphExpansionToScores({
+			scores,
+			docs: this.docs,
+			affinityGraph: this.affinityGraph
 		});
-		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;
-		}
 	}
 };
 //#endregion
@@ -2788,18 +2794,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();
 /**
@@ -2812,11 +2822,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();
@@ -2833,14 +2844,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
@@ -2853,12 +2864,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);
@@ -3416,7 +3428,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();
@@ -3648,10 +3661,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;
+	if (builtTool.autocompleteHandlers) ctx.toolAutocompleteHandlers.set(toolDef.name, builtTool.autocompleteHandlers);
+	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) {
@@ -3668,7 +3698,7 @@ function registerSingleTool(ctx, toolDef) {
 			}
 		});
 		if (builtTool.execution) {
-			const sdkInternalMap = ctx.server._registeredTools;
+			const sdkInternalMap = ctx.server.registeredTools;
 			if (sdkInternalMap && sdkInternalMap[toolDef.name]) sdkInternalMap[toolDef.name].execution = builtTool.execution;
 		}
 		return registeredTool;
@@ -3683,7 +3713,7 @@ function registerSingleTool(ctx, toolDef) {
 		}
 	});
 	if (builtTool.execution) {
-		const sdkInternalMap = ctx.server._registeredTools;
+		const sdkInternalMap = ctx.server.registeredTools;
 		if (sdkInternalMap && sdkInternalMap[toolDef.name]) sdkInternalMap[toolDef.name].execution = builtTool.execution;
 	}
 	return registeredTool;
@@ -3737,7 +3767,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);
@@ -3749,17 +3779,25 @@ async function routeToolRequest(request, ctx, searchEngine) {
 		const workflowResult = buildWorkflowRouteRecommendation(routeMatch, ctx);
 		finalResults = [workflowResult, ...searchResults.filter((result) => result.name !== workflowResult.name)];
 	} else if (workflow) {
+		const statelessWorkflow = isStatelessComputeTask(task);
 		const workflowSequence = buildWorkflowToolSequence(workflow, routingState, availableToolNames);
 		const workflowTools = workflowSequence.map((name, index) => ({
 			name,
 			domain: getToolDomainFromContext(name, ctx),
 			shortDescription: searchResults.find((r) => r.name === name)?.shortDescription ?? ctx.extensionToolsByName.get(name)?.tool.description ?? "",
-			score: workflow.priority - index * .01,
+			score: (statelessWorkflow ? 90 : workflow.priority) - index * .01,
 			isActive: isToolActive(name, ctx)
 		}));
 		const workflowNames = new Set(workflowSequence);
 		const otherResults = searchResults.filter((result) => !workflowNames.has(result.name));
 		finalResults = [...workflowTools, ...otherResults];
+	} else if (task && !isBrowserOrNetworkTask(task, workflow) && !isMaintenanceTask(task)) {
+		const statelessRecommendations = buildStatelessComputeRecommendations(task, ctx, availableToolNames);
+		if (statelessRecommendations.length > 0) {
+			const statelessNames = new Set(statelessRecommendations.map((tool) => tool.name));
+			const otherResults = searchResults.filter((result) => !statelessNames.has(result.name));
+			finalResults = [...statelessRecommendations, ...otherResults];
+		} else finalResults = [...searchResults];
 	} else finalResults = [...searchResults];
 	const dedupedResults = [];
 	const seenNames = /* @__PURE__ */ new Set();
@@ -3904,10 +3942,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;
@@ -3934,12 +3972,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));
 }
@@ -3957,6 +3997,7 @@ async function notifyToolListChanged(ctx, changed) {
 	}
 }
 async function activateToolNames(ctx, names) {
+	await ensureAllDomainsLoaded();
 	const activeNames = getActiveToolNames(ctx);
 	const activated = [];
 	const alreadyActive = [];
@@ -3967,7 +4008,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;
@@ -4067,7 +4108,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,
@@ -4142,6 +4183,7 @@ function buildCallToolMetadata(wasAutoActivated, activatedTools) {
 	};
 }
 function attachCallToolMetadata(response, metadata) {
+	if (!response?.content || !Array.isArray(response.content)) return response;
 	return {
 		...response,
 		content: response.content.map((item) => {
@@ -4181,7 +4223,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) {
@@ -4206,7 +4248,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",
@@ -4237,7 +4279,7 @@ function buildMetaToolDefinitions(ctx) {
 							},
 							autoActivate: {
 								type: "boolean",
-								description: "Whether to auto-activate recommended tools (default: true)"
+								description: "Whether to auto-activate recommended tools (default: false)"
 							},
 							maxRecommendations: {
 								type: "number",
@@ -4293,7 +4335,7 @@ function buildMetaToolDefinitions(ctx) {
 		},
 		{
 			name: "activate_domain",
-			description: `Activate all tools in a domain at once. Domains: ${[...getAllDomains()].join(", ")}. Use extensions_reload first to include external plugin/workflow domains.`,
+			description: `Activate all tools in a domain at once. Domains: ${[...getAllDomains()].join(", ")}. Use reload_extensions first to include external plugin/workflow domains.`,
 			inputSchema: {
 				type: "object",
 				properties: {
@@ -4312,7 +4354,7 @@ function buildMetaToolDefinitions(ctx) {
 		},
 		{
 			name: "call_tool",
-			description: "Execute any tool by name with auto-activation. Use this when activate_tools/activate_domain registered a tool but it does not appear in your tool list (common for clients that do not support tools/list_changed notifications). Accepts the tool name and its arguments object; returns the tool's native response.",
+			description: "Execute an already-active tool by name. Use this when activate_tools/activate_domain registered a tool but your client did not refresh its tool list. Does not auto-activate inactive tools.",
 			inputSchema: {
 				type: "object",
 				properties: {
@@ -4482,7 +4524,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;
@@ -4538,12 +4737,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));
@@ -4580,6 +4799,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({
@@ -4658,7 +4882,7 @@ var MCPServer = class {
 		}
 		this.cacheRegistrationPromise = (async () => {
 			try {
-				const { createCacheAdapters } = await import("./CacheAdapters-CzFNpD9a.mjs");
+				const { createCacheAdapters } = await import("./CacheAdapters-jJFy20G-.mjs");
 				const codeCache = this.collector.getCache();
 				const codeCompressor = this.collector.getCompressor();
 				const adapters = createCacheAdapters(this.detailedData, codeCache, codeCompressor);
@@ -4679,6 +4903,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 {
@@ -4687,7 +4917,7 @@ var MCPServer = class {
 				} catch {
 					logger.warn(`Telemetry Alert [ERR-03]: Tool execution hung (>30s) for '${name}'.`);
 				}
-			}, 3e4);
+			}, timeoutMs);
 			timeoutTimer.unref();
 			let response;
 			try {
@@ -4696,7 +4926,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) {
@@ -4910,7 +5141,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);