chain-insights 0.44.1 → 0.46.2

package/README.md

@@ -8,9 +8,9 @@
 [![OpenSSF Scorecard](https://img.shields.io/ossf-scorecard/github.com/chainswarm/chain-insights)](https://securityscorecards.dev/viewer/?uri=github.com/chainswarm/chain-insights)
 [![License](https://img.shields.io/npm/l/chain-insights)](https://github.com/chainswarm/chain-insights/blob/main/LICENSE)
 
-  *Follow the funds. Find the obvious.*
+_Follow the funds. Find the obvious._
 
-  [Website](https://chain-insights.ai) | [npm](https://www.npmjs.com/package/chain-insights) | [Quickstart](#quickstart)
+[Website](https://chain-insights.ai) | [npm](https://www.npmjs.com/package/chain-insights) | [Quickstart](#quickstart)
 </div>
 
 Chain Insights is open-source AML and forensics infrastructure for AI agents
@@ -30,6 +30,7 @@ npx chain-insights@latest --help   # run without installing
 npm install -g chain-insights      # or install the cia CLI globally
 cia networks                       # network status + dataset overview
 cia network robinhood              # details for one network
+cia network robinhood --schema     # live graph schema, cached for 24 hours
 cia mcp tools                      # list remote graph tools
 ```
 
@@ -117,6 +118,7 @@ Never touches:
 | `graph_query`               | Run one read-only GQL/Cypher query against a Chain Insights Graph layer            |
 | `graph_query_batch`         | Run related read-only graph queries as one MCP call                                |
 | `meta_network_capabilities` | Check supported Chain Insights networks and graph tools                            |
+| `meta_schema`               | Read the live graph schema of a network: labels, link types, fields, indexes       |
 | `meta_usage_status`         | Check the caller's daily free-tier graph query allowance                           |
 | `meta_help`                 | Show Chain Insights tool and workflow guidance                                     |
 | `wallet_balance`            | Show the local payment wallet amount                                               |
@@ -179,13 +181,14 @@ Graph queries choose the read graph explicitly:
 | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `topology` | The unified address / FLOWS_TO / OPERATED_BY / LINKED graph — recent and full historical fund-flow traversal, and swap, liquidity-pool and bridge totals (see [Graph tools](docs/graph-tools.md#swaps-liquidity-pools-and-bridges)) |
 | `facts`    | Bounded individual `TRANSFER` rows with amount, `amount_usd`, asset, transaction, and block facts, plus single `SWAP`, `LIQUIDITY_ADD`, `LIQUIDITY_REMOVE` and `BRIDGE_CROSSING` rows                                                                                           |
+| `chain`    | One keyed lookup on the chain node: a transaction by `tx_id`, a block by `block_height` or `block_hash`, an address at one block (balance, nonce, kind), or the head                                                                                                            |
 
 One rule is worth reading before writing a query by hand: the `network`
-argument selects the graph, not the addresses inside it. The address-space
-split lives on the `:Address.network` node property. A `USE topology` match
-on `:Address` without an exact address must scope itself with
-`WHERE a.network = "..."`. On `USE facts` each network has its own backing
-database and `Address` carries no `network` property at all. See
+argument selects the graph. `network` is also a property of every node and
+relationship on every layer, and its value is the query's `network`. It is never
+stored, except on a `:Chain` node, so a filter on it narrows nothing: anchor on
+an address instead. A thing has one name on every layer: `address`, `tx_id`,
+`block_height` and `block_hash`, with time in epoch milliseconds. See
 [Graph query compatibility](docs/graph-query-compatibility.md).
 
 Agent installs include `chain-insights-cypher` for graph-query dialect rules,

package/dist/cache-location-BO2XkfgI.mjs

@@ -0,0 +1,11 @@
+import path from "node:path";
+import os from "node:os";
+//#region src/mcp/cache-location.ts
+const CACHE_TTL_MS = 864e5;
+function chainInsightsHome() {
+	return path.join(os.homedir(), ".chain-insights");
+}
+//#endregion
+export { chainInsightsHome as n, CACHE_TTL_MS as t };
+
+//# sourceMappingURL=cache-location-BO2XkfgI.mjs.map

package/dist/cache-location-BO2XkfgI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-location-BO2XkfgI.mjs","names":[],"sources":["../src/mcp/cache-location.ts"],"sourcesContent":["import path from 'node:path'\nimport os from 'node:os'\n\n// One home and one lifetime for every file cache of the package: the tool list\n// (mcp-schema.json) and the graph schema (cache/schema-<network>-<endpoint>.json).\n// The home is read at call time so a test can point HOME at a temporary\n// directory.\n\nexport const CACHE_TTL_MS = 24 * 60 * 60 * 1000 // 24 hours\n\nexport function chainInsightsHome(): string {\n  return path.join(os.homedir(), '.chain-insights')\n}\n"],"mappings":";;;AAQA,MAAa,eAAe;AAE5B,SAAgB,oBAA4B;CAC1C,OAAO,KAAK,KAAK,GAAG,QAAQ,GAAG,iBAAiB;AAClD"}

package/dist/cache-location-CBVzUIxq.cjs

@@ -0,0 +1,23 @@
+const require_rolldown_runtime = require("./rolldown-runtime-C0BPl7ul.cjs");
+let node_path = require("node:path");
+node_path = require_rolldown_runtime.__toESM(node_path, 1);
+let node_os = require("node:os");
+node_os = require_rolldown_runtime.__toESM(node_os, 1);
+//#region src/mcp/cache-location.ts
+const CACHE_TTL_MS = 864e5;
+function chainInsightsHome() {
+	return node_path.default.join(node_os.default.homedir(), ".chain-insights");
+}
+//#endregion
+Object.defineProperty(exports, "CACHE_TTL_MS", {
+	enumerable: true,
+	get: function() {
+		return CACHE_TTL_MS;
+	}
+});
+Object.defineProperty(exports, "chainInsightsHome", {
+	enumerable: true,
+	get: function() {
+		return chainInsightsHome;
+	}
+});

package/dist/{capabilities-A8fsfP24.cjs → capabilities-BGkL9yAr.cjs}

@@ -203,6 +203,12 @@ Object.defineProperty(exports, "capabilities_exports", {
 		return capabilities_exports;
 	}
 });
+Object.defineProperty(exports, "findNetworkCapability", {
+	enumerable: true,
+	get: function() {
+		return findNetworkCapability;
+	}
+});
 Object.defineProperty(exports, "mirrorGraphNetworkCapabilities", {
 	enumerable: true,
 	get: function() {

package/dist/{capabilities-DfWL6n_g.mjs → capabilities-Cur8x6c7.mjs}

@@ -197,6 +197,6 @@ function formatNetworkCapability(network) {
 	return rows.map(([label, value]) => `${label.padEnd(labelWidth)}  ${value}`).join("\n");
 }
 //#endregion
-export { mirrorGraphNetworkCapabilities as n, capabilities_exports as t };
+export { findNetworkCapability as n, mirrorGraphNetworkCapabilities as r, capabilities_exports as t };
 
-//# sourceMappingURL=capabilities-DfWL6n_g.mjs.map
+//# sourceMappingURL=capabilities-Cur8x6c7.mjs.map

package/dist/capabilities-Cur8x6c7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities-Cur8x6c7.mjs","names":[],"sources":["../src/mcp/capabilities.ts"],"sourcesContent":["import type { InvestigatorConfig } from '../config/schema.js'\nimport { applyMcpAuthHeaders, resolveGraphMcpEndpoint } from './client.js'\n\nexport interface NetworkTopologyLayer {\n  enabled: boolean\n  coverage?: {\n    from_block?: number\n    to_block?: number\n    from_timestamp?: string\n    to_timestamp?: string\n    chain_tip_block?: number\n    blocks_behind_tip?: number\n    /** Lowest height among the raw-data lanes that have started. Above it an empty answer may mean \"not indexed yet\". */\n    complete_through_block?: number\n  }\n}\n\nexport interface NetworkLayerCapability {\n  enabled: boolean\n  live?: NetworkTopologyLayer\n  archive?: NetworkTopologyLayer\n  /** The relationships a facts layer serves, when the server lists them. */\n  relationships?: string[]\n}\n\n/**\n * A block the server publishes about one layer's limits. The mirror repeats it\n * exactly as it came: the members named below are the ones known today, and\n * any other member the server adds is kept. Read a limit from the block, never\n * from a number written elsewhere.\n */\nexport type NetworkAdmissionBlock = Record<string, unknown>\n\n/** `USE chain`: the lookups, the ceilings and the slots of the chain layer. */\nexport interface ChainAdmission extends NetworkAdmissionBlock {\n  enabled: boolean\n  /** ok, or the reason the layer is off or behind. */\n  status?: string\n  rules_version?: string\n  grammar?: string\n  /** The labels of `USE chain`, such as Transaction, Block, Head and Address. */\n  lookups?: string[]\n  ceiling_seconds?: Record<string, number>\n  slots?: number\n  past_slots?: number\n  slots_per_caller?: number\n  calls_per_second_per_caller?: number\n  batch_max?: number\n  call_gas?: number\n  head_ttl_ms?: number\n  max_head_age_seconds?: number\n  /** How many blocks below the tip a past `Address` read (`at_block`) must be. Read it here, never write it down. */\n  at_block_min_depth?: number\n}\n\n/** `USE topology`: the shape rules, when the server publishes them. */\nexport interface TopologyAdmission extends NetworkAdmissionBlock {\n  rules_version?: string\n  max_hops_per_path?: number\n  max_limit?: number\n  slots?: number\n}\n\n/** `USE facts`: the read contract, when the server publishes it. */\nexport interface FactsAdmission extends NetworkAdmissionBlock {\n  rules_version?: string\n  window_days?: number\n  max_rows?: number\n  max_hops?: number\n}\n\nexport interface NetworkCapability {\n  network: string\n  display_name?: string\n  status: string\n  default?: boolean\n  /** The layers as the server sent them. Absent when the server sent none. */\n  layers?: Record<string, NetworkLayerCapability>\n  tools: Record<string, string>\n  /** The three layer blocks below are repeated exactly as sent, and absent when not sent. */\n  chain_admission?: ChainAdmission\n  topology_admission?: TopologyAdmission\n  facts_admission?: FactsAdmission\n  coverage?: {\n    from_block?: number\n    to_block?: number\n    from_timestamp?: string\n    to_timestamp?: string\n    chain_tip_block?: number\n    blocks_behind_tip?: number\n    /** Lowest height among the raw-data lanes that have started. Above it an empty answer may mean \"not indexed yet\". */\n    complete_through_block?: number\n  }\n  freshness?: {\n    last_processed_at?: string\n    last_successful_sync_at?: string\n    max_data_age_seconds?: number\n    last_processing_duration_seconds?: number\n  }\n  lane_progress?: NetworkLaneProgress[]\n  graph_progress?: NetworkGraphProgress\n}\n\n/** One writer lane's committed height. null: the lane has not started. */\nexport interface NetworkLaneProgress {\n  lane: string\n  height: number | null\n}\n\n/** How far each block layer of the topology graph reaches, and their lowest. */\nexport interface NetworkGraphProgress {\n  complete_through_block: number\n  layers: { layer: string; position: number }[]\n}\n\nexport interface NetworkCapabilitiesDocument {\n  schema: 'chain-insights.network-capabilities.v1'\n  networks: NetworkCapability[]\n}\n\nconst AVAILABLE_TOOLS_PER_LINE = 3\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction advertisedTools(raw: unknown): Record<string, string> {\n  if (!isRecord(raw)) return {}\n  const tools: Record<string, string> = {}\n  for (const [name, status] of Object.entries(raw)) {\n    if (name.trim() !== '' && typeof status === 'string') tools[name] = status\n  }\n  return tools\n}\n\nfunction advertisedLaneProgress(raw: unknown): NetworkLaneProgress[] | undefined {\n  if (!Array.isArray(raw)) return undefined\n  const lanes: NetworkLaneProgress[] = []\n  for (const entry of raw) {\n    if (!isRecord(entry) || typeof entry.lane !== 'string' || entry.lane.trim() === '') continue\n    if (typeof entry.height === 'number') lanes.push({ lane: entry.lane, height: entry.height })\n    else if (entry.height === null) lanes.push({ lane: entry.lane, height: null })\n  }\n  return lanes\n}\n\nfunction advertisedGraphProgress(raw: unknown): NetworkGraphProgress | undefined {\n  if (!isRecord(raw) || typeof raw.complete_through_block !== 'number') return undefined\n  if (!Array.isArray(raw.layers)) return undefined\n  const layers: NetworkGraphProgress['layers'] = []\n  for (const entry of raw.layers) {\n    if (!isRecord(entry) || typeof entry.layer !== 'string' || typeof entry.position !== 'number')\n      continue\n    layers.push({ layer: entry.layer, position: entry.position })\n  }\n  return { complete_through_block: raw.complete_through_block, layers }\n}\n\nfunction advertisedNetwork(raw: unknown): NetworkCapability | null {\n  if (!isRecord(raw) || typeof raw.network !== 'string' || raw.network.trim() === '') {\n    return null\n  }\n  const network = raw.network.trim()\n  const capability: NetworkCapability = {\n    network,\n    display_name:\n      typeof raw.display_name === 'string' && raw.display_name.trim() !== ''\n        ? raw.display_name\n        : network,\n    status: typeof raw.status === 'string' && raw.status.trim() !== '' ? raw.status : 'live',\n    tools: advertisedTools(raw.tools),\n  }\n  // The layer blocks are the server's own words about its limits. They pass\n  // through exactly as sent: nothing is added, no default is invented and no\n  // member is dropped. A block the server did not send stays absent.\n  if (isRecord(raw.layers)) capability.layers = raw.layers as NetworkCapability['layers']\n  if (isRecord(raw.chain_admission)) {\n    capability.chain_admission = raw.chain_admission as unknown as ChainAdmission\n  }\n  if (isRecord(raw.topology_admission)) {\n    capability.topology_admission = raw.topology_admission as TopologyAdmission\n  }\n  if (isRecord(raw.facts_admission)) {\n    capability.facts_admission = raw.facts_admission as FactsAdmission\n  }\n  if (raw.default === true) capability.default = true\n  if (raw.default === false) capability.default = false\n  if (isRecord(raw.coverage)) capability.coverage = raw.coverage as NetworkCapability['coverage']\n  if (isRecord(raw.freshness))\n    capability.freshness = raw.freshness as NetworkCapability['freshness']\n  const laneProgress = advertisedLaneProgress(raw.lane_progress)\n  if (laneProgress) capability.lane_progress = laneProgress\n  const graphProgress = advertisedGraphProgress(raw.graph_progress)\n  if (graphProgress) capability.graph_progress = graphProgress\n  return capability\n}\n\n/** Repeat GraphRAG's network list. CIA does not add, drop, or invent names. */\nexport function mirrorGraphNetworkCapabilities(document: {\n  networks: unknown[]\n}): NetworkCapabilitiesDocument {\n  return {\n    schema: 'chain-insights.network-capabilities.v1',\n    networks: document.networks\n      .map((network) => advertisedNetwork(network))\n      .filter((network): network is NetworkCapability => network !== null),\n  }\n}\n\nfunction publicNetworkCapabilities(\n  document: NetworkCapabilitiesDocument\n): NetworkCapabilitiesDocument {\n  return mirrorGraphNetworkCapabilities(document)\n}\n\nfunction metadataNetworksUrl(endpoint: string): URL {\n  const url = new URL(endpoint)\n  url.pathname = '/metadata/networks'\n  url.search = ''\n  url.hash = ''\n  return url\n}\n\nexport async function fetchNetworkCapabilities(\n  config: Pick<InvestigatorConfig, 'graphMcpAuthToken' | 'graphMcpMode' | 'graphMcpEndpoint'>\n): Promise<NetworkCapabilitiesDocument> {\n  const endpoint = resolveGraphMcpEndpoint(config)\n  const request = metadataNetworksUrl(endpoint)\n  const headers = new Headers()\n  const token = config.graphMcpAuthToken?.trim()\n  if (token) {\n    applyMcpAuthHeaders(headers, token)\n  }\n  let response: Response\n  try {\n    response = await fetch(request, { headers })\n  } catch (err) {\n    throw new Error(`network capabilities unavailable at ${request}: ${(err as Error).message}`)\n  }\n  if (!response.ok) {\n    throw new Error(`network capabilities unavailable at ${request}: HTTP ${response.status}`)\n  }\n  const parsed = (await response.json()) as NetworkCapabilitiesDocument\n  if (\n    parsed.schema !== 'chain-insights.network-capabilities.v1' ||\n    !Array.isArray(parsed.networks)\n  ) {\n    throw new Error('network capabilities response has unsupported schema')\n  }\n  return publicNetworkCapabilities(parsed)\n}\n\nfunction availableTools(network: NetworkCapability): string[] {\n  const tools = Object.entries(network.tools ?? {})\n    .filter(([, status]) => status === 'available')\n    .map(([name]) => name)\n  return tools.sort()\n}\n\nfunction availableToolLines(network: NetworkCapability): string[] {\n  const tools = availableTools(network)\n  if (tools.length === 0) return ['none']\n  const lines: string[] = []\n  for (let index = 0; index < tools.length; index += AVAILABLE_TOOLS_PER_LINE) {\n    lines.push(tools.slice(index, index + AVAILABLE_TOOLS_PER_LINE).join(', '))\n  }\n  return lines\n}\n\nfunction shortDate(value?: string): string {\n  if (!value) return ''\n  return value.slice(0, 10)\n}\n\nfunction datasetLabel(network: NetworkCapability): string {\n  const coverage = network.coverage\n  if (!coverage) return 'unknown'\n  const blockRange =\n    coverage.from_block !== undefined && coverage.to_block !== undefined\n      ? `${coverage.from_block}..${coverage.to_block}`\n      : 'blocks unknown'\n  const dateRange =\n    coverage.from_timestamp && coverage.to_timestamp\n      ? `${shortDate(coverage.from_timestamp)}..${shortDate(coverage.to_timestamp)}`\n      : ''\n  if (blockRange === 'blocks unknown' && dateRange === '') return 'unknown'\n  if (blockRange === 'blocks unknown') return dateRange\n  if (dateRange === '') return blockRange\n  return `${blockRange} / ${dateRange}`\n}\n\nfunction displayName(network: NetworkCapability): string {\n  return network.display_name || network.network\n}\n\nfunction statusLabel(network: NetworkCapability): string {\n  return network.default ? `${network.status} (default)` : network.status\n}\n\nfunction formatTable(headers: string[], rows: string[][], minimumWidths: number[]): string {\n  const widths = headers.map((header, index) =>\n    Math.max(\n      minimumWidths[index] ?? 0,\n      header.length,\n      ...rows.map((row) => row[index]?.length ?? 0)\n    )\n  )\n  const row = (values: string[]) =>\n    values.map((value, index) => value.padEnd(widths[index]!)).join('  ')\n  return [row(headers), widths.map((width) => '-'.repeat(width)).join('  '), ...rows.map(row)].join(\n    '\\n'\n  )\n}\n\nexport function formatNetworkOverview(document: NetworkCapabilitiesDocument): string {\n  if (document.networks.length === 0) return 'No supported networks advertised.'\n  const rows = document.networks.map((network) => [\n    displayName(network),\n    statusLabel(network),\n    datasetLabel(network),\n  ])\n  return formatTable(['Network', 'Status', 'Dataset'], rows, [14, 10, 38])\n}\n\nexport function formatNetworkCapabilities(document: NetworkCapabilitiesDocument): string {\n  if (document.networks.length === 0) return 'No supported networks advertised.'\n  const networkRows = document.networks.flatMap((network) => {\n    const toolLines = availableToolLines(network)\n    return toolLines.map((toolLine, index) => [\n      index === 0 ? displayName(network) : '',\n      index === 0 ? datasetLabel(network) : '',\n      toolLine,\n    ])\n  })\n  return formatTable(['Network', 'Dataset', 'Chain Insights tools'], networkRows, [14, 38, 64])\n}\n\nexport function findNetworkCapability(\n  document: NetworkCapabilitiesDocument,\n  name: string\n): NetworkCapability | undefined {\n  const normalizedName = name.trim().toLowerCase()\n  if (!normalizedName) return undefined\n  return document.networks.find((network) =>\n    [network.network, network.display_name].some(\n      (candidate) => candidate?.trim().toLowerCase() === normalizedName\n    )\n  )\n}\n\nexport function formatNetworkCapability(network: NetworkCapability): string {\n  const rows = [\n    ['Network', network.display_name || network.network],\n    ['Identifier', network.network],\n    ['Status', network.default ? `${network.status} (default)` : network.status],\n    ['Dataset', datasetLabel(network)],\n    ['Available tools', availableTools(network).join(', ') || 'none'],\n  ]\n  const labelWidth = Math.max(...rows.map(([label]) => label.length))\n  return rows.map(([label, value]) => `${label.padEnd(labelWidth)}  ${value}`).join('\\n')\n}\n"],"mappings":"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"}

package/dist/cli.cjs

@@ -120,21 +120,21 @@ async function withGraphMcpClient(name, fn) {
 }
 async function printNetworkCapabilities(opts) {
 	const { loadConfig } = await Promise.resolve().then(() => require("./config-BxtMoo9c.cjs")).then((n) => n.config_exports);
-	const { fetchNetworkCapabilities, formatNetworkCapabilities } = await Promise.resolve().then(() => require("./capabilities-A8fsfP24.cjs")).then((n) => n.capabilities_exports);
+	const { fetchNetworkCapabilities, formatNetworkCapabilities } = await Promise.resolve().then(() => require("./capabilities-BGkL9yAr.cjs")).then((n) => n.capabilities_exports);
 	const document = await fetchNetworkCapabilities(await loadConfig());
 	if (opts.json) console.log(JSON.stringify(document, null, 2));
 	else console.log(formatNetworkCapabilities(document));
 }
 async function printNetworkOverview(opts) {
 	const { loadConfig } = await Promise.resolve().then(() => require("./config-BxtMoo9c.cjs")).then((n) => n.config_exports);
-	const { fetchNetworkCapabilities, formatNetworkOverview } = await Promise.resolve().then(() => require("./capabilities-A8fsfP24.cjs")).then((n) => n.capabilities_exports);
+	const { fetchNetworkCapabilities, formatNetworkOverview } = await Promise.resolve().then(() => require("./capabilities-BGkL9yAr.cjs")).then((n) => n.capabilities_exports);
 	const document = await fetchNetworkCapabilities(await loadConfig());
 	if (opts.json) console.log(JSON.stringify(document, null, 2));
 	else console.log(formatNetworkOverview(document));
 }
 async function printNetworkCapability(name, opts) {
 	const { loadConfig } = await Promise.resolve().then(() => require("./config-BxtMoo9c.cjs")).then((n) => n.config_exports);
-	const { fetchNetworkCapabilities, findNetworkCapability, formatNetworkCapability } = await Promise.resolve().then(() => require("./capabilities-A8fsfP24.cjs")).then((n) => n.capabilities_exports);
+	const { fetchNetworkCapabilities, findNetworkCapability, formatNetworkCapability } = await Promise.resolve().then(() => require("./capabilities-BGkL9yAr.cjs")).then((n) => n.capabilities_exports);
 	const document = await fetchNetworkCapabilities(await loadConfig());
 	const network = findNetworkCapability(document, name);
 	if (!network) {
@@ -146,6 +146,23 @@ async function printNetworkCapability(name, opts) {
 	else console.log(formatNetworkCapability(network));
 }
 /**
+* The live graph schema of one network (meta_schema). A fresh cache answers with
+* no request; a build opens one session and reads through it.
+*/
+async function printNetworkSchema(name, opts) {
+	const { loadConfig } = await Promise.resolve().then(() => require("./config-BxtMoo9c.cjs")).then((n) => n.config_exports);
+	const { resolveGraphMcpEndpoint } = await Promise.resolve().then(() => require("./client-Ypw9BNbn.cjs")).then((n) => n.client_exports);
+	const { formatGraphSchemaText, getGraphSchema } = await Promise.resolve().then(() => require("./graph-schema-znb_9MYq.cjs")).then((n) => n.graph_schema_exports);
+	const config = await loadConfig();
+	const schema = await getGraphSchema({
+		network: name,
+		refresh: opts.refresh === true,
+		endpoint: resolveGraphMcpEndpoint(config),
+		withClient: (fn) => withGraphMcpClient("chain-insights-cli-schema", (client) => fn(client))
+	});
+	console.log(opts.json ? JSON.stringify(schema, null, 2) : formatGraphSchemaText(schema));
+}
+/**
 * Fetches the caller's subscription facts for the deposit pre-sign guard.
 * The extension math is server-authoritative: the printed values come from
 * `subscription_status`. Any failure (no wallet, unreachable endpoint,
@@ -234,9 +251,11 @@ program.command("networks").description("Show supported network status and datas
 		process.exit(1);
 	}
 });
-program.command("network").description("Show details for one supported graph network").argument("<name>", "Network identifier or display name (for example: robinhood)").option("--json", "Print raw capability JSON for this network").action(async (name, opts) => {
+program.command("network").description("Show details for one supported graph network").argument("<name>", "Network identifier or display name (for example: robinhood)").option("--json", "Print raw capability JSON for this network (with --schema: the schema JSON)").option("--schema", "Show the live graph schema: labels, link types, fields and indexes (cached for 24 hours)").option("--refresh", "With --schema: rebuild the schema now instead of reading the cache").action(async (name, opts) => {
 	try {
-		await printNetworkCapability(name, opts);
+		if (opts.refresh && !opts.schema) throw new Error("--refresh needs --schema: run `cia network <name> --schema --refresh`.");
+		if (opts.schema) await printNetworkSchema(name, opts);
+		else await printNetworkCapability(name, opts);
 	} catch (err) {
 		console.error(err.message);
 		process.exit(1);
@@ -550,7 +569,7 @@ program.command("mcp").description("Low-level access to the Chain Insights MCP e
 	}
 })).addCommand(createCliCommand("tools").description("List the remote GraphRAG MCP tools (cached for 24 hours)").option("--refresh", "Force refresh schema cache").action(async (opts) => {
 	try {
-		const { loadSchema, saveSchema } = await Promise.resolve().then(() => require("./schema-cache-n7Gbhvsj.cjs"));
+		const { loadSchema, saveSchema } = await Promise.resolve().then(() => require("./schema-cache-DwddPLcY.cjs"));
 		const { formatToolsTable } = await Promise.resolve().then(() => require("./format-BjZuYDr8.cjs"));
 		const { visibleRemoteTools } = await Promise.resolve().then(() => require("./tool-visibility-CDe-ft0L.cjs")).then((n) => n.tool_visibility_exports);
 		const { loadConfig } = await Promise.resolve().then(() => require("./config-BxtMoo9c.cjs")).then((n) => n.config_exports);
@@ -595,6 +614,13 @@ program.command("mcp").description("Low-level access to the Chain Insights MCP e
 			await printNetworkCapabilities({ json: opts.json });
 			return;
 		}
+		if (tool === "meta_schema") {
+			await printNetworkSchema(String(args["network"] ?? ""), {
+				json: opts.json,
+				refresh: String(args["refresh"] ?? "").toLowerCase() === "true"
+			});
+			return;
+		}
 		if (tool === "graph_expand") throw new Error("graph_expand is used only by the Chain Insights view in Claude. Run `cia mcp call graph_query` with your own query instead.");
 		if (tool === "meta_help") {
 			console.log("Graph tools: graph_query and graph_query_batch. Metadata and payment tools: meta_* and wallet_balance.");

package/dist/cli.mjs

@@ -118,21 +118,21 @@ async function withGraphMcpClient(name, fn) {
 }
 async function printNetworkCapabilities(opts) {
 	const { loadConfig } = await import("./config-9MabJh5R.mjs").then((n) => n.t);
-	const { fetchNetworkCapabilities, formatNetworkCapabilities } = await import("./capabilities-DfWL6n_g.mjs").then((n) => n.t);
+	const { fetchNetworkCapabilities, formatNetworkCapabilities } = await import("./capabilities-Cur8x6c7.mjs").then((n) => n.t);
 	const document = await fetchNetworkCapabilities(await loadConfig());
 	if (opts.json) console.log(JSON.stringify(document, null, 2));
 	else console.log(formatNetworkCapabilities(document));
 }
 async function printNetworkOverview(opts) {
 	const { loadConfig } = await import("./config-9MabJh5R.mjs").then((n) => n.t);
-	const { fetchNetworkCapabilities, formatNetworkOverview } = await import("./capabilities-DfWL6n_g.mjs").then((n) => n.t);
+	const { fetchNetworkCapabilities, formatNetworkOverview } = await import("./capabilities-Cur8x6c7.mjs").then((n) => n.t);
 	const document = await fetchNetworkCapabilities(await loadConfig());
 	if (opts.json) console.log(JSON.stringify(document, null, 2));
 	else console.log(formatNetworkOverview(document));
 }
 async function printNetworkCapability(name, opts) {
 	const { loadConfig } = await import("./config-9MabJh5R.mjs").then((n) => n.t);
-	const { fetchNetworkCapabilities, findNetworkCapability, formatNetworkCapability } = await import("./capabilities-DfWL6n_g.mjs").then((n) => n.t);
+	const { fetchNetworkCapabilities, findNetworkCapability, formatNetworkCapability } = await import("./capabilities-Cur8x6c7.mjs").then((n) => n.t);
 	const document = await fetchNetworkCapabilities(await loadConfig());
 	const network = findNetworkCapability(document, name);
 	if (!network) {
@@ -144,6 +144,23 @@ async function printNetworkCapability(name, opts) {
 	else console.log(formatNetworkCapability(network));
 }
 /**
+* The live graph schema of one network (meta_schema). A fresh cache answers with
+* no request; a build opens one session and reads through it.
+*/
+async function printNetworkSchema(name, opts) {
+	const { loadConfig } = await import("./config-9MabJh5R.mjs").then((n) => n.t);
+	const { resolveGraphMcpEndpoint } = await import("./client-gsLi528K.mjs").then((n) => n.r);
+	const { formatGraphSchemaText, getGraphSchema } = await import("./graph-schema-D1orCe5F.mjs").then((n) => n.i);
+	const config = await loadConfig();
+	const schema = await getGraphSchema({
+		network: name,
+		refresh: opts.refresh === true,
+		endpoint: resolveGraphMcpEndpoint(config),
+		withClient: (fn) => withGraphMcpClient("chain-insights-cli-schema", (client) => fn(client))
+	});
+	console.log(opts.json ? JSON.stringify(schema, null, 2) : formatGraphSchemaText(schema));
+}
+/**
 * Fetches the caller's subscription facts for the deposit pre-sign guard.
 * The extension math is server-authoritative: the printed values come from
 * `subscription_status`. Any failure (no wallet, unreachable endpoint,
@@ -232,9 +249,11 @@ program.command("networks").description("Show supported network status and datas
 		process.exit(1);
 	}
 });
-program.command("network").description("Show details for one supported graph network").argument("<name>", "Network identifier or display name (for example: robinhood)").option("--json", "Print raw capability JSON for this network").action(async (name, opts) => {
+program.command("network").description("Show details for one supported graph network").argument("<name>", "Network identifier or display name (for example: robinhood)").option("--json", "Print raw capability JSON for this network (with --schema: the schema JSON)").option("--schema", "Show the live graph schema: labels, link types, fields and indexes (cached for 24 hours)").option("--refresh", "With --schema: rebuild the schema now instead of reading the cache").action(async (name, opts) => {
 	try {
-		await printNetworkCapability(name, opts);
+		if (opts.refresh && !opts.schema) throw new Error("--refresh needs --schema: run `cia network <name> --schema --refresh`.");
+		if (opts.schema) await printNetworkSchema(name, opts);
+		else await printNetworkCapability(name, opts);
 	} catch (err) {
 		console.error(err.message);
 		process.exit(1);
@@ -548,7 +567,7 @@ program.command("mcp").description("Low-level access to the Chain Insights MCP e
 	}
 })).addCommand(createCliCommand("tools").description("List the remote GraphRAG MCP tools (cached for 24 hours)").option("--refresh", "Force refresh schema cache").action(async (opts) => {
 	try {
-		const { loadSchema, saveSchema } = await import("./schema-cache-DJdU4MIP.mjs");
+		const { loadSchema, saveSchema } = await import("./schema-cache-BT-kHy_r.mjs");
 		const { formatToolsTable } = await import("./format-DB2IH2U5.mjs");
 		const { visibleRemoteTools } = await import("./tool-visibility-P9wETx-d.mjs").then((n) => n.a);
 		const { loadConfig } = await import("./config-9MabJh5R.mjs").then((n) => n.t);
@@ -593,6 +612,13 @@ program.command("mcp").description("Low-level access to the Chain Insights MCP e
 			await printNetworkCapabilities({ json: opts.json });
 			return;
 		}
+		if (tool === "meta_schema") {
+			await printNetworkSchema(String(args["network"] ?? ""), {
+				json: opts.json,
+				refresh: String(args["refresh"] ?? "").toLowerCase() === "true"
+			});
+			return;
+		}
 		if (tool === "graph_expand") throw new Error("graph_expand is used only by the Chain Insights view in Claude. Run `cia mcp call graph_query` with your own query instead.");
 		if (tool === "meta_help") {
 			console.log("Graph tools: graph_query and graph_query_batch. Metadata and payment tools: meta_* and wallet_balance.");