@secondlayer/mcp 10.0.0 → 11.0.0

package/dist/index.js

@@ -218,7 +218,6 @@ var PRODUCT_BLURBS = {
   codegen: "ORM schemas for the tables you read",
   instance: "decoder health and empty-index diagnosis",
   archive: "signed archive verify, bootstrap/repair, quote, latest pointer",
-  setup: "one-command self-host onboarding",
   credits: "archive credits balance at api.secondlayer.tools"
 };
 var PRODUCT_ORDER = [
@@ -231,7 +230,6 @@ var PRODUCT_ORDER = [
   "codegen",
   "instance",
   "archive",
-  "setup",
   "credits"
 ];
 function buildCapabilities() {
@@ -436,229 +434,22 @@ function registerAccountTools(server) {
   }, async ({ name }) => jsonResponse(await apiRequest("POST", "/api/keys", { name })));
 }
 
-// src/tools/archive.ts
+// src/tools/archive-cli.ts
 import { z as z2 } from "zod";
-var FLOW = ["bootstrap", "repair"];
-function registerArchiveTools(server, clientProvider = getClient, archiveOpsClientProvider = getArchiveOpsClient) {
-  defineTool(server, "archive_verify", "Read-only, free compare of this instance against a signed archive (POST /v1/archive/verify). unanchored means pin a key or check the URL — not that the instance is fine. After bootstrap, poll instance_status until decoders ok, then this, then codegen_index_schema. Do not download parquet.", {
-    against: z2.string().describe("Archive manifest URL"),
-    fromBlock: z2.number().int().nonnegative().optional().describe("First height (inclusive)"),
-    toBlock: z2.number().int().nonnegative().optional().describe("Last height (inclusive)"),
-    target: z2.string().optional().describe("Verify target (default raw)")
-  }, async ({ against, fromBlock, toBlock, target }) => jsonResponse(await clientProvider().archive.verify({
-    against,
-    fromBlock,
-    toBlock,
-    target
-  })));
-  defineTool(server, "archive_latest", "Signed pointer to the official archive tree (hosted). Needs SECONDLAYER_API_KEY (sk-sl_*), not INSTANCE_TOKEN. Use the returned origin as --against for archive_bootstrap. Do not download parquet.", {
-    against: z2.string().optional().describe("Override latest.json URL (default official tree)")
-  }, async ({ against }) => jsonResponse(await archiveOpsClientProvider().archive.latest(against)));
-  defineTool(server, "archive_quote", "Price a hosted archive fetch (metered). Needs SECONDLAYER_API_KEY (sk-sl_*), not INSTANCE_TOKEN. Quote happens here; bootstrap/repair also quote inside the CLI. Do not download parquet.", {
-    paths: z2.array(z2.string()).describe("Partition paths to price"),
-    flow: z2.enum(FLOW).describe("bootstrap or repair")
-  }, async ({ paths, flow }) => jsonResponse(await archiveOpsClientProvider().archive.quote({ paths, flow })));
-  defineTool(server, "credits_balance", "Archive credits balance at api.secondlayer.tools. Needs SECONDLAYER_API_KEY (sk-sl_*); INSTANCE_TOKEN is the instance.", {}, async () => jsonResponse(await archiveOpsClientProvider().archive.credits.balance()));
-}
-
-// src/tools/codegen.ts
-import {
-  generateIndexSchema
-} from "@secondlayer/subgraphs";
-import { z as z3 } from "zod";
-var TARGETS = ["prisma", "kysely", "drizzle", "json-schema"];
-function registerCodegenTools(server) {
-  defineTool(server, "codegen_index_schema", "Generate an ORM schema for the Index tables (blocks, transactions, decoded_events, …) — the same output as `sl codegen index`. Returns the file contents as text; write it wherever your project keeps its schema. Use `tables` to emit only what you read.", {
-    target: z3.enum(TARGETS).optional().describe("Output flavor (default kysely)"),
-    tables: z3.array(z3.string()).optional().describe("Restrict to these Index tables (default: all)"),
-    schemaName: z3.string().optional().describe("Postgres schema to qualify table names with"),
-    datasourceEnv: z3.string().optional().describe("Prisma only: datasource url env var (default DATABASE_URL)")
-  }, ({ target, tables, schemaName, datasourceEnv }) => textResponse(generateIndexSchema(target ?? "kysely", {
-    tables,
-    schemaName,
-    datasourceEnv
-  })));
-}
-
-// src/tools/contracts.ts
-import { z as z4 } from "zod";
-function registerContractTools(server, clientProvider = getClient) {
-  defineTool(server, "contracts_find", 'Discover deployed Stacks contracts conforming to a trait (e.g. "sip-010", "sip-009", "sip-013"). The discovery endpoint for "which contracts implement X". Reads are public.', {
-    trait: z4.string().describe('Required. Trait to match (e.g. "sip-010").'),
-    conformance: z4.enum(["declared", "inferred", "any"]).optional().describe("declared = parsed from source, inferred = ABI shape-match, any = either (default)"),
-    include: z4.literal("abi").optional().describe(`Set to "abi" to include each contract's full ABI`),
-    limit: z4.number().optional().describe("Page size, 1–500 (default 100)"),
-    cursor: z4.string().optional().describe("Opaque cursor from a prior response's next_cursor")
-  }, async (params) => jsonResponse(await clientProvider().contracts.list(params)));
-  defineTool(server, "contracts_get_abi", "Fetch a single deployed contract's ABI from the registry (prod-safe). Returns the contract's metadata + full ABI (functions, maps, variables, fungible/non-fungible tokens). Returns not_found if the contract isn't in the registry. Use it to inspect a contract before subgraphs_scaffold.", {
-    contractId: z4.string().describe("Fully qualified contract id (e.g. SP….amm-pool-v2-01)")
-  }, async ({ contractId }) => {
-    const contract = await clientProvider().contracts.get(contractId, {
-      includeAbi: true
-    });
-    return contract ? jsonResponse(contract) : jsonResponse({
-      error: {
-        type: "not_found",
-        status: 404,
-        message: `Contract not in registry: ${contractId}`
-      }
-    }, true);
-  });
-}
-
-// src/tools/index.ts
-import { DECODED_EVENT_TYPES } from "@secondlayer/shared";
-import { z as z5 } from "zod";
-var INDEX_EVENT_TYPES = DECODED_EVENT_TYPES;
-var rangeFilters = {
-  contractId: z5.string().optional().describe("Filter by contract id"),
-  fromHeight: z5.number().optional().describe("Start block height (inclusive)"),
-  toHeight: z5.number().optional().describe("End block height (inclusive)"),
-  cursor: z5.string().optional().describe("Opaque cursor from a prior response's next_cursor"),
-  limit: z5.number().optional().describe("Max rows for this page")
-};
-var heightFilters = {
-  fromHeight: rangeFilters.fromHeight,
-  toHeight: rangeFilters.toHeight,
-  cursor: rangeFilters.cursor,
-  limit: rangeFilters.limit
-};
-function registerIndexTools(server, clientProvider = getClient) {
-  defineTool(server, "index_ft_transfers", "List decoded SIP-010 fungible-token transfers from Index. Reads are keyless.", {
-    ...rangeFilters,
-    sender: z5.string().optional().describe("Filter by sender principal"),
-    recipient: z5.string().optional().describe("Filter by recipient principal"),
-    assetIdentifier: z5.string().optional().describe("Filter by asset identifier (contract::asset), e.g. SP…sbtc-token::sbtc-token")
-  }, async (params) => jsonResponse(await clientProvider().index.ftTransfers.list(params)));
-  defineTool(server, "index_nft_transfers", "List decoded SIP-009 non-fungible-token transfers from Index. Reads are keyless.", {
-    ...rangeFilters,
-    sender: z5.string().optional().describe("Filter by sender principal"),
-    recipient: z5.string().optional().describe("Filter by recipient principal"),
-    assetIdentifier: z5.string().optional().describe("Filter by asset identifier (contract::asset)")
-  }, async (params) => jsonResponse(await clientProvider().index.nftTransfers.list(params)));
-  defineTool(server, "index_events", "List decoded chain events from the Index by event type. Use this for event types without a dedicated tool (stx_*, ft_mint/burn, nft_mint/burn, print), and for trait-scoped queries: set `trait` (e.g. sip-010) to match all contracts conforming to a standard — pair with contracts_find to discover traits. For ft/nft transfers without a trait prefer index_ft_transfers / index_nft_transfers.", {
-    eventType: z5.enum(INDEX_EVENT_TYPES).describe("Required. Decoded event type to list."),
-    ...rangeFilters,
-    sender: z5.string().optional().describe("Filter by sender principal"),
-    recipient: z5.string().optional().describe("Filter by recipient principal"),
-    assetIdentifier: z5.string().optional().describe("Filter by asset identifier where applicable"),
-    trait: z5.string().optional().describe("Match contracts conforming to a trait/standard (e.g. sip-010). Mutually exclusive with contractId; contract-keyed event types only."),
-    txContext: z5.boolean().optional().describe("Join the submitting transaction into each event (tx_sender, tx_type, tx_status, tx_contract_id, tx_function_name). For print events it's the only source of the submitting sender.")
-  }, async (params) => jsonResponse(await clientProvider().index.events.list(params)));
-  defineTool(server, "index_contract_calls", "List decoded contract calls from the Index (function name, args, result). Set `trait` (e.g. sip-010) to match calls to all contracts conforming to a standard. Note: contract-call cursors are a SEPARATE keyspace from event cursors — they are not interchangeable.", {
-    ...rangeFilters,
-    functionName: z5.string().optional().describe("Filter by called function name"),
-    sender: z5.string().optional().describe("Filter by caller principal"),
-    trait: z5.string().optional().describe("Match contracts conforming to a trait/standard (e.g. sip-010). Mutually exclusive with contractId.")
-  }, async (params) => jsonResponse(await clientProvider().index.contractCalls.list(params)));
-  defineTool(server, "index_blocks", "List decoded blocks from Index. Reads are keyless.", { ...heightFilters }, async (params) => jsonResponse(await clientProvider().index.blocks.list(params)));
-  defineTool(server, "index_transactions", "List decoded transactions from Index. Filter by type, sender, or contract. Reads are keyless.", {
-    ...rangeFilters,
-    type: z5.string().optional().describe("Filter by transaction type"),
-    sender: z5.string().optional().describe("Filter by sender principal")
-  }, async (params) => jsonResponse(await clientProvider().index.transactions.list(params)));
-  defineTool(server, "index_print_schema", "Empirical per-topic print payload schemas for a contract, inferred from sampled on-chain events: each topic's fields with observed Clarity types, decoded TS types, subgraph column types, and presence rates. Use before writing print_event subgraph handlers to learn what's on e.data. Anonymous read.", {
-    contractId: z5.string().describe("Contract id (SP….name) whose print events to profile")
-  }, async (params) => jsonResponse(await clientProvider().index.printSchema(params.contractId)));
-  defineTool(server, "index_discover", "Discover the Index vocabulary: every event type and its columns, allowed/equality filters, and required-non-null fields (and which types accept `trait`). Read this before building Index queries instead of guessing filters. Anonymous read.", {}, async () => jsonResponse(await clientProvider().index.discover()));
-  defineTool(server, "batch_query", "Run up to 10 public /v1 reads in one round trip (POST /v1/batch). Each item keeps its own auth/quota/pay-per-call semantics; results return in order with per-item status. Paths must start with /v1/index, /v1/subgraphs, /v1/streams, or /v1/contracts.", {
-    requests: z5.array(z5.object({
-      path: z5.string().describe("Public /v1 read path"),
-      params: z5.record(z5.string(), z5.string()).optional()
-    })).min(1).max(10).describe("Read descriptors, executed concurrently")
-  }, async (params) => jsonResponse(await clientProvider().batch(params.requests)));
-}
-
-// src/tools/instance.ts
-function registerInstanceTools(server, clientProvider = getClient) {
-  defineTool(server, "instance_status", "Decoder health and empty-index diagnosis from GET /public/status. If state is empty-index, next tool is archive_bootstrap or setup. Poll until index.decoders are ok before treating Index as ready — do not start decoders. Then archive_verify, then codegen_index_schema. Do not download parquet.", {}, async () => {
-    const client = clientProvider();
-    const status = await client.instance.status();
-    const diagnosis = await client.instance.diagnose();
-    return jsonResponse({ status, diagnosis });
-  });
-}
-
-// src/tools/scaffold.ts
-import {
-  generatePrintSchemaSubgraph,
-  generateSubgraphCode,
-  generateTokenSubgraphFromAbi
-} from "@secondlayer/scaffold";
-import { z as z6 } from "zod";
-async function fetchAbi(clientProvider, contractId) {
-  const contract = await clientProvider().contracts.get(contractId, {
-    includeAbi: true
-  });
-  if (!contract)
-    throw new Error(`Contract not found: ${contractId}`);
-  const abi = contract.abi;
-  if (!abi) {
-    throw new Error(`No ABI available for ${contractId} (abi_status: ${contract.abi_status})`);
-  }
-  return { functions: abi.functions ?? [], abi };
-}
-function registerScaffoldTools(server, clientProvider = getClient) {
-  defineTool(server, "subgraphs_scaffold", "Generate a subgraph from observed print events when available; ABI token transfers or public functions only when the contract has never printed. Review the TypeScript, run subgraphs_test until ok: true with written >= 1, read skipped, then subgraphs_deploy. dryRun is DDL only.", {
-    contractId: z6.string().describe("Fully qualified contract ID (e.g. SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-pool-v2-01)"),
-    subgraphName: z6.string().optional().describe("Override the subgraph name (defaults to contract name)")
-  }, async ({ contractId, subgraphName }) => {
-    const printSchema = await clientProvider().index.printSchema(contractId);
-    if (printSchema && printSchema.topics.length > 0) {
-      const code = generatePrintSchemaSubgraph({
-        contractId,
-        name: subgraphName,
-        topics: printSchema.topics,
-        sample: printSchema.sample
-      });
-      return { content: [{ type: "text", text: code }] };
-    }
-    const { functions, abi } = await fetchAbi(clientProvider, contractId);
-    const token = generateTokenSubgraphFromAbi({
-      contractId,
-      abi,
-      name: subgraphName
-    });
-    if (token) {
-      return { content: [{ type: "text", text: token }] };
-    }
-    const code = generateSubgraphCode(contractId, functions, subgraphName);
-    return { content: [{ type: "text", text: code }] };
-  });
-}
-
-// src/tools/setup.ts
-import { z as z7 } from "zod";
 
 // src/lib/exec-cli.ts
 import {
   spawn
 } from "node:child_process";
-var ALLOWED = ["setup", "bootstrap", "repair", "verify"];
+var ALLOWED = ["bootstrap", "repair", "verify"];
 var TIMEOUT_MS = {
-  setup: 15 * 60 * 1000,
   bootstrap: 10 * 60 * 1000,
   repair: 10 * 60 * 1000,
   verify: 2 * 60 * 1000
 };
-var VALUE_FLAGS = new Set([
-  "--against",
-  "--from-block",
-  "--to-block",
-  "--network",
-  "--node-mode",
-  "--dir"
-]);
-var BOOL_FLAGS = new Set(["--yes", "--json", "--apply", "--skip-bootstrap"]);
+var VALUE_FLAGS = new Set(["--against", "--from-block", "--to-block"]);
+var BOOL_FLAGS = new Set(["--yes", "--json", "--apply"]);
 var FLAGS_BY_CMD = {
-  setup: new Set([
-    "--yes",
-    "--network",
-    "--node-mode",
-    "--against",
-    "--dir",
-    "--skip-bootstrap"
-  ]),
   bootstrap: new Set([
     "--against",
     "--yes",
@@ -733,12 +524,8 @@ async function execSecondlayer(subcommand, args, deps = {}) {
   }
   assertSafeArgs(subcommand, args);
   const argv = [subcommand, ...args];
-  if (subcommand === "setup") {
-    if (!argv.includes("--yes"))
-      argv.push("--yes");
-  } else if (!argv.includes("--json")) {
+  if (!argv.includes("--json"))
     argv.push("--json");
-  }
   const env = deps.env ?? process.env;
   const bin = env.SECONDLAYER_BIN || "secondlayer";
   const cwd = deps.cwd ?? env.SECONDLAYER_CWD ?? process.cwd();
@@ -786,31 +573,15 @@ timeout after ${timeout}ms`.trim()
   });
 }
 
-// src/tools/setup.ts
+// src/tools/archive-cli.ts
 function cliResponse(result) {
   return jsonResponse(result, result.code !== 0);
 }
-function registerSetupTools(server, exec = execSecondlayer) {
-  defineTool(server, "setup", "Non-interactive self-host onboarding (secondlayer setup --yes). If the index is empty, this or archive_bootstrap fills it. Bootstrap is metered against the official archive. After it returns, poll instance_status until index.decoders are ok, then archive_verify, then codegen_index_schema. Do not download parquet.", {
-    network: z7.enum(["mainnet", "testnet", "devnet"]).describe("Stacks network"),
-    nodeMode: z7.enum(["external", "stacks", "full"]).describe("Node mode: external, stacks, or full"),
-    against: z7.string().optional().describe("Archive manifest URL"),
-    dir: z7.string().optional().describe("Compose project directory"),
-    skipBootstrap: z7.boolean().optional().describe("Sync from genesis instead of restoring an archive")
-  }, async ({ network, nodeMode, against, dir, skipBootstrap }) => {
-    const args = ["--yes", "--network", network, "--node-mode", nodeMode];
-    if (against !== undefined)
-      args.push("--against", against);
-    if (dir !== undefined)
-      args.push("--dir", dir);
-    if (skipBootstrap)
-      args.push("--skip-bootstrap");
-    return cliResponse(await exec("setup", args));
-  });
+function registerArchiveCliTools(server, exec = execSecondlayer) {
   defineTool(server, "archive_bootstrap", "Restore verified history into this instance (secondlayer bootstrap --against … --yes --json). Metered against the official archive; quote happens inside the CLI. After bootstrap, poll instance_status until decoders ok, then archive_verify, then codegen_index_schema. Do not download parquet.", {
-    against: z7.string().describe("Archive manifest URL"),
-    fromBlock: z7.number().int().nonnegative().optional().describe("Restore from this height instead of genesis"),
-    toBlock: z7.number().int().nonnegative().optional().describe("Stop at this height instead of the archive tip")
+    against: z2.string().describe("Archive manifest URL"),
+    fromBlock: z2.number().int().nonnegative().optional().describe("Restore from this height instead of genesis"),
+    toBlock: z2.number().int().nonnegative().optional().describe("Stop at this height instead of the archive tip")
   }, async ({ against, fromBlock, toBlock }) => {
     const args = ["--against", against, "--yes", "--json"];
     if (fromBlock !== undefined)
@@ -820,10 +591,10 @@ function registerSetupTools(server, exec = execSecondlayer) {
     return cliResponse(await exec("bootstrap", args));
   });
   defineTool(server, "archive_repair", "Plan (default) or apply a repair of local chain data against a signed archive. Metered when apply fetches from the official archive. After apply, poll instance_status until decoders ok, then archive_verify. Do not download parquet.", {
-    against: z7.string().describe("Archive manifest URL"),
-    apply: z7.boolean().optional().describe("Write the repair (default plan-only)"),
-    fromBlock: z7.number().int().nonnegative().optional().describe("First height to consider"),
-    toBlock: z7.number().int().nonnegative().optional().describe("Last height to consider")
+    against: z2.string().describe("Archive manifest URL"),
+    apply: z2.boolean().optional().describe("Write the repair (default plan-only)"),
+    fromBlock: z2.number().int().nonnegative().optional().describe("First height to consider"),
+    toBlock: z2.number().int().nonnegative().optional().describe("Last height to consider")
   }, async ({ against, apply, fromBlock, toBlock }) => {
     const args = ["--against", against, "--json"];
     if (apply)
@@ -836,6 +607,197 @@ function registerSetupTools(server, exec = execSecondlayer) {
   });
 }
 
+// src/tools/archive.ts
+import { z as z3 } from "zod";
+var FLOW = ["bootstrap", "repair"];
+function registerArchiveTools(server, clientProvider = getClient, archiveOpsClientProvider = getArchiveOpsClient) {
+  defineTool(server, "archive_verify", "Read-only, free compare of this instance against a signed archive (POST /v1/archive/verify). unanchored means pin a key or check the URL — not that the instance is fine. After bootstrap, poll instance_status until decoders ok, then this, then codegen_index_schema. Do not download parquet.", {
+    against: z3.string().describe("Archive manifest URL"),
+    fromBlock: z3.number().int().nonnegative().optional().describe("First height (inclusive)"),
+    toBlock: z3.number().int().nonnegative().optional().describe("Last height (inclusive)"),
+    target: z3.string().optional().describe("Verify target (default raw)")
+  }, async ({ against, fromBlock, toBlock, target }) => jsonResponse(await clientProvider().archive.verify({
+    against,
+    fromBlock,
+    toBlock,
+    target
+  })));
+  defineTool(server, "archive_latest", "Signed pointer to the official archive tree (hosted). Needs SECONDLAYER_API_KEY (sk-sl_*), not INSTANCE_TOKEN. Use the returned origin as --against for archive_bootstrap. Do not download parquet.", {
+    against: z3.string().optional().describe("Override latest.json URL (default official tree)")
+  }, async ({ against }) => jsonResponse(await archiveOpsClientProvider().archive.latest(against)));
+  defineTool(server, "archive_quote", "Price a hosted archive fetch (metered). Needs SECONDLAYER_API_KEY (sk-sl_*), not INSTANCE_TOKEN. Quote happens here; bootstrap/repair also quote inside the CLI. Do not download parquet.", {
+    paths: z3.array(z3.string()).describe("Partition paths to price"),
+    flow: z3.enum(FLOW).describe("bootstrap or repair")
+  }, async ({ paths, flow }) => jsonResponse(await archiveOpsClientProvider().archive.quote({ paths, flow })));
+  defineTool(server, "credits_balance", "Archive credits balance at api.secondlayer.tools. Needs SECONDLAYER_API_KEY (sk-sl_*); INSTANCE_TOKEN is the instance.", {}, async () => jsonResponse(await archiveOpsClientProvider().archive.credits.balance()));
+}
+
+// src/tools/codegen.ts
+import {
+  generateIndexSchema
+} from "@secondlayer/subgraphs";
+import { z as z4 } from "zod";
+var TARGETS = ["prisma", "kysely", "drizzle", "json-schema"];
+function registerCodegenTools(server) {
+  defineTool(server, "codegen_index_schema", "Generate an ORM schema for the Index tables (blocks, transactions, decoded_events, …) — the same output as `sl codegen index`. Returns the file contents as text; write it wherever your project keeps its schema. Use `tables` to emit only what you read.", {
+    target: z4.enum(TARGETS).optional().describe("Output flavor (default kysely)"),
+    tables: z4.array(z4.string()).optional().describe("Restrict to these Index tables (default: all)"),
+    schemaName: z4.string().optional().describe("Postgres schema to qualify table names with"),
+    datasourceEnv: z4.string().optional().describe("Prisma only: datasource url env var (default DATABASE_URL)")
+  }, ({ target, tables, schemaName, datasourceEnv }) => textResponse(generateIndexSchema(target ?? "kysely", {
+    tables,
+    schemaName,
+    datasourceEnv
+  })));
+}
+
+// src/tools/contracts.ts
+import { z as z5 } from "zod";
+function registerContractTools(server, clientProvider = getClient) {
+  defineTool(server, "contracts_find", 'Discover deployed Stacks contracts conforming to a trait (e.g. "sip-010", "sip-009", "sip-013"). The discovery endpoint for "which contracts implement X". Reads are public.', {
+    trait: z5.string().describe('Required. Trait to match (e.g. "sip-010").'),
+    conformance: z5.enum(["declared", "inferred", "any"]).optional().describe("declared = parsed from source, inferred = ABI shape-match, any = either (default)"),
+    include: z5.literal("abi").optional().describe(`Set to "abi" to include each contract's full ABI`),
+    limit: z5.number().optional().describe("Page size, 1–500 (default 100)"),
+    cursor: z5.string().optional().describe("Opaque cursor from a prior response's next_cursor")
+  }, async (params) => jsonResponse(await clientProvider().contracts.list(params)));
+  defineTool(server, "contracts_get_abi", "Fetch a single deployed contract's ABI from the registry (prod-safe). Returns the contract's metadata + full ABI (functions, maps, variables, fungible/non-fungible tokens). Returns not_found if the contract isn't in the registry. Use it to inspect a contract before subgraphs_scaffold.", {
+    contractId: z5.string().describe("Fully qualified contract id (e.g. SP….amm-pool-v2-01)")
+  }, async ({ contractId }) => {
+    const contract = await clientProvider().contracts.get(contractId, {
+      includeAbi: true
+    });
+    return contract ? jsonResponse(contract) : jsonResponse({
+      error: {
+        type: "not_found",
+        status: 404,
+        message: `Contract not in registry: ${contractId}`
+      }
+    }, true);
+  });
+}
+
+// src/tools/index.ts
+import { DECODED_EVENT_TYPES } from "@secondlayer/shared";
+import { z as z6 } from "zod";
+var INDEX_EVENT_TYPES = DECODED_EVENT_TYPES;
+var rangeFilters = {
+  contractId: z6.string().optional().describe("Filter by contract id"),
+  fromHeight: z6.number().optional().describe("Start block height (inclusive)"),
+  toHeight: z6.number().optional().describe("End block height (inclusive)"),
+  cursor: z6.string().optional().describe("Opaque cursor from a prior response's next_cursor"),
+  limit: z6.number().optional().describe("Max rows for this page")
+};
+var heightFilters = {
+  fromHeight: rangeFilters.fromHeight,
+  toHeight: rangeFilters.toHeight,
+  cursor: rangeFilters.cursor,
+  limit: rangeFilters.limit
+};
+function registerIndexTools(server, clientProvider = getClient) {
+  defineTool(server, "index_ft_transfers", "List decoded SIP-010 fungible-token transfers from Index. Reads are keyless.", {
+    ...rangeFilters,
+    sender: z6.string().optional().describe("Filter by sender principal"),
+    recipient: z6.string().optional().describe("Filter by recipient principal"),
+    assetIdentifier: z6.string().optional().describe("Filter by asset identifier (contract::asset), e.g. SP…sbtc-token::sbtc-token")
+  }, async (params) => jsonResponse(await clientProvider().index.ftTransfers.list(params)));
+  defineTool(server, "index_nft_transfers", "List decoded SIP-009 non-fungible-token transfers from Index. Reads are keyless.", {
+    ...rangeFilters,
+    sender: z6.string().optional().describe("Filter by sender principal"),
+    recipient: z6.string().optional().describe("Filter by recipient principal"),
+    assetIdentifier: z6.string().optional().describe("Filter by asset identifier (contract::asset)")
+  }, async (params) => jsonResponse(await clientProvider().index.nftTransfers.list(params)));
+  defineTool(server, "index_events", "List decoded chain events from the Index by event type. Use this for event types without a dedicated tool (stx_*, ft_mint/burn, nft_mint/burn, print), and for trait-scoped queries: set `trait` (e.g. sip-010) to match all contracts conforming to a standard — pair with contracts_find to discover traits. For ft/nft transfers without a trait prefer index_ft_transfers / index_nft_transfers.", {
+    eventType: z6.enum(INDEX_EVENT_TYPES).describe("Required. Decoded event type to list."),
+    ...rangeFilters,
+    sender: z6.string().optional().describe("Filter by sender principal"),
+    recipient: z6.string().optional().describe("Filter by recipient principal"),
+    assetIdentifier: z6.string().optional().describe("Filter by asset identifier where applicable"),
+    trait: z6.string().optional().describe("Match contracts conforming to a trait/standard (e.g. sip-010). Mutually exclusive with contractId; contract-keyed event types only."),
+    txContext: z6.boolean().optional().describe("Join the submitting transaction into each event (tx_sender, tx_type, tx_status, tx_contract_id, tx_function_name). For print events it's the only source of the submitting sender.")
+  }, async (params) => jsonResponse(await clientProvider().index.events.list(params)));
+  defineTool(server, "index_contract_calls", "List decoded contract calls from the Index (function name, args, result). Set `trait` (e.g. sip-010) to match calls to all contracts conforming to a standard. Note: contract-call cursors are a SEPARATE keyspace from event cursors — they are not interchangeable.", {
+    ...rangeFilters,
+    functionName: z6.string().optional().describe("Filter by called function name"),
+    sender: z6.string().optional().describe("Filter by caller principal"),
+    trait: z6.string().optional().describe("Match contracts conforming to a trait/standard (e.g. sip-010). Mutually exclusive with contractId.")
+  }, async (params) => jsonResponse(await clientProvider().index.contractCalls.list(params)));
+  defineTool(server, "index_blocks", "List decoded blocks from Index. Reads are keyless.", { ...heightFilters }, async (params) => jsonResponse(await clientProvider().index.blocks.list(params)));
+  defineTool(server, "index_transactions", "List decoded transactions from Index. Filter by type, sender, or contract. Reads are keyless.", {
+    ...rangeFilters,
+    type: z6.string().optional().describe("Filter by transaction type"),
+    sender: z6.string().optional().describe("Filter by sender principal")
+  }, async (params) => jsonResponse(await clientProvider().index.transactions.list(params)));
+  defineTool(server, "index_print_schema", "Empirical per-topic print payload schemas for a contract, inferred from sampled on-chain events: each topic's fields with observed Clarity types, decoded TS types, subgraph column types, and presence rates. Use before writing print_event subgraph handlers to learn what's on e.data. Anonymous read.", {
+    contractId: z6.string().describe("Contract id (SP….name) whose print events to profile")
+  }, async (params) => jsonResponse(await clientProvider().index.printSchema(params.contractId)));
+  defineTool(server, "index_discover", "Discover the Index vocabulary: every event type and its columns, allowed/equality filters, and required-non-null fields (and which types accept `trait`). Read this before building Index queries instead of guessing filters. Anonymous read.", {}, async () => jsonResponse(await clientProvider().index.discover()));
+  defineTool(server, "batch_query", "Run up to 10 public /v1 reads in one round trip (POST /v1/batch). Each item keeps its own auth/quota/pay-per-call semantics; results return in order with per-item status. Paths must start with /v1/index, /v1/subgraphs, /v1/streams, or /v1/contracts.", {
+    requests: z6.array(z6.object({
+      path: z6.string().describe("Public /v1 read path"),
+      params: z6.record(z6.string(), z6.string()).optional()
+    })).min(1).max(10).describe("Read descriptors, executed concurrently")
+  }, async (params) => jsonResponse(await clientProvider().batch(params.requests)));
+}
+
+// src/tools/instance.ts
+function registerInstanceTools(server, clientProvider = getClient) {
+  defineTool(server, "instance_status", "Decoder health and empty-index diagnosis from GET /public/status. If state is empty-index, next tool is archive_bootstrap. Poll until index.decoders are ok before treating Index as ready — do not start decoders. Then archive_verify, then codegen_index_schema. Do not download parquet.", {}, async () => {
+    const client = clientProvider();
+    const status = await client.instance.status();
+    const diagnosis = await client.instance.diagnose();
+    return jsonResponse({ status, diagnosis });
+  });
+}
+
+// src/tools/scaffold.ts
+import {
+  generatePrintSchemaSubgraph,
+  generateSubgraphCode,
+  generateTokenSubgraphFromAbi
+} from "@secondlayer/scaffold";
+import { z as z7 } from "zod";
+async function fetchAbi(clientProvider, contractId) {
+  const contract = await clientProvider().contracts.get(contractId, {
+    includeAbi: true
+  });
+  if (!contract)
+    throw new Error(`Contract not found: ${contractId}`);
+  const abi = contract.abi;
+  if (!abi) {
+    throw new Error(`No ABI available for ${contractId} (abi_status: ${contract.abi_status})`);
+  }
+  return { functions: abi.functions ?? [], abi };
+}
+function registerScaffoldTools(server, clientProvider = getClient) {
+  defineTool(server, "subgraphs_scaffold", "Generate a subgraph from observed print events when available; ABI token transfers or public functions only when the contract has never printed. Review the TypeScript, run subgraphs_test until ok: true with written >= 1, read skipped, then subgraphs_deploy. dryRun is DDL only.", {
+    contractId: z7.string().describe("Fully qualified contract ID (e.g. SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-pool-v2-01)"),
+    subgraphName: z7.string().optional().describe("Override the subgraph name (defaults to contract name)")
+  }, async ({ contractId, subgraphName }) => {
+    const printSchema = await clientProvider().index.printSchema(contractId);
+    if (printSchema && printSchema.topics.length > 0) {
+      const code = generatePrintSchemaSubgraph({
+        contractId,
+        name: subgraphName,
+        topics: printSchema.topics,
+        sample: printSchema.sample
+      });
+      return { content: [{ type: "text", text: code }] };
+    }
+    const { functions, abi } = await fetchAbi(clientProvider, contractId);
+    const token = generateTokenSubgraphFromAbi({
+      contractId,
+      abi,
+      name: subgraphName
+    });
+    if (token) {
+      return { content: [{ type: "text", text: token }] };
+    }
+    const code = generateSubgraphCode(contractId, functions, subgraphName);
+    return { content: [{ type: "text", text: code }] };
+  });
+}
+
 // src/tools/streams.ts
 function registerStreamsTools(server, clientProvider = getClient) {
   defineTool(server, "streams_tip", "Current canonical chain tip as Streams sees it: block height/hash, burn height, finalized_height, lag_seconds, and the oldest seekable height/cursor for this key's retention window. Call it before a cursor walk to know where the stream ends, and after an ingest to check lag.", {}, async () => jsonResponse(await clientProvider().streams.tip()));
@@ -893,7 +855,7 @@ function registerSubgraphTools(server, clientProvider = getClient) {
       return textResponse(await client.subgraphs.markdown(name));
     return jsonResponse(await client.subgraphs.schema(name));
   });
-  defineTool(server, "subgraphs_query", 'Query rows from a subgraph table (max 200 rows), reading the open /v1 surface — { rows, next_cursor, tip } envelope, cursor-paginated (no offset). Filters support operators: "amount.gte": "1000", "sender.neq": "SP...", "name.like": "%token%". Available operators: eq, neq, gt, gte, lt, lte, like. To TAIL new rows (no streaming over MCP): sort=_id, order=desc for the latest, then poll forward with the filter {"_id.gt": "<last _id seen>"}, order=asc — when tailing with a `fields` list, include "_id" in it or the next poll filter cannot be formed. Fetch one row by id with {"_id": "<id>"}. The response\'s nextCursor resumes the same page: pass it back as `cursor` on the next call. The same rows are readable over HTTP at GET /v1/subgraphs/<name>/<table>; hand that URL to third parties.', {
+  defineTool(server, "subgraphs_query", 'Query rows from a subgraph table (max 200 rows), reading the open /v1 surface — { rows, next_cursor, tip } envelope, cursor-paginated (no offset). Filters support operators: "amount.gte": "1000", "sender.neq": "SP...", "name.like": "%token%". Available operators: eq, neq, gt, gte, lt, lte, like. Every page with rows returns next_cursor (null only when empty): pass it back as `cursor` to read the next page. To TAIL new rows (no streaming over MCP), poll with cursor = next_cursor ?? the cursor you sent. Fetch one row by id with {"_id": "<id>"}. The same rows are readable over HTTP at GET /v1/subgraphs/<name>/<table>; hand that URL to third parties.', {
     name: z8.string().describe("Subgraph name"),
     table: z8.string().describe("Table name"),
     filters: z8.record(z8.string(), z8.string()).optional().describe('Column filters — plain values or with operators (e.g. {"amount.gte": "1000", "sender": "SP..."})'),
@@ -1184,7 +1146,7 @@ var TOOL_GROUPS = [
   { group: "codegen", register: registerCodegenTools },
   { group: "instance", register: registerInstanceTools },
   { group: "archive", register: registerArchiveTools },
-  { group: "setup", register: registerSetupTools },
+  { group: "archive", register: registerArchiveCliTools },
   { group: "account", register: registerAccountTools, hostedOnly: true }
 ];
 
@@ -1209,5 +1171,5 @@ export {
   createServer
 };
 
-//# debugId=2CB934F0C028A61464756E2164756E21
+//# debugId=1618B517EA415EF064756E2164756E21
 //# sourceMappingURL=index.js.map