chain-insights 0.54.2 → 0.55.0

package/dist/mcp-proxy.cjs

@@ -102,7 +102,7 @@ const ROUTING_TWO_FIT = "A transaction is a chain question: read it on `USE chai
 /** The key that each layer hands to the next. Each key keeps its name. */
 const ROUTING_HANDOFF = "The layers hand each other keys, and each key keeps its name. Topology gives the pair and the first and last seen time. Facts gives the `tx_id` and the `block_height`. Chain takes an `address`, a `tx_id`, a `block_height` or a `block_hash`, and gives the `block_date` of a transaction or a block.";
 /** A whole-chain question is a time-bounded topology search; a server without search mode refuses it once. */
-const ROUTING_NOT_SERVED = "A question about the whole chain (recent activity, the biggest senders, a top list) is a `USE topology` search: bound it by time with `f.last_seen_timestamp >= <epoch ms>` on the `FLOWS_TO` link, then sort and `LIMIT`. A search has 10 s. If the server refuses it with `anchor_missing`, it does not serve searches yet: say so in one line and ask for an address.";
+const ROUTING_NOT_SERVED = "A question about the whole chain (recent activity, the biggest senders, a top list) is a `USE topology` search: bound it by time with `f.last_seen_timestamp >= <epoch ms>` on the `FLOWS_TO` link, then sort and `LIMIT`. A search has 10 s. If the server refuses it with `anchor_missing`, or stops it with `query_timeout`, it cannot search the whole chain now: say so in one line and ask for an address. A narrower window times out the same way, so do not send it again.";
 /** What a refusal carries, and which part of it decides the move. */
 const MOVE_INTRO = "A refused, killed, busy or failed query comes back with `error_detail`: `code`, `rule`, `class`, `fix` and `example`. The `class` decides your next move.";
 /** The move for each class of the refusal envelope. */
@@ -346,6 +346,135 @@ async function startViewServer(options) {
 		})
 	};
 }
+Object.freeze(["from_address", "to_address"]);
+/** What a FLOWS_TO link carries: the link panel of the view shows each one. */
+const GRAPH_LINK_COLUMNS = Object.freeze([
+	"amount_usd_sum",
+	"tx_count",
+	"first_seen_timestamp",
+	"last_seen_timestamp"
+]);
+/** What the two addresses of a link carry: labels and the exchange mark on the node. */
+const GRAPH_NODE_COLUMNS = Object.freeze([
+	"from_labels",
+	"to_labels",
+	"from_is_exchange",
+	"to_is_exchange"
+]);
+/** The kind of a link, when a query joins several link types. */
+const GRAPH_KIND_COLUMNS = Object.freeze(["link_kind"]);
+/** Every optional column, in the order the hint names them. */
+const GRAPH_OPTIONAL_COLUMNS = Object.freeze([
+	...GRAPH_LINK_COLUMNS,
+	...GRAPH_KIND_COLUMNS,
+	...GRAPH_NODE_COLUMNS
+]);
+Object.freeze([...GRAPH_LINK_COLUMNS, ...GRAPH_NODE_COLUMNS]);
+/** The `RETURN` tail of a FLOWS_TO recipe over link `f` between `from` and `to`. */
+function flowsRecipeReturn(from, to, link = "f") {
+	return `${from}.address AS from_address, ${to}.address AS to_address, ${link}.amount_usd_sum AS amount_usd_sum, ${link}.tx_count AS tx_count, ${link}.first_seen_timestamp AS first_seen_timestamp, ${link}.last_seen_timestamp AS last_seen_timestamp, ${from}.labels AS from_labels, ${to}.labels AS to_labels, ${from}.is_exchange AS from_is_exchange, ${to}.is_exchange AS to_is_exchange`;
+}
+//#endregion
+//#region src/mcp/remote-connect.ts
+const BUSY = /* @__PURE__ */ new Set([
+	429,
+	502,
+	503,
+	504
+]);
+const NOT_STREAMABLE = /* @__PURE__ */ new Set([404, 405]);
+/** The HTTP status an SDK transport error carries, from its `code` or its text. */
+function httpStatusOf(err) {
+	if (err && typeof err === "object") {
+		const code = err.code;
+		if (typeof code === "number" && code >= 100 && code < 600) return code;
+		const message = err.message;
+		if (typeof message === "string") {
+			const m = /\b(4\d\d|5\d\d)\b/.exec(message);
+			if (m) return Number(m[1]);
+		}
+	}
+	return null;
+}
+/** Milliseconds to wait before the next try: Retry-After when the error names one, else 1 s doubling. */
+function busyDelayMs(err, attempt) {
+	const retryAfter = err?.retryAfter;
+	if (typeof retryAfter === "number" && retryAfter > 0) return Math.min(retryAfter * 1e3, 3e4);
+	return Math.min(1e3 * 2 ** (attempt - 1), 8e3);
+}
+function describeRemoteFailure(endpoint, err, status) {
+	if (status !== null && BUSY.has(status)) return `Chain Insights Graph is at capacity at ${endpoint} (HTTP ${status}, class capacity): wait at least 5 seconds, then send the same query once.`;
+	return `Chain Insights Graph unreachable at ${endpoint}: ${err instanceof Error ? err.message : String(err)}`;
+}
+async function connectRemote(options) {
+	const attempts = Math.max(1, options.attempts ?? 5);
+	const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+	const log = options.log ?? (() => void 0);
+	let lastErr = null;
+	let lastStatus = null;
+	for (let attempt = 1; attempt <= attempts; attempt++) try {
+		await options.connectStreamable();
+		await log("remote.connect", {
+			transport: "streamable_http",
+			endpoint: options.endpoint,
+			attempt
+		});
+		return {
+			connected: true,
+			transport: "streamable_http",
+			retryable: false,
+			attempts: attempt
+		};
+	} catch (err) {
+		lastErr = err;
+		lastStatus = httpStatusOf(err);
+		await log("remote.connect_failed", {
+			transport: "streamable_http",
+			endpoint: options.endpoint,
+			attempt,
+			status: lastStatus
+		});
+		if (lastStatus !== null && BUSY.has(lastStatus) && attempt < attempts) {
+			await sleep(busyDelayMs(err, attempt));
+			continue;
+		}
+		break;
+	}
+	if (!(lastStatus !== null && BUSY.has(lastStatus))) try {
+		await options.connectSse();
+		await log("remote.connect", {
+			transport: "sse",
+			endpoint: options.endpoint
+		});
+		return {
+			connected: true,
+			transport: "sse",
+			retryable: false,
+			attempts
+		};
+	} catch (err2) {
+		await log("remote.connect_failed", {
+			transport: "sse",
+			endpoint: options.endpoint,
+			status: httpStatusOf(err2)
+		});
+		const named = lastStatus !== null && NOT_STREAMABLE.has(lastStatus) ? err2 : lastErr;
+		return {
+			connected: false,
+			transport: null,
+			retryable: false,
+			attempts,
+			message: describeRemoteFailure(options.endpoint, named, null)
+		};
+	}
+	return {
+		connected: false,
+		transport: null,
+		retryable: true,
+		attempts,
+		message: describeRemoteFailure(options.endpoint, lastErr, lastStatus)
+	};
+}
 //#endregion
 //#region src/mcp/proxy.ts
 const LOCAL_TOOL_NAMES = /* @__PURE__ */ new Set([
@@ -433,7 +562,7 @@ const EMPTY_INPUT_SCHEMA = zod.strictObject({});
 const REMOTE_GRAPH_TOOL_REQUEST_TIMEOUT_MS = 9e5;
 const PICTURE_RULES = [
 	"Pictures: hosts that draw views, such as Claude Desktop and the Codex app, draw a graph_query answer from its column names. No other tool is needed. Choose the picture by the question: who sent to whom, flows and routes are a graph; how something changed over time is a time series; a list, a lookup or the details of one thing is a table.",
-	"- Rows with from_address and to_address columns draw a graph of at most 5,000 addresses. Optional columns: amount_usd_sum, tx_count, first_seen_timestamp, last_seen_timestamp, link_kind, from_labels, to_labels. Example: USE topology MATCH (a:Address {address: $addr})-[f:FLOWS_TO]->(b:Address) WHERE NOT a:Pool RETURN a.address AS from_address, b.address AS to_address, f.amount_usd_sum AS amount_usd_sum, f.tx_count AS tx_count, f.first_seen_timestamp AS first_seen_timestamp, f.last_seen_timestamp AS last_seen_timestamp ORDER BY f.last_seen_timestamp DESC LIMIT 25",
+	`- Rows with from_address and to_address columns draw a graph of at most 5,000 addresses. Optional columns: ${GRAPH_OPTIONAL_COLUMNS.join(", ")}. A recipe that draws a graph returns all of them; a column it leaves out shows as Unavailable in the drawn link. Example: USE topology MATCH (a:Address {address: $addr})-[f:FLOWS_TO]->(b:Address) WHERE NOT a:Pool RETURN ${flowsRecipeReturn("a", "b")} ORDER BY f.last_seen_timestamp DESC LIMIT 25`,
 	"- Rows with a day, date, hour, week, month or *_timestamp column, number columns, no address in any value and at least 3 distinct times draw a time series. Within one day, the transfers of a known pair: USE facts MATCH (a:Address {address: $from})-[t:TRANSFER]->(b:Address {address: $to}) WHERE t.block_date = \"YYYY-MM-DD\" RETURN t.block_timestamp AS block_timestamp, t.amount_usd AS amount_usd LIMIT 200",
 	"- Across days: facts reads one day at a time, so send graph_query_batch with one query per day (3 to 20 days), each query id the day as \"YYYY-MM-DD\", each returning one total row: USE facts MATCH (a:Address {address: $from})-[t:TRANSFER]->(b:Address {address: $to}) WHERE t.block_date = \"YYYY-MM-DD\" RETURN count(t) AS tx_count, sum(t.amount_usd) AS amount_usd_sum. The view joins the days into one time series. Do not group by day or name several days in one read: both are refused.",
 	"- Any other rows draw a table.",
@@ -969,37 +1098,35 @@ async function createProxy() {
 		remoteUnavailableMessage = `Chain Insights Graph setup unavailable at ${graphMcpEndpoint}: ${err.message}`;
 		process.stderr.write(`Chain Insights MCP graph tools unavailable: ${remoteUnavailableMessage}. Local Chain Insights tools are still available.\n`);
 	}
-	if (mcpFetch) try {
-		await remoteClient.connect(new _modelcontextprotocol_sdk_client_streamableHttp_js.StreamableHTTPClientTransport(new URL(graphMcpEndpoint), { fetch: mcpFetch }));
-		remoteConnected = true;
-		await logger.info("remote.connect", {
-			transport: "streamable_http",
-			endpoint: graphMcpEndpoint
-		});
-	} catch {
-		await logger.error("remote.connect_failed", {
-			transport: "streamable_http",
-			endpoint: graphMcpEndpoint
+	let remoteRetryable = false;
+	const connectRemoteOnce = async () => {
+		if (!mcpFetch) return;
+		const fetchForRemote = mcpFetch;
+		const result = await connectRemote({
+			endpoint: graphMcpEndpoint,
+			connectStreamable: () => remoteClient.connect(new _modelcontextprotocol_sdk_client_streamableHttp_js.StreamableHTTPClientTransport(new URL(graphMcpEndpoint), { fetch: fetchForRemote })),
+			connectSse: async () => {
+				const { SSEClientTransport } = await import("@modelcontextprotocol/sdk/client/sse.js");
+				await remoteClient.connect(new SSEClientTransport(new URL(graphMcpEndpoint), { fetch: fetchForRemote }));
+			},
+			log: (event, fields) => event === "remote.connect" ? logger.info(event, fields) : logger.error(event, fields)
 		});
-		try {
-			const { SSEClientTransport } = await import("@modelcontextprotocol/sdk/client/sse.js");
-			await remoteClient.connect(new SSEClientTransport(new URL(graphMcpEndpoint), { fetch: mcpFetch }));
-			remoteConnected = true;
-			await logger.info("remote.connect", {
-				transport: "sse",
-				endpoint: graphMcpEndpoint
-			});
-		} catch (err2) {
-			await logger.error("remote.connect_failed", {
-				transport: "sse",
-				endpoint: graphMcpEndpoint,
-				error: errorForLog(err2)
-			});
-			remoteUnavailableMessage = `Chain Insights Graph unreachable at ${graphMcpEndpoint}: ${err2.message}`;
+		remoteConnected = result.connected;
+		remoteRetryable = result.retryable;
+		if (result.connected) {
+			remoteUnavailableMessage = void 0;
+			installRemoteCypherLogging(remoteClient, logger);
+		} else {
+			remoteUnavailableMessage = result.message;
 			process.stderr.write(`Chain Insights MCP graph tools unavailable: ${remoteUnavailableMessage}. Local Chain Insights tools are still available.\n`);
 		}
-	}
-	if (remoteConnected) installRemoteCypherLogging(remoteClient, logger);
+	};
+	await connectRemoteOnce();
+	/** A graph call on a proxy that lost the endpoint to a busy signal tries to connect again, once. */
+	const ensureRemote = async () => {
+		if (remoteConnected || !remoteRetryable) return;
+		await connectRemoteOnce();
+	};
 	let tools = await loadSchema(graphMcpEndpoint);
 	if (!tools && remoteConnected) {
 		tools = (await remoteClient.listTools()).tools;
@@ -1065,6 +1192,7 @@ async function createProxy() {
 	const schemaDependencies = {
 		endpoint: graphMcpEndpoint,
 		withClient: async (fn) => {
+			await ensureRemote();
 			if (!remoteConnected) throw new require_graph_schema.GraphSchemaError(`${remoteUnavailableMessage ?? `Chain Insights Graph is not connected at ${graphMcpEndpoint}`}. Restart the Chain Insights MCP proxy after the endpoint is reachable.`);
 			return fn(remoteClient);
 		},
@@ -1097,6 +1225,7 @@ async function createProxy() {
 		}
 	}, async () => {
 		try {
+			await ensureRemote();
 			if (!remoteConnected) return {
 				content: [{
 					type: "text",
@@ -1145,6 +1274,7 @@ async function createProxy() {
 		}
 	}, async () => {
 		try {
+			await ensureRemote();
 			if (!remoteConnected) return jsonTextResult(require_subscription_status.unavailableSubscriptionStatus(graphMcpEndpoint, remoteUnavailableMessage ?? `Chain Insights Graph is not connected at ${graphMcpEndpoint}`));
 			if (!remoteToolNames.has("subscription_status")) return jsonTextResult(require_subscription_status.unavailableSubscriptionStatus(graphMcpEndpoint, "The graph backend exposes primitive graph tools but no subscription_status tool."));
 			const walletAddress = await localSubscriptionWalletAddress();
@@ -1356,6 +1486,7 @@ async function createProxy() {
 		const inputSchema = knownPublicToolInputSchema(tool.name) ?? zod.object({}).passthrough();
 		const handler = async (args) => {
 			try {
+				await ensureRemote();
 				if (!remoteConnected) return {
 					content: [{
 						type: "text",
@@ -1441,6 +1572,7 @@ if (process.argv[1] && require("url").pathToFileURL(__filename).href.includes(pr
 //#endregion
 exports.CLAUDE_VIEW_URI = CLAUDE_VIEW_URI;
 exports.MCP_APP_MIME_TYPE = MCP_APP_MIME_TYPE;
+exports.PICTURE_RULES = PICTURE_RULES;
 exports.createProxy = createProxy;
 exports.knownPublicToolInputSchema = knownPublicToolInputSchema;
 exports.readClaudeViewHtml = readClaudeViewHtml;

package/dist/mcp-proxy.d.cts

@@ -10,6 +10,7 @@ export declare function readClaudeViewHtml(): string;
 export type McpProxyMode = 'workspace' | 'stateless';
 export declare function resolveMcpProxyMode(env?: NodeJS.ProcessEnv): McpProxyMode;
 type ToolInputShape = Record<string, z.ZodTypeAny>;
+export declare const PICTURE_RULES: string;
 export declare function knownPublicToolInputSchema(toolName: string): ToolInputShape | null;
 /**
  * Core proxy logic — exported so tests can inject dependencies directly.

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

@@ -1 +1 @@
-{"version":3,"file":"mcp-proxy.d.cts","names":[],"sources":["../src/mcp/proxy.ts"],"mappings":";;qBAkEa;qBACA;;;;;wBAyBG;YAkBJ;wBAEI,oBAAoB,MAAK,OAAO,aAA2B;KAsCtE,iBAAiB,eAAe,EAAE;wBAyHvB,2BAA2B,mBAAmB;;;;;;;;wBA+lBxC,eAAe"}
+{"version":3,"file":"mcp-proxy.d.cts","names":[],"sources":["../src/mcp/proxy.ts"],"mappings":";;qBAoEa;qBACA;;;;;wBAyBG;YAkBJ;wBAEI,oBAAoB,MAAK,OAAO,aAA2B;KAsCtE,iBAAiB,eAAe,EAAE;qBAgB1B;wBAyGG,2BAA2B,mBAAmB;;;;;;;;wBA+lBxC,eAAe"}

package/dist/mcp-proxy.d.mts

@@ -10,6 +10,7 @@ export declare function readClaudeViewHtml(): string;
 export type McpProxyMode = 'workspace' | 'stateless';
 export declare function resolveMcpProxyMode(env?: NodeJS.ProcessEnv): McpProxyMode;
 type ToolInputShape = Record<string, z.ZodTypeAny>;
+export declare const PICTURE_RULES: string;
 export declare function knownPublicToolInputSchema(toolName: string): ToolInputShape | null;
 /**
  * Core proxy logic — exported so tests can inject dependencies directly.

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

@@ -1 +1 @@
-{"version":3,"file":"mcp-proxy.d.mts","names":[],"sources":["../src/mcp/proxy.ts"],"mappings":";;qBAkEa;qBACA;;;;;wBAyBG;YAkBJ;wBAEI,oBAAoB,MAAK,OAAO,aAA2B;KAsCtE,iBAAiB,eAAe,EAAE;wBAyHvB,2BAA2B,mBAAmB;;;;;;;;wBA+lBxC,eAAe"}
+{"version":3,"file":"mcp-proxy.d.mts","names":[],"sources":["../src/mcp/proxy.ts"],"mappings":";;qBAoEa;qBACA;;;;;wBAyBG;YAkBJ;wBAEI,oBAAoB,MAAK,OAAO,aAA2B;KAsCtE,iBAAiB,eAAe,EAAE;qBAgB1B;wBAyGG,2BAA2B,mBAAmB;;;;;;;;wBA+lBxC,eAAe"}

package/dist/mcp-proxy.mjs

@@ -98,7 +98,7 @@ const ROUTING_TWO_FIT = "A transaction is a chain question: read it on `USE chai
 /** The key that each layer hands to the next. Each key keeps its name. */
 const ROUTING_HANDOFF = "The layers hand each other keys, and each key keeps its name. Topology gives the pair and the first and last seen time. Facts gives the `tx_id` and the `block_height`. Chain takes an `address`, a `tx_id`, a `block_height` or a `block_hash`, and gives the `block_date` of a transaction or a block.";
 /** A whole-chain question is a time-bounded topology search; a server without search mode refuses it once. */
-const ROUTING_NOT_SERVED = "A question about the whole chain (recent activity, the biggest senders, a top list) is a `USE topology` search: bound it by time with `f.last_seen_timestamp >= <epoch ms>` on the `FLOWS_TO` link, then sort and `LIMIT`. A search has 10 s. If the server refuses it with `anchor_missing`, it does not serve searches yet: say so in one line and ask for an address.";
+const ROUTING_NOT_SERVED = "A question about the whole chain (recent activity, the biggest senders, a top list) is a `USE topology` search: bound it by time with `f.last_seen_timestamp >= <epoch ms>` on the `FLOWS_TO` link, then sort and `LIMIT`. A search has 10 s. If the server refuses it with `anchor_missing`, or stops it with `query_timeout`, it cannot search the whole chain now: say so in one line and ask for an address. A narrower window times out the same way, so do not send it again.";
 /** What a refusal carries, and which part of it decides the move. */
 const MOVE_INTRO = "A refused, killed, busy or failed query comes back with `error_detail`: `code`, `rule`, `class`, `fix` and `example`. The `class` decides your next move.";
 /** The move for each class of the refusal envelope. */
@@ -342,6 +342,135 @@ async function startViewServer(options) {
 		})
 	};
 }
+Object.freeze(["from_address", "to_address"]);
+/** What a FLOWS_TO link carries: the link panel of the view shows each one. */
+const GRAPH_LINK_COLUMNS = Object.freeze([
+	"amount_usd_sum",
+	"tx_count",
+	"first_seen_timestamp",
+	"last_seen_timestamp"
+]);
+/** What the two addresses of a link carry: labels and the exchange mark on the node. */
+const GRAPH_NODE_COLUMNS = Object.freeze([
+	"from_labels",
+	"to_labels",
+	"from_is_exchange",
+	"to_is_exchange"
+]);
+/** The kind of a link, when a query joins several link types. */
+const GRAPH_KIND_COLUMNS = Object.freeze(["link_kind"]);
+/** Every optional column, in the order the hint names them. */
+const GRAPH_OPTIONAL_COLUMNS = Object.freeze([
+	...GRAPH_LINK_COLUMNS,
+	...GRAPH_KIND_COLUMNS,
+	...GRAPH_NODE_COLUMNS
+]);
+Object.freeze([...GRAPH_LINK_COLUMNS, ...GRAPH_NODE_COLUMNS]);
+/** The `RETURN` tail of a FLOWS_TO recipe over link `f` between `from` and `to`. */
+function flowsRecipeReturn(from, to, link = "f") {
+	return `${from}.address AS from_address, ${to}.address AS to_address, ${link}.amount_usd_sum AS amount_usd_sum, ${link}.tx_count AS tx_count, ${link}.first_seen_timestamp AS first_seen_timestamp, ${link}.last_seen_timestamp AS last_seen_timestamp, ${from}.labels AS from_labels, ${to}.labels AS to_labels, ${from}.is_exchange AS from_is_exchange, ${to}.is_exchange AS to_is_exchange`;
+}
+//#endregion
+//#region src/mcp/remote-connect.ts
+const BUSY = /* @__PURE__ */ new Set([
+	429,
+	502,
+	503,
+	504
+]);
+const NOT_STREAMABLE = /* @__PURE__ */ new Set([404, 405]);
+/** The HTTP status an SDK transport error carries, from its `code` or its text. */
+function httpStatusOf(err) {
+	if (err && typeof err === "object") {
+		const code = err.code;
+		if (typeof code === "number" && code >= 100 && code < 600) return code;
+		const message = err.message;
+		if (typeof message === "string") {
+			const m = /\b(4\d\d|5\d\d)\b/.exec(message);
+			if (m) return Number(m[1]);
+		}
+	}
+	return null;
+}
+/** Milliseconds to wait before the next try: Retry-After when the error names one, else 1 s doubling. */
+function busyDelayMs(err, attempt) {
+	const retryAfter = err?.retryAfter;
+	if (typeof retryAfter === "number" && retryAfter > 0) return Math.min(retryAfter * 1e3, 3e4);
+	return Math.min(1e3 * 2 ** (attempt - 1), 8e3);
+}
+function describeRemoteFailure(endpoint, err, status) {
+	if (status !== null && BUSY.has(status)) return `Chain Insights Graph is at capacity at ${endpoint} (HTTP ${status}, class capacity): wait at least 5 seconds, then send the same query once.`;
+	return `Chain Insights Graph unreachable at ${endpoint}: ${err instanceof Error ? err.message : String(err)}`;
+}
+async function connectRemote(options) {
+	const attempts = Math.max(1, options.attempts ?? 5);
+	const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+	const log = options.log ?? (() => void 0);
+	let lastErr = null;
+	let lastStatus = null;
+	for (let attempt = 1; attempt <= attempts; attempt++) try {
+		await options.connectStreamable();
+		await log("remote.connect", {
+			transport: "streamable_http",
+			endpoint: options.endpoint,
+			attempt
+		});
+		return {
+			connected: true,
+			transport: "streamable_http",
+			retryable: false,
+			attempts: attempt
+		};
+	} catch (err) {
+		lastErr = err;
+		lastStatus = httpStatusOf(err);
+		await log("remote.connect_failed", {
+			transport: "streamable_http",
+			endpoint: options.endpoint,
+			attempt,
+			status: lastStatus
+		});
+		if (lastStatus !== null && BUSY.has(lastStatus) && attempt < attempts) {
+			await sleep(busyDelayMs(err, attempt));
+			continue;
+		}
+		break;
+	}
+	if (!(lastStatus !== null && BUSY.has(lastStatus))) try {
+		await options.connectSse();
+		await log("remote.connect", {
+			transport: "sse",
+			endpoint: options.endpoint
+		});
+		return {
+			connected: true,
+			transport: "sse",
+			retryable: false,
+			attempts
+		};
+	} catch (err2) {
+		await log("remote.connect_failed", {
+			transport: "sse",
+			endpoint: options.endpoint,
+			status: httpStatusOf(err2)
+		});
+		const named = lastStatus !== null && NOT_STREAMABLE.has(lastStatus) ? err2 : lastErr;
+		return {
+			connected: false,
+			transport: null,
+			retryable: false,
+			attempts,
+			message: describeRemoteFailure(options.endpoint, named, null)
+		};
+	}
+	return {
+		connected: false,
+		transport: null,
+		retryable: true,
+		attempts,
+		message: describeRemoteFailure(options.endpoint, lastErr, lastStatus)
+	};
+}
 //#endregion
 //#region src/mcp/proxy.ts
 const LOCAL_TOOL_NAMES = /* @__PURE__ */ new Set([
@@ -429,7 +558,7 @@ const EMPTY_INPUT_SCHEMA = z.strictObject({});
 const REMOTE_GRAPH_TOOL_REQUEST_TIMEOUT_MS = 9e5;
 const PICTURE_RULES = [
 	"Pictures: hosts that draw views, such as Claude Desktop and the Codex app, draw a graph_query answer from its column names. No other tool is needed. Choose the picture by the question: who sent to whom, flows and routes are a graph; how something changed over time is a time series; a list, a lookup or the details of one thing is a table.",
-	"- Rows with from_address and to_address columns draw a graph of at most 5,000 addresses. Optional columns: amount_usd_sum, tx_count, first_seen_timestamp, last_seen_timestamp, link_kind, from_labels, to_labels. Example: USE topology MATCH (a:Address {address: $addr})-[f:FLOWS_TO]->(b:Address) WHERE NOT a:Pool RETURN a.address AS from_address, b.address AS to_address, f.amount_usd_sum AS amount_usd_sum, f.tx_count AS tx_count, f.first_seen_timestamp AS first_seen_timestamp, f.last_seen_timestamp AS last_seen_timestamp ORDER BY f.last_seen_timestamp DESC LIMIT 25",
+	`- Rows with from_address and to_address columns draw a graph of at most 5,000 addresses. Optional columns: ${GRAPH_OPTIONAL_COLUMNS.join(", ")}. A recipe that draws a graph returns all of them; a column it leaves out shows as Unavailable in the drawn link. Example: USE topology MATCH (a:Address {address: $addr})-[f:FLOWS_TO]->(b:Address) WHERE NOT a:Pool RETURN ${flowsRecipeReturn("a", "b")} ORDER BY f.last_seen_timestamp DESC LIMIT 25`,
 	"- Rows with a day, date, hour, week, month or *_timestamp column, number columns, no address in any value and at least 3 distinct times draw a time series. Within one day, the transfers of a known pair: USE facts MATCH (a:Address {address: $from})-[t:TRANSFER]->(b:Address {address: $to}) WHERE t.block_date = \"YYYY-MM-DD\" RETURN t.block_timestamp AS block_timestamp, t.amount_usd AS amount_usd LIMIT 200",
 	"- Across days: facts reads one day at a time, so send graph_query_batch with one query per day (3 to 20 days), each query id the day as \"YYYY-MM-DD\", each returning one total row: USE facts MATCH (a:Address {address: $from})-[t:TRANSFER]->(b:Address {address: $to}) WHERE t.block_date = \"YYYY-MM-DD\" RETURN count(t) AS tx_count, sum(t.amount_usd) AS amount_usd_sum. The view joins the days into one time series. Do not group by day or name several days in one read: both are refused.",
 	"- Any other rows draw a table.",
@@ -965,37 +1094,35 @@ async function createProxy() {
 		remoteUnavailableMessage = `Chain Insights Graph setup unavailable at ${graphMcpEndpoint}: ${err.message}`;
 		process.stderr.write(`Chain Insights MCP graph tools unavailable: ${remoteUnavailableMessage}. Local Chain Insights tools are still available.\n`);
 	}
-	if (mcpFetch) try {
-		await remoteClient.connect(new StreamableHTTPClientTransport(new URL(graphMcpEndpoint), { fetch: mcpFetch }));
-		remoteConnected = true;
-		await logger.info("remote.connect", {
-			transport: "streamable_http",
-			endpoint: graphMcpEndpoint
-		});
-	} catch {
-		await logger.error("remote.connect_failed", {
-			transport: "streamable_http",
-			endpoint: graphMcpEndpoint
+	let remoteRetryable = false;
+	const connectRemoteOnce = async () => {
+		if (!mcpFetch) return;
+		const fetchForRemote = mcpFetch;
+		const result = await connectRemote({
+			endpoint: graphMcpEndpoint,
+			connectStreamable: () => remoteClient.connect(new StreamableHTTPClientTransport(new URL(graphMcpEndpoint), { fetch: fetchForRemote })),
+			connectSse: async () => {
+				const { SSEClientTransport } = await import("@modelcontextprotocol/sdk/client/sse.js");
+				await remoteClient.connect(new SSEClientTransport(new URL(graphMcpEndpoint), { fetch: fetchForRemote }));
+			},
+			log: (event, fields) => event === "remote.connect" ? logger.info(event, fields) : logger.error(event, fields)
 		});
-		try {
-			const { SSEClientTransport } = await import("@modelcontextprotocol/sdk/client/sse.js");
-			await remoteClient.connect(new SSEClientTransport(new URL(graphMcpEndpoint), { fetch: mcpFetch }));
-			remoteConnected = true;
-			await logger.info("remote.connect", {
-				transport: "sse",
-				endpoint: graphMcpEndpoint
-			});
-		} catch (err2) {
-			await logger.error("remote.connect_failed", {
-				transport: "sse",
-				endpoint: graphMcpEndpoint,
-				error: errorForLog(err2)
-			});
-			remoteUnavailableMessage = `Chain Insights Graph unreachable at ${graphMcpEndpoint}: ${err2.message}`;
+		remoteConnected = result.connected;
+		remoteRetryable = result.retryable;
+		if (result.connected) {
+			remoteUnavailableMessage = void 0;
+			installRemoteCypherLogging(remoteClient, logger);
+		} else {
+			remoteUnavailableMessage = result.message;
 			process.stderr.write(`Chain Insights MCP graph tools unavailable: ${remoteUnavailableMessage}. Local Chain Insights tools are still available.\n`);
 		}
-	}
-	if (remoteConnected) installRemoteCypherLogging(remoteClient, logger);
+	};
+	await connectRemoteOnce();
+	/** A graph call on a proxy that lost the endpoint to a busy signal tries to connect again, once. */
+	const ensureRemote = async () => {
+		if (remoteConnected || !remoteRetryable) return;
+		await connectRemoteOnce();
+	};
 	let tools = await loadSchema(graphMcpEndpoint);
 	if (!tools && remoteConnected) {
 		tools = (await remoteClient.listTools()).tools;
@@ -1061,6 +1188,7 @@ async function createProxy() {
 	const schemaDependencies = {
 		endpoint: graphMcpEndpoint,
 		withClient: async (fn) => {
+			await ensureRemote();
 			if (!remoteConnected) throw new GraphSchemaError(`${remoteUnavailableMessage ?? `Chain Insights Graph is not connected at ${graphMcpEndpoint}`}. Restart the Chain Insights MCP proxy after the endpoint is reachable.`);
 			return fn(remoteClient);
 		},
@@ -1093,6 +1221,7 @@ async function createProxy() {
 		}
 	}, async () => {
 		try {
+			await ensureRemote();
 			if (!remoteConnected) return {
 				content: [{
 					type: "text",
@@ -1141,6 +1270,7 @@ async function createProxy() {
 		}
 	}, async () => {
 		try {
+			await ensureRemote();
 			if (!remoteConnected) return jsonTextResult(unavailableSubscriptionStatus(graphMcpEndpoint, remoteUnavailableMessage ?? `Chain Insights Graph is not connected at ${graphMcpEndpoint}`));
 			if (!remoteToolNames.has("subscription_status")) return jsonTextResult(unavailableSubscriptionStatus(graphMcpEndpoint, "The graph backend exposes primitive graph tools but no subscription_status tool."));
 			const walletAddress = await localSubscriptionWalletAddress();
@@ -1352,6 +1482,7 @@ async function createProxy() {
 		const inputSchema = knownPublicToolInputSchema(tool.name) ?? z.object({}).passthrough();
 		const handler = async (args) => {
 			try {
+				await ensureRemote();
 				if (!remoteConnected) return {
 					content: [{
 						type: "text",
@@ -1435,6 +1566,6 @@ if (process.argv[1] && import.meta.url.includes(process.argv[1].replace(/\\/g, "
 	process.exit(1);
 });
 //#endregion
-export { CLAUDE_VIEW_URI, MCP_APP_MIME_TYPE, createProxy, knownPublicToolInputSchema, readClaudeViewHtml, resolveMcpProxyMode };
+export { CLAUDE_VIEW_URI, MCP_APP_MIME_TYPE, PICTURE_RULES, createProxy, knownPublicToolInputSchema, readClaudeViewHtml, resolveMcpProxyMode };
 
 //# sourceMappingURL=mcp-proxy.mjs.map