@secondlayer/mcp 4.2.5 → 4.3.0

package/dist/bin.js

@@ -12,6 +12,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 // src/resources.ts
 import { CHAIN_TRIGGER_FIELDS } from "@secondlayer/shared";
 import { TRAIT_STANDARDS } from "@secondlayer/stacks/clarity";
+import { filterFieldsByType } from "@secondlayer/subgraphs";
 import { TYPE_MAP } from "@secondlayer/subgraphs/schema";
 
 // src/lib/client.ts
@@ -121,7 +122,7 @@ var registeredToolNames = new Set;
 function getRegisteredToolNames() {
   return [...registeredToolNames];
 }
-function defineTool(server, name, description, schema, handler) {
+function defineTool(server, name, description, schema, handler, options = {}) {
   const wrappedHandler = async (args) => {
     try {
       return await handler(args);
@@ -142,6 +143,9 @@ function defineTool(server, name, description, schema, handler) {
   };
   registeredToolNames.add(name);
   server.tool(name, description, schema, wrappedHandler);
+  for (const alias of options.aliases ?? []) {
+    server.tool(alias, `Deprecated alias for \`${name}\`. ${description}`, schema, wrappedHandler);
+  }
 }
 
 // src/resources.ts
@@ -150,39 +154,7 @@ var TRAIT_BLURBS = {
   "sip-010": "Fungible token standard",
   "sip-013": "Semi-fungible token standard"
 };
-var FILTERS_REFERENCE = [
-  {
-    type: "stx_transfer",
-    fields: ["sender", "recipient", "minAmount", "maxAmount"]
-  },
-  { type: "stx_mint", fields: ["recipient", "minAmount"] },
-  { type: "stx_burn", fields: ["sender", "minAmount"] },
-  { type: "stx_lock", fields: ["lockedAddress", "minAmount"] },
-  {
-    type: "ft_transfer",
-    fields: ["sender", "recipient", "assetIdentifier", "minAmount", "trait"]
-  },
-  {
-    type: "ft_mint",
-    fields: ["recipient", "assetIdentifier", "minAmount", "trait"]
-  },
-  {
-    type: "ft_burn",
-    fields: ["sender", "assetIdentifier", "minAmount", "trait"]
-  },
-  {
-    type: "nft_transfer",
-    fields: ["sender", "recipient", "assetIdentifier", "trait"]
-  },
-  { type: "nft_mint", fields: ["recipient", "assetIdentifier", "trait"] },
-  { type: "nft_burn", fields: ["sender", "assetIdentifier", "trait"] },
-  {
-    type: "contract_call",
-    fields: ["contractId", "functionName", "caller", "trait", "abi"]
-  },
-  { type: "contract_deploy", fields: ["deployer", "contractName"] },
-  { type: "print_event", fields: ["contractId", "topic", "trait"] }
-];
+var FILTERS_REFERENCE = filterFieldsByType();
 var COLUMN_TYPE_DESCRIPTIONS = {
   text: "UTF-8 string",
   uint: "Unsigned integer (Clarity uint) — NUMERIC for lossless 128-bit range",
@@ -210,7 +182,8 @@ var PRODUCT_BLURBS = {
   subgraphs: "author/deploy/query custom indexes",
   subscriptions: "webhook delivery on subgraph rows or raw chain events",
   account: "identity and self-provisioned API keys",
-  scaffold: "generate deploy-ready subgraph code from a deployed contract"
+  scaffold: "generate deploy-ready subgraph code from a deployed contract",
+  codegen: "ORM schemas for the tables you read"
 };
 var PRODUCT_ORDER = [
   "index",
@@ -219,7 +192,8 @@ var PRODUCT_ORDER = [
   "subgraphs",
   "subscriptions",
   "account",
-  "scaffold"
+  "scaffold",
+  "codegen"
 ];
 function buildCapabilities() {
   const byPrefix = new Map;
@@ -351,18 +325,37 @@ function registerAccountTools(server) {
   }, async ({ product, name }) => jsonResponse(await getClient().apiKeys.create({ product, name })));
 }
 
-// src/tools/contracts.ts
+// src/tools/codegen.ts
+import {
+  generateIndexSchema
+} from "@secondlayer/subgraphs";
 import { z as z2 } 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: z2.enum(TARGETS).optional().describe("Output flavor (default kysely)"),
+    tables: z2.array(z2.string()).optional().describe("Restrict to these Index tables (default: all)"),
+    schemaName: z2.string().optional().describe("Postgres schema to qualify table names with"),
+    datasourceEnv: z2.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 z3 } 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: z2.string().describe('Required. Trait to match (e.g. "sip-010").'),
-    conformance: z2.enum(["declared", "inferred", "any"]).optional().describe("declared = parsed from source, inferred = ABI shape-match, any = either (default)"),
-    include: z2.literal("abi").optional().describe(`Set to "abi" to include each contract's full ABI`),
-    limit: z2.number().optional().describe("Page size, 1–500 (default 100)"),
-    cursor: z2.string().optional().describe("Opaque cursor from a prior response's next_cursor")
+    trait: z3.string().describe('Required. Trait to match (e.g. "sip-010").'),
+    conformance: z3.enum(["declared", "inferred", "any"]).optional().describe("declared = parsed from source, inferred = ABI shape-match, any = either (default)"),
+    include: z3.literal("abi").optional().describe(`Set to "abi" to include each contract's full ABI`),
+    limit: z3.number().optional().describe("Page size, 1–500 (default 100)"),
+    cursor: z3.string().optional().describe("Opaque cursor from a prior response's next_cursor")
   }, async (params) => jsonResponse(await clientProvider().contracts.list(params)));
-  defineTool(server, "get_contract_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 scaffold_from_contract.", {
-    contractId: z2.string().describe("Fully qualified contract id (e.g. SP….amm-pool-v2-01)")
+  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 scaffold_from_contract.", {
+    contractId: z3.string().describe("Fully qualified contract id (e.g. SP….amm-pool-v2-01)")
   }, async ({ contractId }) => {
     const contract = await clientProvider().contracts.get(contractId, {
       includeAbi: true
@@ -374,19 +367,19 @@ function registerContractTools(server, clientProvider = getClient) {
         message: `Contract not in registry: ${contractId}`
       }
     }, true);
-  });
+  }, { aliases: ["get_contract_abi"] });
 }
 
 // src/tools/index.ts
 import { DECODED_EVENT_TYPES } from "@secondlayer/shared";
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 var INDEX_EVENT_TYPES = DECODED_EVENT_TYPES;
 var rangeFilters = {
-  contractId: z3.string().optional().describe("Filter by contract id"),
-  fromHeight: z3.number().optional().describe("Start block height (inclusive)"),
-  toHeight: z3.number().optional().describe("End block height (inclusive)"),
-  cursor: z3.string().optional().describe("Opaque cursor from a prior response's next_cursor"),
-  limit: z3.number().optional().describe("Max rows for this page")
+  contractId: z4.string().optional().describe("Filter by contract id"),
+  fromHeight: z4.number().optional().describe("Start block height (inclusive)"),
+  toHeight: z4.number().optional().describe("End block height (inclusive)"),
+  cursor: z4.string().optional().describe("Opaque cursor from a prior response's next_cursor"),
+  limit: z4.number().optional().describe("Max rows for this page")
 };
 var heightFilters = {
   fromHeight: rangeFilters.fromHeight,
@@ -397,51 +390,51 @@ var heightFilters = {
 function registerIndexTools(server, clientProvider = getClient) {
   defineTool(server, "index_ft_transfers", "List decoded SIP-010 fungible-token transfers from the Index (decoded layer). Anonymous reads allowed (free-tier API keys are rejected — Build+ required).", {
     ...rangeFilters,
-    sender: z3.string().optional().describe("Filter by sender principal"),
-    recipient: z3.string().optional().describe("Filter by recipient principal")
+    sender: z4.string().optional().describe("Filter by sender principal"),
+    recipient: z4.string().optional().describe("Filter by recipient principal")
   }, async (params) => jsonResponse(await clientProvider().index.ftTransfers.list(params)));
   defineTool(server, "index_nft_transfers", "List decoded SIP-009 non-fungible-token transfers from the Index. Anonymous reads allowed (free-tier keys rejected).", {
     ...rangeFilters,
-    sender: z3.string().optional().describe("Filter by sender principal"),
-    recipient: z3.string().optional().describe("Filter by recipient principal"),
-    assetIdentifier: z3.string().optional().describe("Filter by asset identifier (contract::asset)")
+    sender: z4.string().optional().describe("Filter by sender principal"),
+    recipient: z4.string().optional().describe("Filter by recipient principal"),
+    assetIdentifier: z4.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: z3.enum(INDEX_EVENT_TYPES).describe("Required. Decoded event type to list."),
+    eventType: z4.enum(INDEX_EVENT_TYPES).describe("Required. Decoded event type to list."),
     ...rangeFilters,
-    sender: z3.string().optional().describe("Filter by sender principal"),
-    recipient: z3.string().optional().describe("Filter by recipient principal"),
-    assetIdentifier: z3.string().optional().describe("Filter by asset identifier where applicable"),
-    trait: z3.string().optional().describe("Match contracts conforming to a trait/standard (e.g. sip-010). Mutually exclusive with contractId; contract-keyed event types only."),
-    txContext: z3.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.")
+    sender: z4.string().optional().describe("Filter by sender principal"),
+    recipient: z4.string().optional().describe("Filter by recipient principal"),
+    assetIdentifier: z4.string().optional().describe("Filter by asset identifier where applicable"),
+    trait: z4.string().optional().describe("Match contracts conforming to a trait/standard (e.g. sip-010). Mutually exclusive with contractId; contract-keyed event types only."),
+    txContext: z4.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: z3.string().optional().describe("Filter by called function name"),
-    sender: z3.string().optional().describe("Filter by caller principal"),
-    trait: z3.string().optional().describe("Match contracts conforming to a trait/standard (e.g. sip-010). Mutually exclusive with contractId.")
+    functionName: z4.string().optional().describe("Filter by called function name"),
+    sender: z4.string().optional().describe("Filter by caller principal"),
+    trait: z4.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 the Index. Anonymous reads allowed (free-tier keys rejected).", { ...heightFilters }, async (params) => jsonResponse(await clientProvider().index.blocks.list(params)));
   defineTool(server, "index_transactions", "List decoded transactions from the Index. Filter by type, sender, or contract. Anonymous reads allowed (free-tier keys rejected).", {
     ...rangeFilters,
-    type: z3.string().optional().describe("Filter by transaction type"),
-    sender: z3.string().optional().describe("Filter by sender principal")
+    type: z4.string().optional().describe("Filter by transaction type"),
+    sender: z4.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: z3.string().describe("Contract id (SP….name) whose print events to profile")
+    contractId: z4.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: z3.array(z3.object({
-      path: z3.string().describe("Public /v1 read path"),
-      params: z3.record(z3.string(), z3.string()).optional()
+    requests: z4.array(z4.object({
+      path: z4.string().describe("Public /v1 read path"),
+      params: z4.record(z4.string(), z4.string()).optional()
     })).min(1).max(10).describe("Read descriptors, executed concurrently")
   }, async (params) => jsonResponse(await clientProvider().batch(params.requests)));
 }
 
 // src/tools/scaffold.ts
 import { generateSubgraphCode } from "@secondlayer/scaffold";
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
 async function fetchAbi(clientProvider, contractId) {
   const contract = await clientProvider().contracts.get(contractId, {
     includeAbi: true
@@ -456,8 +449,8 @@ async function fetchAbi(clientProvider, contractId) {
 }
 function registerScaffoldTools(server, clientProvider = getClient) {
   defineTool(server, "scaffold_from_contract", "Generate a subgraph scaffold from a deployed Stacks contract. Fetches the ABI automatically.", {
-    contractId: z4.string().describe("Fully qualified contract ID (e.g. SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-pool-v2-01)"),
-    subgraphName: z4.string().optional().describe("Override the subgraph name (defaults to contract name)")
+    contractId: z5.string().describe("Fully qualified contract ID (e.g. SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-pool-v2-01)"),
+    subgraphName: z5.string().optional().describe("Override the subgraph name (defaults to contract name)")
   }, async ({ contractId, subgraphName }) => {
     const { functions } = await fetchAbi(clientProvider, contractId);
     const code = generateSubgraphCode(contractId, functions, subgraphName);
@@ -473,26 +466,26 @@ function registerStreamsTools(server, clientProvider = getClient) {
 // src/tools/subgraphs.ts
 import { bundleSubgraphCode } from "@secondlayer/bundler";
 import { ByoBreakingChangeError } from "@secondlayer/sdk";
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 function registerSubgraphTools(server, clientProvider = getClient) {
   defineTool(server, "subgraphs_list", "List all deployed subgraphs. Returns summary fields only, including visibility — public subgraphs are anon-readable at /v1/subgraphs/<name>.", {}, async () => {
     const { data } = await clientProvider().subgraphs.list();
     return jsonResponse(data.map(formatSubgraphSummary));
   });
-  defineTool(server, "subgraphs_get", "Get full details of a subgraph including schema, health, and table columns.", { name: z5.string().describe("Subgraph name") }, async ({ name }) => {
+  defineTool(server, "subgraphs_get", "Get full details of a subgraph including schema, health, and table columns.", { name: z6.string().describe("Subgraph name") }, async ({ name }) => {
     const detail = await clientProvider().subgraphs.get(name);
     return jsonResponse(detail);
   });
   defineTool(server, "subgraphs_query", 'Query rows from a subgraph table (max 200 rows). 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. Fetch one row by id with {"_id": "<id>"}. Public subgraphs are also keyless over HTTP at GET /v1/subgraphs/<name>/<table> — { rows, next_cursor, tip } envelope, resume with ?cursor=<next_cursor> + _order=asc|desc (no _offset/_sort on /v1); hand that URL to third parties.', {
-    name: z5.string().describe("Subgraph name"),
-    table: z5.string().describe("Table name"),
-    filters: z5.record(z5.string(), z5.string()).optional().describe('Column filters — plain values or with operators (e.g. {"amount.gte": "1000", "sender": "SP..."})'),
-    sort: z5.string().optional().describe("Column to sort by"),
-    order: z5.enum(["asc", "desc"]).optional().describe("Sort order"),
-    limit: z5.number().max(200).optional().describe("Max rows (default 50, max 200)"),
-    offset: z5.number().optional().describe("Offset for pagination"),
-    fields: z5.string().optional().describe('Comma-separated column list to return (e.g. "sender,amount")'),
-    count: z5.boolean().optional().describe("If true, return row count instead of rows")
+    name: z6.string().describe("Subgraph name"),
+    table: z6.string().describe("Table name"),
+    filters: z6.record(z6.string(), z6.string()).optional().describe('Column filters — plain values or with operators (e.g. {"amount.gte": "1000", "sender": "SP..."})'),
+    sort: z6.string().optional().describe("Column to sort by"),
+    order: z6.enum(["asc", "desc"]).optional().describe("Sort order"),
+    limit: z6.number().max(200).optional().describe("Max rows (default 50, max 200)"),
+    offset: z6.number().optional().describe("Offset for pagination"),
+    fields: z6.string().optional().describe('Comma-separated column list to return (e.g. "sender,amount")'),
+    count: z6.boolean().optional().describe("If true, return row count instead of rows")
   }, async ({
     name,
     table,
@@ -520,9 +513,9 @@ function registerSubgraphTools(server, clientProvider = getClient) {
     return jsonResponse(result);
   });
   defineTool(server, "subgraphs_reindex", "Reindex a subgraph from a specific block range. Returns an operationId — check subgraphs_get (health) or the REST operations endpoint to track progress to completion.", {
-    name: z5.string().describe("Subgraph name"),
-    fromBlock: z5.number().optional().describe("Start block (defaults to beginning)"),
-    toBlock: z5.number().optional().describe("End block (defaults to latest)")
+    name: z6.string().describe("Subgraph name"),
+    fromBlock: z6.number().optional().describe("Start block (defaults to beginning)"),
+    toBlock: z6.number().optional().describe("End block (defaults to latest)")
   }, async ({ name, fromBlock, toBlock }) => {
     const result = await clientProvider().subgraphs.reindex(name, {
       fromBlock,
@@ -531,9 +524,9 @@ function registerSubgraphTools(server, clientProvider = getClient) {
     return jsonResponse(result);
   });
   defineTool(server, "subgraphs_backfill", "Backfill a subgraph over a block range. Non-destructive forward fill (does not drop existing data) — unlike subgraphs_reindex, and the only data-fill path for BYO subgraphs (reindex is blocked there). Both blocks required. Returns an operationId — check subgraphs_get (health) or the REST operations endpoint to track progress.", {
-    name: z5.string().describe("Subgraph name"),
-    fromBlock: z5.number().int().nonnegative().describe("Start block (inclusive)"),
-    toBlock: z5.number().int().nonnegative().describe("End block (inclusive)")
+    name: z6.string().describe("Subgraph name"),
+    fromBlock: z6.number().int().nonnegative().describe("Start block (inclusive)"),
+    toBlock: z6.number().int().nonnegative().describe("End block (inclusive)")
   }, async ({ name, fromBlock, toBlock }) => {
     const result = await clientProvider().subgraphs.backfill(name, {
       fromBlock,
@@ -541,15 +534,15 @@ function registerSubgraphTools(server, clientProvider = getClient) {
     });
     return jsonResponse(result);
   });
-  defineTool(server, "subgraphs_stop", "Cancel an in-flight reindex or backfill operation for a subgraph. Returns the stop request status; check subgraphs_get (health) or the REST operations endpoint to confirm it reaches a terminal state.", { name: z5.string().describe("Subgraph name") }, async ({ name }) => {
+  defineTool(server, "subgraphs_stop", "Cancel an in-flight reindex or backfill operation for a subgraph. Returns the stop request status; check subgraphs_get (health) or the REST operations endpoint to confirm it reaches a terminal state.", { name: z6.string().describe("Subgraph name") }, async ({ name }) => {
     const result = await clientProvider().subgraphs.stop(name);
     return jsonResponse(result);
   });
   defineTool(server, "subgraphs_gaps", "List indexing gaps (missing block ranges) for a subgraph. Each gap reports start/end/size, reason, and detected/resolved timestamps. Feed an unresolved gap's range into subgraphs_backfill to fill it. Defaults to unresolved gaps.", {
-    name: z5.string().describe("Subgraph name"),
-    limit: z5.number().int().positive().optional().describe("Max gaps to return"),
-    offset: z5.number().int().nonnegative().optional().describe("Pagination offset"),
-    resolved: z5.boolean().optional().describe("Filter by resolved state (omit for unresolved only)")
+    name: z6.string().describe("Subgraph name"),
+    limit: z6.number().int().positive().optional().describe("Max gaps to return"),
+    offset: z6.number().int().nonnegative().optional().describe("Pagination offset"),
+    resolved: z6.boolean().optional().describe("Filter by resolved state (omit for unresolved only)")
   }, async ({ name, limit, offset, resolved }) => {
     const result = await clientProvider().subgraphs.gaps(name, {
       limit,
@@ -558,16 +551,16 @@ function registerSubgraphTools(server, clientProvider = getClient) {
     });
     return jsonResponse(result);
   });
-  defineTool(server, "subgraphs_delete", "Delete a subgraph permanently.", { name: z5.string().describe("Subgraph name") }, async ({ name }) => {
+  defineTool(server, "subgraphs_delete", "Delete a subgraph permanently.", { name: z6.string().describe("Subgraph name") }, async ({ name }) => {
     const result = await clientProvider().subgraphs.delete(name);
     return textResponse(result.message);
   });
   defineTool(server, "subgraphs_deploy", "Deploy a subgraph from TypeScript code. Pass the full defineSubgraph() source — it will be bundled, validated, and deployed. Optional startBlock overrides the source definition for this deploy. Set dryRun to validate and preview the schema/DDL without writing anything. Set databaseUrl to deploy to your own Postgres (BYO data plane) — the server verifies the connection first; with dryRun it returns the DDL + grant script. A breaking BYO schema change is refused and returns a migration plan (drop + rebuild DDL) instead of deploying. Visibility defaults: managed deploys are public (anon-readable at /v1/subgraphs/<name>, name claimed in the global public namespace), BYO deploys are private. Call `subgraphs_reindex` separately if you need a forced reindex.", {
-    code: z5.string().describe("TypeScript source code containing a defineSubgraph() call"),
-    startBlock: z5.number().int().nonnegative().optional().describe("Override the definition startBlock for this deploy"),
-    databaseUrl: z5.string().optional().describe("BYO data plane: Postgres connection string to host the subgraph's schema and rows in your own database"),
-    dryRun: z5.boolean().optional().describe("Validate and preview the deploy (schema/DDL, BYO connection) without writing changes"),
-    visibility: z5.enum(["public", "private"]).optional().describe("Read visibility: public = anon /v1 reads + global name claim; private = owning account's key only. Defaults: managed → public, BYO → private.")
+    code: z6.string().describe("TypeScript source code containing a defineSubgraph() call"),
+    startBlock: z6.number().int().nonnegative().optional().describe("Override the definition startBlock for this deploy"),
+    databaseUrl: z6.string().optional().describe("BYO data plane: Postgres connection string to host the subgraph's schema and rows in your own database"),
+    dryRun: z6.boolean().optional().describe("Validate and preview the deploy (schema/DDL, BYO connection) without writing changes"),
+    visibility: z6.enum(["public", "private"]).optional().describe("Read visibility: public = anon /v1 reads + global name claim; private = owning account's key only. Defaults: managed → public, BYO → private.")
   }, async ({ code, startBlock, databaseUrl, dryRun, visibility }) => {
     const bundled = await bundleSubgraphCode(code);
     try {
@@ -592,11 +585,11 @@ function registerSubgraphTools(server, clientProvider = getClient) {
       throw err;
     }
   });
-  defineTool(server, "subgraphs_publish", "Make a subgraph publicly readable at /v1/subgraphs/<name> — anyone (or any agent) can read it without a key. Claims the name in the global public namespace; fails with PUBLIC_NAME_TAKEN if another account holds it.", { name: z5.string().describe("Subgraph name") }, async ({ name }) => {
+  defineTool(server, "subgraphs_publish", "Make a subgraph publicly readable at /v1/subgraphs/<name> — anyone (or any agent) can read it without a key. Claims the name in the global public namespace; fails with PUBLIC_NAME_TAKEN if another account holds it.", { name: z6.string().describe("Subgraph name") }, async ({ name }) => {
     const result = await clientProvider().subgraphs.publish(name);
     return jsonResponse(result);
   });
-  defineTool(server, "subgraphs_unpublish", "Make a subgraph private again — /v1 reads then require the owning account's bearer key, and the global public name claim is released.", { name: z5.string().describe("Subgraph name") }, async ({ name }) => {
+  defineTool(server, "subgraphs_unpublish", "Make a subgraph private again — /v1 reads then require the owning account's bearer key, and the global public name claim is released.", { name: z6.string().describe("Subgraph name") }, async ({ name }) => {
     const result = await clientProvider().subgraphs.unpublish(name);
     return jsonResponse(result);
   });
@@ -604,38 +597,38 @@ function registerSubgraphTools(server, clientProvider = getClient) {
 
 // src/tools/subscriptions.ts
 import { CHAIN_TRIGGER_TYPES } from "@secondlayer/shared";
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 function registerSubscriptionTools(server, clientProvider = getClient) {
   defineTool(server, "subscriptions_list", "List all subscriptions for the current account. Returns summary fields (no secrets).", {}, async () => {
     const { data } = await clientProvider().subscriptions.list();
     return jsonResponse(data);
   });
-  defineTool(server, "subscriptions_get", "Get full detail for a subscription (filter, auth, retry config, circuit state).", { id: z6.string().describe("Subscription id") }, async ({ id }) => {
+  defineTool(server, "subscriptions_get", "Get full detail for a subscription (filter, auth, retry config, circuit state).", { id: z7.string().describe("Subscription id") }, async ({ id }) => {
     const detail = await clientProvider().subscriptions.get(id);
     return jsonResponse(detail);
   });
   defineTool(server, "subscriptions_create", "Create a subscription. Two kinds (mutually exclusive): a SUBGRAPH subscription fires on a subgraph table's rows (set subgraphName + tableName + optional filter); a CHAIN subscription fires on raw chain events with no subgraph (set triggers). Returns `signingSecret` ONCE — forward it to the user so they can wire it into their receiver.", {
-    name: z6.string().describe("Human-readable name, unique per account"),
-    subgraphName: z6.string().optional().describe("Subgraph to subscribe to (subgraph subscription)"),
-    tableName: z6.string().optional().describe("Table within the subgraph (subgraph subscription)"),
-    triggers: z6.array(z6.object({
-      type: z6.enum(CHAIN_TRIGGER_TYPES),
-      contractId: z6.string().optional(),
-      functionName: z6.string().optional(),
-      caller: z6.string().optional(),
-      sender: z6.string().optional(),
-      recipient: z6.string().optional(),
-      assetIdentifier: z6.string().optional(),
-      deployer: z6.string().optional(),
-      contractName: z6.string().optional(),
-      topic: z6.string().optional(),
-      lockedAddress: z6.string().optional(),
-      trait: z6.string().optional(),
-      minAmount: z6.union([z6.string(), z6.number()]).optional(),
-      maxAmount: z6.union([z6.string(), z6.number()]).optional()
+    name: z7.string().describe("Human-readable name, unique per account"),
+    subgraphName: z7.string().optional().describe("Subgraph to subscribe to (subgraph subscription)"),
+    tableName: z7.string().optional().describe("Table within the subgraph (subgraph subscription)"),
+    triggers: z7.array(z7.object({
+      type: z7.enum(CHAIN_TRIGGER_TYPES),
+      contractId: z7.string().optional(),
+      functionName: z7.string().optional(),
+      caller: z7.string().optional(),
+      sender: z7.string().optional(),
+      recipient: z7.string().optional(),
+      assetIdentifier: z7.string().optional(),
+      deployer: z7.string().optional(),
+      contractName: z7.string().optional(),
+      topic: z7.string().optional(),
+      lockedAddress: z7.string().optional(),
+      trait: z7.string().optional(),
+      minAmount: z7.union([z7.string(), z7.number()]).optional(),
+      maxAmount: z7.union([z7.string(), z7.number()]).optional()
     })).optional().describe("Chain triggers (chain subscription) — provide INSTEAD of subgraphName/tableName. Each targets a raw chain event/tx; string fields accept `*` wildcards, `trait` scopes to a SIP/trait. Per-type accepted fields: see the secondlayer://chain-triggers resource. Forward-looking: starts at chain tip, no backfill."),
-    url: z6.string().describe("Webhook URL"),
-    format: z6.enum([
+    url: z7.string().describe("Webhook URL"),
+    format: z7.enum([
       "standard-webhooks",
       "inngest",
       "trigger",
@@ -643,20 +636,20 @@ function registerSubscriptionTools(server, clientProvider = getClient) {
       "cloudevents",
       "raw"
     ]).optional().describe("Wire format (default standard-webhooks)"),
-    runtime: z6.enum(["inngest", "trigger", "cloudflare", "node"]).optional().describe("Receiver runtime label (display only)"),
-    filter: z6.record(z6.string(), z6.unknown()).optional().describe('Scalar filter DSL, e.g. {"amount": {"gte": 100}, "sender": "SP..."}'),
-    authConfig: z6.record(z6.string(), z6.unknown()).optional().describe('Receiver auth sent with each delivery, e.g. {"type": "bearer", "token": "..."}')
+    runtime: z7.enum(["inngest", "trigger", "cloudflare", "node"]).optional().describe("Receiver runtime label (display only)"),
+    filter: z7.record(z7.string(), z7.unknown()).optional().describe('Scalar filter DSL, e.g. {"amount": {"gte": 100}, "sender": "SP..."}'),
+    authConfig: z7.record(z7.string(), z7.unknown()).optional().describe('Receiver auth sent with each delivery, e.g. {"type": "bearer", "token": "..."}')
   }, async (input) => {
     const res = await clientProvider().subscriptions.create(input);
     return jsonResponse(res);
   });
   defineTool(server, "subscriptions_update", "Patch a subscription (name, url, filter, authConfig, format, runtime, retry, timeout, concurrency).", {
-    id: z6.string(),
-    name: z6.string().optional().describe("Rename the subscription"),
-    url: z6.string().optional(),
-    filter: z6.record(z6.string(), z6.unknown()).optional(),
-    authConfig: z6.record(z6.string(), z6.unknown()).optional().describe("Receiver auth sent with each delivery (bearer/etc.)"),
-    format: z6.enum([
+    id: z7.string(),
+    name: z7.string().optional().describe("Rename the subscription"),
+    url: z7.string().optional(),
+    filter: z7.record(z7.string(), z7.unknown()).optional(),
+    authConfig: z7.record(z7.string(), z7.unknown()).optional().describe("Receiver auth sent with each delivery (bearer/etc.)"),
+    format: z7.enum([
       "standard-webhooks",
       "inngest",
       "trigger",
@@ -664,27 +657,27 @@ function registerSubscriptionTools(server, clientProvider = getClient) {
       "cloudevents",
       "raw"
     ]).optional(),
-    runtime: z6.enum(["inngest", "trigger", "cloudflare", "node"]).nullable().optional(),
-    maxRetries: z6.number().int().min(0).optional(),
-    timeoutMs: z6.number().int().min(100).optional(),
-    concurrency: z6.number().int().min(1).optional()
+    runtime: z7.enum(["inngest", "trigger", "cloudflare", "node"]).nullable().optional(),
+    maxRetries: z7.number().int().min(0).optional(),
+    timeoutMs: z7.number().int().min(100).optional(),
+    concurrency: z7.number().int().min(1).optional()
   }, async ({ id, ...patch }) => {
     const res = await clientProvider().subscriptions.update(id, patch);
     return jsonResponse(res);
   });
-  defineTool(server, "subscriptions_delete", "Delete a subscription. Pending outbox rows are cascade-deleted.", { id: z6.string() }, async ({ id }) => {
+  defineTool(server, "subscriptions_delete", "Delete a subscription. Pending outbox rows are cascade-deleted.", { id: z7.string() }, async ({ id }) => {
     const res = await clientProvider().subscriptions.delete(id);
     return jsonResponse(res);
   });
-  defineTool(server, "subscriptions_test", "Send a one-off test webhook to a subscription's URL (built for its format, SSRF-guarded). Logged as a delivery row. Returns {ok, statusCode, error, durationMs, deliveryId}.", { id: z6.string().describe("Subscription id") }, async ({ id }) => {
+  defineTool(server, "subscriptions_test", "Send a one-off test webhook to a subscription's URL (built for its format, SSRF-guarded). Logged as a delivery row. Returns {ok, statusCode, error, durationMs, deliveryId}.", { id: z7.string().describe("Subscription id") }, async ({ id }) => {
     const res = await clientProvider().subscriptions.test(id);
     return jsonResponse(res);
   });
   defineTool(server, "subscriptions_replay", "Replay a block range for a subscription. Replays run at 10% of batch capacity — use sparingly. Pass `force` (a short idempotency suffix) to re-run a range that was already replayed.", {
-    id: z6.string(),
-    fromBlock: z6.number().int().nonnegative(),
-    toBlock: z6.number().int().nonnegative(),
-    force: z6.string().optional().describe("Idempotency suffix to force a duplicate replay of the range")
+    id: z7.string(),
+    fromBlock: z7.number().int().nonnegative(),
+    toBlock: z7.number().int().nonnegative(),
+    force: z7.string().optional().describe("Idempotency suffix to force a duplicate replay of the range")
   }, async ({ id, fromBlock, toBlock, force }) => {
     const res = await clientProvider().subscriptions.replay(id, {
       fromBlock,
@@ -710,6 +703,7 @@ function createServer() {
   registerIndexTools(server);
   registerStreamsTools(server);
   registerContractTools(server);
+  registerCodegenTools(server);
   registerResources(server);
   return server;
 }
@@ -719,5 +713,5 @@ var server = createServer();
 var transport = new StdioServerTransport;
 await server.connect(transport);
 
-//# debugId=379C15B55672E64764756E2164756E21
+//# debugId=8D577F42C433C3A164756E2164756E21
 //# sourceMappingURL=bin.js.map