chain-insights 0.68.2 → 0.69.0

package/dist/mcp-proxy.cjs

@@ -2,12 +2,14 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./rolldown-runtime-C0BPl7ul.cjs");
 const require_print_result = require("./print-result-qVhhuSdo.cjs");
 const require_client = require("./client-Ypw9BNbn.cjs");
-const require_tool_visibility = require("./tool-visibility-B4RAFMaB.cjs");
+const require_tool_visibility = require("./tool-visibility-BopFnGsT.cjs");
 const require_usage_status = require("./usage-status-DonwoLR3.cjs");
 const require_subscription_status = require("./subscription-status-ru99UCPZ.cjs");
 const require_capabilities = require("./capabilities-DGavTSoW.cjs");
 const require_graph_schema = require("./graph-schema-C_7aZ8RL.cjs");
 const require_action_log = require("./action-log-HniMMF7f.cjs");
+const require_dex_tool = require("./dex-tool-DIKN4dXB.cjs");
+const require_dex_registry = require("./dex-registry-KOTJhAQf.cjs");
 let node_url = require("node:url");
 let node_path = require("node:path");
 node_path = require_rolldown_runtime.__toESM(node_path, 1);
@@ -101,17 +103,17 @@ function rateLimitedResult(toolName, err) {
 const BUSY_CODE = "chain_busy";
 const BUSY_WAIT_MS = 1100;
 const defaultSleep = (ms) => new Promise((done) => setTimeout(done, ms));
-function isRecord$3(value) {
+function isRecord$2(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function membersOf(result) {
-	const facts = isRecord$3(result.structuredContent) ? result.structuredContent.facts : void 0;
-	const queries = isRecord$3(facts) ? facts.queries : void 0;
-	return Array.isArray(queries) && queries.every(isRecord$3) ? queries : null;
+	const facts = isRecord$2(result.structuredContent) ? result.structuredContent.facts : void 0;
+	const queries = isRecord$2(facts) ? facts.queries : void 0;
+	return Array.isArray(queries) && queries.every(isRecord$2) ? queries : null;
 }
 function isBusyMember(member) {
 	const detail = member.error_detail;
-	return isRecord$3(detail) && detail.code === BUSY_CODE;
+	return isRecord$2(detail) && detail.code === BUSY_CODE;
 }
 /** The ids of the members the server refused as chain_busy. */
 function busyMemberIds(result) {
@@ -142,7 +144,7 @@ function mergeBatchAnswers(first, again) {
 	const merged = members.map((m) => isBusyMember(m) && byId.has(String(m.id)) ? byId.get(String(m.id)) : m);
 	const structured = first.structuredContent;
 	const facts = structured.facts;
-	const batch = isRecord$3(facts.batch) ? recount(facts.batch, merged) : facts.batch;
+	const batch = isRecord$2(facts.batch) ? recount(facts.batch, merged) : facts.batch;
 	const nextStructured = {
 		...structured,
 		facts: {
@@ -186,7 +188,7 @@ async function withBusyMemberRetry(args, call, sleep = defaultSleep) {
 function isBusyResult(result) {
 	if (!result.isError) return false;
 	const first = Array.isArray(result.content) ? result.content[0] : void 0;
-	const text = isRecord$3(first) && typeof first.text === "string" ? first.text : "";
+	const text = isRecord$2(first) && typeof first.text === "string" ? first.text : "";
 	return /^(Query execution failed: )?chain_busy\b/.test(text.trim());
 }
 /**
@@ -333,7 +335,7 @@ function send(res, status, contentType, body) {
 function sendJson(res, status, value) {
 	send(res, status, "application/json; charset=utf-8", JSON.stringify(value));
 }
-function isRecord$2(value) {
+function isRecord$1(value) {
 	return !!value && typeof value === "object" && !Array.isArray(value);
 }
 var BodyTooLarge = class extends Error {};
@@ -424,8 +426,8 @@ async function startViewServer(options) {
 				sendJson(res, 400, { error: "invalid JSON" });
 				return;
 			}
-			const args = isRecord$2(body) ? body.arguments ?? {} : void 0;
-			if (!isRecord$2(args)) {
+			const args = isRecord$1(body) ? body.arguments ?? {} : void 0;
+			if (!isRecord$1(args)) {
 				sendJson(res, 400, { error: "arguments must be an object" });
 				return;
 			}
@@ -606,52 +608,6 @@ async function connectRemote(options) {
 	};
 }
 //#endregion
-//#region src/mcp/answer-hint.ts
-/**
-* The two answer rules that still slip in long answers, carried on every
-* graph reply in the result's `hint` field. Claude Code has a Stop hook that
-* reads the answer; Codex and Claude Desktop have no such hook, and in the
-* loop's third prompt set they broke one of these two rules in three of
-* thirteen conversations. The reply is the one thing every host hands the
-* model right before it writes, so the rules ride on it. A `hint` the
-* server already set is kept.
-*/
-const ANSWER_HINT = "Answer: write every address in full (0x plus 40 characters), also when it repeats one named earlier and also when the user asks for shorter ones (name them instead); a transfer moves tokens, so write \"tokens worth about N USD\", never \"sent N USD\" or a $ figure; never draw the flows in text, ASCII or Mermaid, the host draws them.";
-function isRecord$1(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/** The structured content with the hint set when the server left it empty. */
-function withAnswerHint(structuredContent) {
-	if (!isRecord$1(structuredContent) || !isRecord$1(structuredContent.facts)) return structuredContent;
-	if (typeof structuredContent.hint === "string" && structuredContent.hint.trim()) return structuredContent;
-	return {
-		...structuredContent,
-		hint: ANSWER_HINT
-	};
-}
-/** A graph tool result whose structured content and single JSON text block both carry the hint. */
-function withAnswerHintResult(result) {
-	const structured = withAnswerHint(result.structuredContent);
-	if (structured === result.structuredContent) return result;
-	const content = result.content ?? [];
-	const only = content.length === 1 && content[0]?.type === "text" ? content[0] : null;
-	let parsed = void 0;
-	try {
-		parsed = only?.text ? JSON.parse(only.text) : void 0;
-	} catch {
-		parsed = void 0;
-	}
-	const textIsStructured = parsed !== void 0 && JSON.stringify(parsed) === JSON.stringify(result.structuredContent);
-	return {
-		...result,
-		structuredContent: structured,
-		content: textIsStructured ? [{
-			...only,
-			text: JSON.stringify(structured)
-		}] : content
-	};
-}
-//#endregion
 //#region src/mcp/proxy.ts
 const LOCAL_TOOL_NAMES = /* @__PURE__ */ new Set([
 	"meta_network_capabilities",
@@ -660,6 +616,7 @@ const LOCAL_TOOL_NAMES = /* @__PURE__ */ new Set([
 	"meta_subscription_status",
 	"meta_help",
 	"meta_rules",
+	require_dex_tool.META_DEX_LOOKUP_TOOL,
 	"wallet_balance",
 	"wallet_topup",
 	require_graph_schema.GRAPH_EXPAND_TOOL
@@ -717,15 +674,17 @@ function resolveMcpProxyMode(env = process.env) {
 }
 const GRAPH_LAYERS_TEXT = "Use USE topology for topology (address/FLOWS_TO/OPERATED_BY/LINKED graph with SWAPPED, ADDED_LIQUIDITY, REMOVED_LIQUIDITY, BRIDGED and the Pool, Token and NFT labels, unified recent+historical) and USE facts for bounded TRANSFER, SWAP, LIQUIDITY_ADD, LIQUIDITY_REMOVE and BRIDGE_CROSSING rows and enrichment, and USE chain for the chain node's own record of one known transaction, block, address or the head.";
 const TOOL_RULES_FIRST = "Rules first: if the chain-insights-cypher skill is not loaded in this chat, call meta_rules once before this tool. For a graph, alias the columns from_address and to_address; the host draws the picture from the answer itself. Never draw it again with another tool, such as a visualize or widget tool.";
+const GRAPH_QUERY_DEX_DOOR_SENTENCE = "A question that names an exchange and no address starts with meta_dex_lookup, never with a scan of :Protocol, :Pool or labels.";
 const KNOWN_PUBLIC_TOOL_DESCRIPTIONS = {
 	meta_network_capabilities: "Return the current Chain Insights network and tool support matrix. Takes no arguments: send {}.",
 	meta_schema: require_graph_schema.META_SCHEMA_DESCRIPTION,
+	[require_dex_tool.META_DEX_LOOKUP_TOOL]: require_dex_tool.META_DEX_LOOKUP_DESCRIPTION,
 	meta_usage_status: "Return the caller's public free graph_query quota for the current UTC day.",
 	meta_subscription_status: "Return the caller's CIA subscription window end, daily allowance, consumption, and tier.",
 	meta_help: "Show a short guide to Chain Insights tools and workflow.",
 	meta_rules: "Return the Chain Insights rules: how to write graph_query and graph_query_batch reads that are served, how to name columns so the answer is drawn as a graph, a time series or a table, and how to write the answer. Call it once per chat, before the first graph query, when the chain-insights-cypher skill is not loaded. Takes no arguments: send {}.",
 	wallet_balance: "Show the local Chain Insights payment wallet address, payment network, token, and amount.",
-	graph_query: `${TOOL_RULES_FIRST} Run a read-only GQL/Cypher query through the Chain Insights graph endpoint. ${GRAPH_LAYERS_TEXT} ${ROUTING_NOT_SERVED} Preserve full addresses exactly, and write every address in full, all 42 characters, in your answer: never shorten one with ... or ….`,
+	graph_query: `${TOOL_RULES_FIRST} Run a read-only GQL/Cypher query through the Chain Insights graph endpoint. ${GRAPH_LAYERS_TEXT} ${GRAPH_QUERY_DEX_DOOR_SENTENCE} ${ROUTING_NOT_SERVED} Preserve full addresses exactly, and write every address in full, all 42 characters, in your answer: never shorten one with ... or ….`,
 	graph_query_batch: `${TOOL_RULES_FIRST} Run multiple read-only GQL/Cypher queries through the Chain Insights graph endpoint in one paid batch. Prefer this for related topology/facts reads. For a time series across days, send one USE facts total per day with the query id set to the day, "YYYY-MM-DD": the view joins them into one series. Write every address in full in your answer, all 42 characters.`
 };
 const KNOWN_PUBLIC_TOOL_TITLES = {
@@ -1184,7 +1143,7 @@ function normalizeRemoteToolResult(toolName, result) {
 		_meta: sanitizeRemoteMeta(result._meta),
 		isError: result.isError
 	};
-	return toolName === "graph_query" || toolName === "graph_query_batch" ? require_print_result.withTimestampTextResult(withAnswerHintResult(normalized)) : normalized;
+	return toolName === "graph_query" || toolName === "graph_query_batch" ? require_print_result.withTimestampTextResult(require_dex_tool.withAnswerHintResult(normalized)) : normalized;
 }
 function cleanNetworkCapabilities(value) {
 	const structuredContent = isRecord(value) ? value.structuredContent : void 0;
@@ -1421,6 +1380,37 @@ async function createProxy() {
 			openWorldHint: true
 		}
 	}, async (args) => require_graph_schema.handleMetaSchema(args, schemaDependencies));
+	const dexDependencies = {
+		loadRegistry: (network) => require_dex_registry.loadRegistry(network, { log: (line) => {
+			logger.info("dex_registry.fault", { line });
+		} }),
+		graphQueryBatch: async (args) => {
+			const options = remoteToolRequestOptions("graph_query_batch");
+			const call = (requestArgs) => withRateLimitRetry(() => options ? remoteClient.callTool({
+				name: "graph_query_batch",
+				arguments: requestArgs
+			}, void 0, options) : remoteClient.callTool({
+				name: "graph_query_batch",
+				arguments: requestArgs
+			}));
+			return await withBusyMemberRetry(args, call);
+		},
+		unavailable: async () => {
+			await ensureRemote();
+			return remoteConnected ? void 0 : `${remoteUnavailableMessage ?? `Chain Insights Graph is not connected at ${graphMcpEndpoint}`}.`;
+		},
+		describeFailure: (err) => remoteCallFailureText("graph_query_batch", err)
+	};
+	server.registerTool(require_dex_tool.META_DEX_LOOKUP_TOOL, {
+		title: require_dex_tool.META_DEX_LOOKUP_TITLE,
+		description: KNOWN_PUBLIC_TOOL_DESCRIPTIONS[require_dex_tool.META_DEX_LOOKUP_TOOL],
+		inputSchema: {
+			network: NETWORK_SCHEMA,
+			name: zod.string().optional().describe("The exchange as the user wrote it: Aero, Aerodrome, uni v4. With no name, every covered exchange is listed."),
+			pools: zod.boolean().optional().describe("Read the biggest pools of the exchange (default true). false sends only Head and the contract reads.")
+		},
+		annotations: require_dex_tool.META_DEX_LOOKUP_ANNOTATIONS
+	}, async (args) => require_dex_tool.handleMetaDexLookup(args, dexDependencies));
 	server.registerTool("meta_usage_status", {
 		title: "Usage Status",
 		description: KNOWN_PUBLIC_TOOL_DESCRIPTIONS.meta_usage_status,
@@ -1664,6 +1654,7 @@ async function createProxy() {
 				"Investigation tools:",
 				"- meta_network_capabilities: supported networks and available tools. Takes no arguments.",
 				"- meta_schema: read the live graph schema of one network: labels, link types and field names. Cached for 24 hours.",
+				"- meta_dex_lookup: turn an exchange name (Aero, Uniswap, Virtuals) into its factories, routers, pools and first reads. Call it first when a question names an exchange and gives no address.",
 				"- meta_usage_status: check the caller public free graph_query quota.",
 				"- meta_subscription_status: check the caller CIA subscription window end, daily allowance, consumption, and tier.",
 				"- graph_query: run read-only GQL/Cypher through the universal graph endpoint. Use USE topology or USE facts.",
@@ -1681,6 +1672,7 @@ async function createProxy() {
 				"Available graph-backed tools:",
 				"- meta_network_capabilities: supported networks and available tools. Takes no arguments.",
 				"- meta_schema: read the live graph schema of one network: labels, link types and field names. Cached for 24 hours.",
+				"- meta_dex_lookup: turn an exchange name (Aero, Uniswap, Virtuals) into its factories, routers, pools and first reads. Call it first when a question names an exchange and gives no address.",
 				"- meta_usage_status: check the caller public free graph_query quota.",
 				"- meta_subscription_status: check the caller CIA subscription window end, daily allowance, consumption, and tier.",
 				"- graph_query: run read-only GQL/Cypher through the universal graph endpoint. Use USE topology or USE facts.",
@@ -1792,6 +1784,8 @@ if (process.argv[1] && require("url").pathToFileURL(__filename).href.includes(pr
 //#endregion
 exports.APP_ONLY_LOCAL_TOOL_NAMES = APP_ONLY_LOCAL_TOOL_NAMES;
 exports.CLAUDE_VIEW_URI = CLAUDE_VIEW_URI;
+exports.GRAPH_QUERY_DEX_DOOR_SENTENCE = GRAPH_QUERY_DEX_DOOR_SENTENCE;
+exports.KNOWN_PUBLIC_TOOL_DESCRIPTIONS = KNOWN_PUBLIC_TOOL_DESCRIPTIONS;
 exports.LOCAL_TOOL_NAMES = LOCAL_TOOL_NAMES;
 exports.MCP_APP_MIME_TYPE = MCP_APP_MIME_TYPE;
 exports.PICTURE_RULES = PICTURE_RULES;

package/dist/mcp-proxy.d.cts

@@ -11,6 +11,8 @@ export declare const MCP_APP_MIME_TYPE = "text/html;profile=mcp-app";
 export declare function readClaudeViewHtml(): string;
 export type McpProxyMode = 'workspace' | 'stateless';
 export declare function resolveMcpProxyMode(env?: NodeJS.ProcessEnv): McpProxyMode;
+export declare const GRAPH_QUERY_DEX_DOOR_SENTENCE = "A question that names an exchange and no address starts with meta_dex_lookup, never with a scan of :Protocol, :Pool or labels.";
+export declare const KNOWN_PUBLIC_TOOL_DESCRIPTIONS: Record<string, string>;
 type ToolInputShape = Record<string, z.ZodTypeAny>;
 export declare const PICTURE_RULES: string;
 export declare function knownPublicToolInputSchema(toolName: string): ToolInputShape | null;

package/dist/mcp-proxy.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-proxy.d.cts","names":[],"sources":["../src/mcp/proxy.ts"],"mappings":";;qBAkDa,kBAAgB;qBAYhB,2BAAyB;qBAUzB;qBACA;;;;;wBAyBG;YAkBJ;wBAEI,oBAAoB,MAAK,OAAO,aAA2B;KAsCtE,iBAAiB,eAAe,EAAE;qBAgB1B;wBA2GG,2BAA2B,mBAAmB;;;;;;;;wBAomBxC,eAAe"}
+{"version":3,"file":"mcp-proxy.d.cts","names":[],"sources":["../src/mcp/proxy.ts"],"mappings":";;qBA4Da,kBAAgB;qBAahB,2BAAyB;qBAUzB;qBACA;;;;;wBAyBG;YAkBJ;wBAEI,oBAAoB,MAAK,OAAO,aAA2B;qBAiB9D;qBAGA,gCAAgC;KAuBxC,iBAAiB,eAAe,EAAE;qBAgB1B;wBA2GG,2BAA2B,mBAAmB;;;;;;;;wBAomBxC,eAAe"}

package/dist/mcp-proxy.d.mts

@@ -11,6 +11,8 @@ export declare const MCP_APP_MIME_TYPE = "text/html;profile=mcp-app";
 export declare function readClaudeViewHtml(): string;
 export type McpProxyMode = 'workspace' | 'stateless';
 export declare function resolveMcpProxyMode(env?: NodeJS.ProcessEnv): McpProxyMode;
+export declare const GRAPH_QUERY_DEX_DOOR_SENTENCE = "A question that names an exchange and no address starts with meta_dex_lookup, never with a scan of :Protocol, :Pool or labels.";
+export declare const KNOWN_PUBLIC_TOOL_DESCRIPTIONS: Record<string, string>;
 type ToolInputShape = Record<string, z.ZodTypeAny>;
 export declare const PICTURE_RULES: string;
 export declare function knownPublicToolInputSchema(toolName: string): ToolInputShape | null;

package/dist/mcp-proxy.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-proxy.d.mts","names":[],"sources":["../src/mcp/proxy.ts"],"mappings":";;qBAkDa,kBAAgB;qBAYhB,2BAAyB;qBAUzB;qBACA;;;;;wBAyBG;YAkBJ;wBAEI,oBAAoB,MAAK,OAAO,aAA2B;KAsCtE,iBAAiB,eAAe,EAAE;qBAgB1B;wBA2GG,2BAA2B,mBAAmB;;;;;;;;wBAomBxC,eAAe"}
+{"version":3,"file":"mcp-proxy.d.mts","names":[],"sources":["../src/mcp/proxy.ts"],"mappings":";;qBA4Da,kBAAgB;qBAahB,2BAAyB;qBAUzB;qBACA;;;;;wBAyBG;YAkBJ;wBAEI,oBAAoB,MAAK,OAAO,aAA2B;qBAiB9D;qBAGA,gCAAgC;KAuBxC,iBAAiB,eAAe,EAAE;qBAgB1B;wBA2GG,2BAA2B,mBAAmB;;;;;;;;wBAomBxC,eAAe"}

package/dist/mcp-proxy.mjs

@@ -1,11 +1,13 @@
 import { a as withTimestampTextResult, c as PACKAGE_VERSION, o as withoutUtcProperties } from "./print-result-CJ8d7lmz.mjs";
 import { t as PaymentRequiredError } from "./client-gsLi528K.mjs";
-import { i as isAppOnlyTool, n as PUBLIC_MCP_TOOL_ALLOWED_ARGS, r as PUBLIC_MCP_TOOL_REQUIRED_ARGS, t as HIDDEN_REMOTE_TOOL_NAMES } from "./tool-visibility-kclgGKL5.mjs";
+import { i as isAppOnlyTool, n as PUBLIC_MCP_TOOL_ALLOWED_ARGS, r as PUBLIC_MCP_TOOL_REQUIRED_ARGS, t as HIDDEN_REMOTE_TOOL_NAMES } from "./tool-visibility-Dq-Ruj-8.mjs";
 import { n as primitiveBackendUsageStatus, t as freeTierSpentText } from "./usage-status-Frot6fPG.mjs";
 import { n as unavailableSubscriptionStatus } from "./subscription-status-DA9DCFrC.mjs";
 import { r as mirrorGraphNetworkCapabilities } from "./capabilities-BBVDIECk.mjs";
 import { a as handleMetaSchema, c as GRAPH_EXPAND_TITLE, l as GRAPH_EXPAND_TOOL, n as META_SCHEMA_DESCRIPTION, o as FLOWS_MAX_OFFSET, r as META_SCHEMA_TITLE, s as GRAPH_EXPAND_DESCRIPTION, t as GraphSchemaError, u as handleGraphExpand } from "./graph-schema-DHd2fGbr.mjs";
 import { r as appendActionLog, t as actionLogSignalsFromResult } from "./action-log-D49Par9P.mjs";
+import { i as META_DEX_LOOKUP_TOOL, n as META_DEX_LOOKUP_DESCRIPTION, o as handleMetaDexLookup, r as META_DEX_LOOKUP_TITLE, s as withAnswerHintResult, t as META_DEX_LOOKUP_ANNOTATIONS } from "./dex-tool-DpQKS7Te.mjs";
+import { r as loadRegistry } from "./dex-registry-05wAhSa0.mjs";
 import { fileURLToPath } from "node:url";
 import path from "node:path";
 import { readFileSync } from "node:fs";
@@ -97,17 +99,17 @@ function rateLimitedResult(toolName, err) {
 const BUSY_CODE = "chain_busy";
 const BUSY_WAIT_MS = 1100;
 const defaultSleep = (ms) => new Promise((done) => setTimeout(done, ms));
-function isRecord$3(value) {
+function isRecord$2(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function membersOf(result) {
-	const facts = isRecord$3(result.structuredContent) ? result.structuredContent.facts : void 0;
-	const queries = isRecord$3(facts) ? facts.queries : void 0;
-	return Array.isArray(queries) && queries.every(isRecord$3) ? queries : null;
+	const facts = isRecord$2(result.structuredContent) ? result.structuredContent.facts : void 0;
+	const queries = isRecord$2(facts) ? facts.queries : void 0;
+	return Array.isArray(queries) && queries.every(isRecord$2) ? queries : null;
 }
 function isBusyMember(member) {
 	const detail = member.error_detail;
-	return isRecord$3(detail) && detail.code === BUSY_CODE;
+	return isRecord$2(detail) && detail.code === BUSY_CODE;
 }
 /** The ids of the members the server refused as chain_busy. */
 function busyMemberIds(result) {
@@ -138,7 +140,7 @@ function mergeBatchAnswers(first, again) {
 	const merged = members.map((m) => isBusyMember(m) && byId.has(String(m.id)) ? byId.get(String(m.id)) : m);
 	const structured = first.structuredContent;
 	const facts = structured.facts;
-	const batch = isRecord$3(facts.batch) ? recount(facts.batch, merged) : facts.batch;
+	const batch = isRecord$2(facts.batch) ? recount(facts.batch, merged) : facts.batch;
 	const nextStructured = {
 		...structured,
 		facts: {
@@ -182,7 +184,7 @@ async function withBusyMemberRetry(args, call, sleep = defaultSleep) {
 function isBusyResult(result) {
 	if (!result.isError) return false;
 	const first = Array.isArray(result.content) ? result.content[0] : void 0;
-	const text = isRecord$3(first) && typeof first.text === "string" ? first.text : "";
+	const text = isRecord$2(first) && typeof first.text === "string" ? first.text : "";
 	return /^(Query execution failed: )?chain_busy\b/.test(text.trim());
 }
 /**
@@ -329,7 +331,7 @@ function send(res, status, contentType, body) {
 function sendJson(res, status, value) {
 	send(res, status, "application/json; charset=utf-8", JSON.stringify(value));
 }
-function isRecord$2(value) {
+function isRecord$1(value) {
 	return !!value && typeof value === "object" && !Array.isArray(value);
 }
 var BodyTooLarge = class extends Error {};
@@ -420,8 +422,8 @@ async function startViewServer(options) {
 				sendJson(res, 400, { error: "invalid JSON" });
 				return;
 			}
-			const args = isRecord$2(body) ? body.arguments ?? {} : void 0;
-			if (!isRecord$2(args)) {
+			const args = isRecord$1(body) ? body.arguments ?? {} : void 0;
+			if (!isRecord$1(args)) {
 				sendJson(res, 400, { error: "arguments must be an object" });
 				return;
 			}
@@ -602,52 +604,6 @@ async function connectRemote(options) {
 	};
 }
 //#endregion
-//#region src/mcp/answer-hint.ts
-/**
-* The two answer rules that still slip in long answers, carried on every
-* graph reply in the result's `hint` field. Claude Code has a Stop hook that
-* reads the answer; Codex and Claude Desktop have no such hook, and in the
-* loop's third prompt set they broke one of these two rules in three of
-* thirteen conversations. The reply is the one thing every host hands the
-* model right before it writes, so the rules ride on it. A `hint` the
-* server already set is kept.
-*/
-const ANSWER_HINT = "Answer: write every address in full (0x plus 40 characters), also when it repeats one named earlier and also when the user asks for shorter ones (name them instead); a transfer moves tokens, so write \"tokens worth about N USD\", never \"sent N USD\" or a $ figure; never draw the flows in text, ASCII or Mermaid, the host draws them.";
-function isRecord$1(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/** The structured content with the hint set when the server left it empty. */
-function withAnswerHint(structuredContent) {
-	if (!isRecord$1(structuredContent) || !isRecord$1(structuredContent.facts)) return structuredContent;
-	if (typeof structuredContent.hint === "string" && structuredContent.hint.trim()) return structuredContent;
-	return {
-		...structuredContent,
-		hint: ANSWER_HINT
-	};
-}
-/** A graph tool result whose structured content and single JSON text block both carry the hint. */
-function withAnswerHintResult(result) {
-	const structured = withAnswerHint(result.structuredContent);
-	if (structured === result.structuredContent) return result;
-	const content = result.content ?? [];
-	const only = content.length === 1 && content[0]?.type === "text" ? content[0] : null;
-	let parsed = void 0;
-	try {
-		parsed = only?.text ? JSON.parse(only.text) : void 0;
-	} catch {
-		parsed = void 0;
-	}
-	const textIsStructured = parsed !== void 0 && JSON.stringify(parsed) === JSON.stringify(result.structuredContent);
-	return {
-		...result,
-		structuredContent: structured,
-		content: textIsStructured ? [{
-			...only,
-			text: JSON.stringify(structured)
-		}] : content
-	};
-}
-//#endregion
 //#region src/mcp/proxy.ts
 const LOCAL_TOOL_NAMES = /* @__PURE__ */ new Set([
 	"meta_network_capabilities",
@@ -656,6 +612,7 @@ const LOCAL_TOOL_NAMES = /* @__PURE__ */ new Set([
 	"meta_subscription_status",
 	"meta_help",
 	"meta_rules",
+	META_DEX_LOOKUP_TOOL,
 	"wallet_balance",
 	"wallet_topup",
 	GRAPH_EXPAND_TOOL
@@ -713,15 +670,17 @@ function resolveMcpProxyMode(env = process.env) {
 }
 const GRAPH_LAYERS_TEXT = "Use USE topology for topology (address/FLOWS_TO/OPERATED_BY/LINKED graph with SWAPPED, ADDED_LIQUIDITY, REMOVED_LIQUIDITY, BRIDGED and the Pool, Token and NFT labels, unified recent+historical) and USE facts for bounded TRANSFER, SWAP, LIQUIDITY_ADD, LIQUIDITY_REMOVE and BRIDGE_CROSSING rows and enrichment, and USE chain for the chain node's own record of one known transaction, block, address or the head.";
 const TOOL_RULES_FIRST = "Rules first: if the chain-insights-cypher skill is not loaded in this chat, call meta_rules once before this tool. For a graph, alias the columns from_address and to_address; the host draws the picture from the answer itself. Never draw it again with another tool, such as a visualize or widget tool.";
+const GRAPH_QUERY_DEX_DOOR_SENTENCE = "A question that names an exchange and no address starts with meta_dex_lookup, never with a scan of :Protocol, :Pool or labels.";
 const KNOWN_PUBLIC_TOOL_DESCRIPTIONS = {
 	meta_network_capabilities: "Return the current Chain Insights network and tool support matrix. Takes no arguments: send {}.",
 	meta_schema: META_SCHEMA_DESCRIPTION,
+	[META_DEX_LOOKUP_TOOL]: META_DEX_LOOKUP_DESCRIPTION,
 	meta_usage_status: "Return the caller's public free graph_query quota for the current UTC day.",
 	meta_subscription_status: "Return the caller's CIA subscription window end, daily allowance, consumption, and tier.",
 	meta_help: "Show a short guide to Chain Insights tools and workflow.",
 	meta_rules: "Return the Chain Insights rules: how to write graph_query and graph_query_batch reads that are served, how to name columns so the answer is drawn as a graph, a time series or a table, and how to write the answer. Call it once per chat, before the first graph query, when the chain-insights-cypher skill is not loaded. Takes no arguments: send {}.",
 	wallet_balance: "Show the local Chain Insights payment wallet address, payment network, token, and amount.",
-	graph_query: `${TOOL_RULES_FIRST} Run a read-only GQL/Cypher query through the Chain Insights graph endpoint. ${GRAPH_LAYERS_TEXT} ${ROUTING_NOT_SERVED} Preserve full addresses exactly, and write every address in full, all 42 characters, in your answer: never shorten one with ... or ….`,
+	graph_query: `${TOOL_RULES_FIRST} Run a read-only GQL/Cypher query through the Chain Insights graph endpoint. ${GRAPH_LAYERS_TEXT} ${GRAPH_QUERY_DEX_DOOR_SENTENCE} ${ROUTING_NOT_SERVED} Preserve full addresses exactly, and write every address in full, all 42 characters, in your answer: never shorten one with ... or ….`,
 	graph_query_batch: `${TOOL_RULES_FIRST} Run multiple read-only GQL/Cypher queries through the Chain Insights graph endpoint in one paid batch. Prefer this for related topology/facts reads. For a time series across days, send one USE facts total per day with the query id set to the day, "YYYY-MM-DD": the view joins them into one series. Write every address in full in your answer, all 42 characters.`
 };
 const KNOWN_PUBLIC_TOOL_TITLES = {
@@ -1417,6 +1376,37 @@ async function createProxy() {
 			openWorldHint: true
 		}
 	}, async (args) => handleMetaSchema(args, schemaDependencies));
+	const dexDependencies = {
+		loadRegistry: (network) => loadRegistry(network, { log: (line) => {
+			logger.info("dex_registry.fault", { line });
+		} }),
+		graphQueryBatch: async (args) => {
+			const options = remoteToolRequestOptions("graph_query_batch");
+			const call = (requestArgs) => withRateLimitRetry(() => options ? remoteClient.callTool({
+				name: "graph_query_batch",
+				arguments: requestArgs
+			}, void 0, options) : remoteClient.callTool({
+				name: "graph_query_batch",
+				arguments: requestArgs
+			}));
+			return await withBusyMemberRetry(args, call);
+		},
+		unavailable: async () => {
+			await ensureRemote();
+			return remoteConnected ? void 0 : `${remoteUnavailableMessage ?? `Chain Insights Graph is not connected at ${graphMcpEndpoint}`}.`;
+		},
+		describeFailure: (err) => remoteCallFailureText("graph_query_batch", err)
+	};
+	server.registerTool(META_DEX_LOOKUP_TOOL, {
+		title: META_DEX_LOOKUP_TITLE,
+		description: KNOWN_PUBLIC_TOOL_DESCRIPTIONS[META_DEX_LOOKUP_TOOL],
+		inputSchema: {
+			network: NETWORK_SCHEMA,
+			name: z.string().optional().describe("The exchange as the user wrote it: Aero, Aerodrome, uni v4. With no name, every covered exchange is listed."),
+			pools: z.boolean().optional().describe("Read the biggest pools of the exchange (default true). false sends only Head and the contract reads.")
+		},
+		annotations: META_DEX_LOOKUP_ANNOTATIONS
+	}, async (args) => handleMetaDexLookup(args, dexDependencies));
 	server.registerTool("meta_usage_status", {
 		title: "Usage Status",
 		description: KNOWN_PUBLIC_TOOL_DESCRIPTIONS.meta_usage_status,
@@ -1660,6 +1650,7 @@ async function createProxy() {
 				"Investigation tools:",
 				"- meta_network_capabilities: supported networks and available tools. Takes no arguments.",
 				"- meta_schema: read the live graph schema of one network: labels, link types and field names. Cached for 24 hours.",
+				"- meta_dex_lookup: turn an exchange name (Aero, Uniswap, Virtuals) into its factories, routers, pools and first reads. Call it first when a question names an exchange and gives no address.",
 				"- meta_usage_status: check the caller public free graph_query quota.",
 				"- meta_subscription_status: check the caller CIA subscription window end, daily allowance, consumption, and tier.",
 				"- graph_query: run read-only GQL/Cypher through the universal graph endpoint. Use USE topology or USE facts.",
@@ -1677,6 +1668,7 @@ async function createProxy() {
 				"Available graph-backed tools:",
 				"- meta_network_capabilities: supported networks and available tools. Takes no arguments.",
 				"- meta_schema: read the live graph schema of one network: labels, link types and field names. Cached for 24 hours.",
+				"- meta_dex_lookup: turn an exchange name (Aero, Uniswap, Virtuals) into its factories, routers, pools and first reads. Call it first when a question names an exchange and gives no address.",
 				"- meta_usage_status: check the caller public free graph_query quota.",
 				"- meta_subscription_status: check the caller CIA subscription window end, daily allowance, consumption, and tier.",
 				"- graph_query: run read-only GQL/Cypher through the universal graph endpoint. Use USE topology or USE facts.",
@@ -1786,6 +1778,6 @@ if (process.argv[1] && import.meta.url.includes(process.argv[1].replace(/\\/g, "
 	process.exit(1);
 });
 //#endregion
-export { APP_ONLY_LOCAL_TOOL_NAMES, CLAUDE_VIEW_URI, LOCAL_TOOL_NAMES, MCP_APP_MIME_TYPE, PICTURE_RULES, createProxy, knownPublicToolInputSchema, readClaudeViewHtml, resolveMcpProxyMode };
+export { APP_ONLY_LOCAL_TOOL_NAMES, CLAUDE_VIEW_URI, GRAPH_QUERY_DEX_DOOR_SENTENCE, KNOWN_PUBLIC_TOOL_DESCRIPTIONS, LOCAL_TOOL_NAMES, MCP_APP_MIME_TYPE, PICTURE_RULES, createProxy, knownPublicToolInputSchema, readClaudeViewHtml, resolveMcpProxyMode };
 
 //# sourceMappingURL=mcp-proxy.mjs.map