@secondlayer/mcp 11.4.0 → 11.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/bin-http.js CHANGED
@@ -24,6 +24,7 @@ function isHostedArchiveUrl(url) {
24
24
  }
25
25
 
26
26
  // src/lib/tool.ts
27
+ import { z } from "zod";
27
28
  var registeredToolNames = new Set;
28
29
  var serverToolNames = new WeakMap;
29
30
  var serverToolFilters = new WeakMap;
@@ -77,7 +78,10 @@ function defineTool(server, name, description, schema, handler) {
77
78
  const names = serverToolNames.get(server) ?? new Set;
78
79
  names.add(name);
79
80
  serverToolNames.set(server, names);
80
- server.tool(name, description, schema, wrappedHandler);
81
+ const registered = server.tool(name, description, schema, wrappedHandler);
82
+ if (registered) {
83
+ registered.inputSchema = z.strictObject(schema);
84
+ }
81
85
  }
82
86
 
83
87
  // src/resources.ts
@@ -457,21 +461,21 @@ async function buildSamplesResource(contractId, clientProvider = getClient) {
457
461
  }
458
462
 
459
463
  // src/tools/account.ts
460
- import { z } from "zod";
464
+ import { z as z2 } from "zod";
461
465
  function registerAccountTools(server, request = apiRequest, currentKey = readApiKey) {
462
466
  defineTool(server, "account_whoami", "Show the archive account email at api.secondlayer.tools, not the self-host instance.", {}, async () => {
463
467
  const result = await request("GET", "/api/accounts/me");
464
468
  return jsonResponse(result);
465
469
  });
466
470
  defineTool(server, "account_create_key", "Mint an account key (sk-sl_*) for archive credits, quote, and fetch at api.secondlayer.tools. The returned `key` is shown ONCE.", {
467
- name: z.string().optional().describe("Optional label for the key")
471
+ name: z2.string().optional().describe("Optional label for the key")
468
472
  }, async ({ name }) => jsonResponse(await request("POST", "/api/keys", { name })));
469
473
  defineTool(server, "account_list_keys", "List this account's active account keys at api.secondlayer.tools: id, prefix, name, last read. Never returns a secret. Use an id with account_rotate_key.", {}, async () => {
470
474
  const keys = await activeAccountKeys(request);
471
475
  return jsonResponse({ keys });
472
476
  });
473
477
  defineTool(server, "account_rotate_key", "Replace an account key's secret at api.secondlayer.tools, keeping its name. The old secret gets 401 at once, with no grace period, so everything using it breaks until updated: get human confirmation first. The returned key is shown ONCE. Refuses the key this server runs on.", {
474
- id: z.string().uuid().describe("Key id from account_list_keys")
478
+ id: z2.string().uuid().describe("Key id from account_list_keys")
475
479
  }, async ({ id }) => {
476
480
  const { keys } = await request("GET", "/api/keys");
477
481
  const row = keys.find((k) => k.id === id);
@@ -487,7 +491,7 @@ async function activeAccountKeys(request) {
487
491
  }
488
492
 
489
493
  // src/tools/archive-cli.ts
490
- import { z as z2 } from "zod";
494
+ import { z as z3 } from "zod";
491
495
 
492
496
  // src/lib/exec-cli.ts
493
497
  import {
@@ -631,9 +635,9 @@ function cliResponse(result) {
631
635
  }
632
636
  function registerArchiveCliTools(server, exec = execSecondlayer) {
633
637
  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.", {
634
- against: z2.string().describe("Archive manifest URL"),
635
- fromBlock: z2.number().int().nonnegative().optional().describe("Restore from this height instead of genesis"),
636
- toBlock: z2.number().int().nonnegative().optional().describe("Stop at this height instead of the archive tip")
638
+ against: z3.string().describe("Archive manifest URL"),
639
+ fromBlock: z3.number().int().nonnegative().optional().describe("Restore from this height instead of genesis"),
640
+ toBlock: z3.number().int().nonnegative().optional().describe("Stop at this height instead of the archive tip")
637
641
  }, async ({ against, fromBlock, toBlock }) => {
638
642
  const args = ["--against", against, "--yes", "--json"];
639
643
  if (fromBlock !== undefined)
@@ -643,10 +647,10 @@ function registerArchiveCliTools(server, exec = execSecondlayer) {
643
647
  return cliResponse(await exec("bootstrap", args));
644
648
  });
645
649
  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.", {
646
- against: z2.string().describe("Archive manifest URL"),
647
- apply: z2.boolean().optional().describe("Write the repair (default plan-only)"),
648
- fromBlock: z2.number().int().nonnegative().optional().describe("First height to consider"),
649
- toBlock: z2.number().int().nonnegative().optional().describe("Last height to consider")
650
+ against: z3.string().describe("Archive manifest URL"),
651
+ apply: z3.boolean().optional().describe("Write the repair (default plan-only)"),
652
+ fromBlock: z3.number().int().nonnegative().optional().describe("First height to consider"),
653
+ toBlock: z3.number().int().nonnegative().optional().describe("Last height to consider")
650
654
  }, async ({ against, apply, fromBlock, toBlock }) => {
651
655
  const args = ["--against", against, "--json"];
652
656
  if (apply)
@@ -660,14 +664,14 @@ function registerArchiveCliTools(server, exec = execSecondlayer) {
660
664
  }
661
665
 
662
666
  // src/tools/archive.ts
663
- import { z as z3 } from "zod";
667
+ import { z as z4 } from "zod";
664
668
  var FLOW = ["bootstrap", "repair"];
665
669
  function registerArchiveTools(server, clientProvider = getClient, archiveOpsClientProvider = getArchiveOpsClient) {
666
670
  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.", {
667
- against: z3.string().describe("Archive manifest URL"),
668
- fromBlock: z3.number().int().nonnegative().optional().describe("First height (inclusive)"),
669
- toBlock: z3.number().int().nonnegative().optional().describe("Last height (inclusive)"),
670
- target: z3.string().optional().describe("Verify target (default raw)")
671
+ against: z4.string().describe("Archive manifest URL"),
672
+ fromBlock: z4.number().int().nonnegative().optional().describe("First height (inclusive)"),
673
+ toBlock: z4.number().int().nonnegative().optional().describe("Last height (inclusive)"),
674
+ target: z4.string().optional().describe("Verify target (default raw)")
671
675
  }, async ({ against, fromBlock, toBlock, target }) => jsonResponse(await clientProvider().archive.verify({
672
676
  against,
673
677
  fromBlock,
@@ -675,11 +679,11 @@ function registerArchiveTools(server, clientProvider = getClient, archiveOpsClie
675
679
  target
676
680
  })));
677
681
  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.", {
678
- against: z3.string().optional().describe("Override latest.json URL (default official tree)")
682
+ against: z4.string().optional().describe("Override latest.json URL (default official tree)")
679
683
  }, async ({ against }) => jsonResponse(await archiveOpsClientProvider().archive.latest(against)));
680
684
  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.", {
681
- paths: z3.array(z3.string()).describe("Partition paths to price"),
682
- flow: z3.enum(FLOW).describe("bootstrap or repair")
685
+ paths: z4.array(z4.string()).describe("Partition paths to price"),
686
+ flow: z4.enum(FLOW).describe("bootstrap or repair")
683
687
  }, async ({ paths, flow }) => jsonResponse(await archiveOpsClientProvider().archive.quote({ paths, flow })));
684
688
  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()));
685
689
  }
@@ -688,14 +692,14 @@ function registerArchiveTools(server, clientProvider = getClient, archiveOpsClie
688
692
  import {
689
693
  generateIndexSchema
690
694
  } from "@secondlayer/subgraphs";
691
- import { z as z4 } from "zod";
695
+ import { z as z5 } from "zod";
692
696
  var TARGETS = ["prisma", "kysely", "drizzle", "json-schema"];
693
697
  function registerCodegenTools(server) {
694
698
  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.", {
695
- target: z4.enum(TARGETS).optional().describe("Output flavor (default kysely)"),
696
- tables: z4.array(z4.string()).optional().describe("Restrict to these Index tables (default: all)"),
697
- schemaName: z4.string().optional().describe("Postgres schema to qualify table names with"),
698
- datasourceEnv: z4.string().optional().describe("Prisma only: datasource url env var (default DATABASE_URL)")
699
+ target: z5.enum(TARGETS).optional().describe("Output flavor (default kysely)"),
700
+ tables: z5.array(z5.string()).optional().describe("Restrict to these Index tables (default: all)"),
701
+ schemaName: z5.string().optional().describe("Postgres schema to qualify table names with"),
702
+ datasourceEnv: z5.string().optional().describe("Prisma only: datasource url env var (default DATABASE_URL)")
699
703
  }, ({ target, tables, schemaName, datasourceEnv }) => textResponse(generateIndexSchema(target ?? "kysely", {
700
704
  tables,
701
705
  schemaName,
@@ -704,17 +708,17 @@ function registerCodegenTools(server) {
704
708
  }
705
709
 
706
710
  // src/tools/contracts.ts
707
- import { z as z5 } from "zod";
711
+ import { z as z6 } from "zod";
708
712
  function registerContractTools(server, clientProvider = getClient) {
709
713
  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.', {
710
- trait: z5.string().describe('Required. Trait to match (e.g. "sip-010").'),
711
- conformance: z5.enum(["declared", "inferred", "any"]).optional().describe("declared = parsed from source, inferred = ABI shape-match, any = either (default)"),
712
- include: z5.literal("abi").optional().describe(`Set to "abi" to include each contract's full ABI`),
713
- limit: z5.number().optional().describe("Page size, 1–500 (default 100)"),
714
- cursor: z5.string().optional().describe("Opaque cursor from a prior response's next_cursor")
714
+ trait: z6.string().describe('Required. Trait to match (e.g. "sip-010").'),
715
+ conformance: z6.enum(["declared", "inferred", "any"]).optional().describe("declared = parsed from source, inferred = ABI shape-match, any = either (default)"),
716
+ include: z6.literal("abi").optional().describe(`Set to "abi" to include each contract's full ABI`),
717
+ limit: z6.number().optional().describe("Page size, 1–500 (default 100)"),
718
+ cursor: z6.string().optional().describe("Opaque cursor from a prior response's next_cursor")
715
719
  }, async (params) => jsonResponse(await clientProvider().contracts.list(params)));
716
720
  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.", {
717
- contractId: z5.string().describe("Fully qualified contract id (e.g. SP….amm-pool-v2-01)")
721
+ contractId: z6.string().describe("Fully qualified contract id (e.g. SP….amm-pool-v2-01)")
718
722
  }, async ({ contractId }) => {
719
723
  const contract = await clientProvider().contracts.get(contractId, {
720
724
  includeAbi: true
@@ -731,17 +735,17 @@ function registerContractTools(server, clientProvider = getClient) {
731
735
 
732
736
  // src/tools/index.ts
733
737
  import { DECODED_EVENT_TYPES } from "@secondlayer/shared";
734
- import { z as z6 } from "zod";
738
+ import { z as z7 } from "zod";
735
739
  var INDEX_EVENT_TYPES = DECODED_EVENT_TYPES;
736
740
  var rangeFilters = {
737
- contractId: z6.string().optional().describe("Filter by contract id"),
738
- fromHeight: z6.number().optional().describe("Start block height (inclusive)"),
739
- toHeight: z6.number().optional().describe("End block height (inclusive)"),
740
- cursor: z6.string().optional().describe("Opaque cursor from a prior response's next_cursor"),
741
- limit: z6.number().optional().describe("Max rows for this page")
741
+ contractId: z7.string().optional().describe("Filter by contract id"),
742
+ fromHeight: z7.number().optional().describe("Start block height (inclusive)"),
743
+ toHeight: z7.number().optional().describe("End block height (inclusive)"),
744
+ cursor: z7.string().optional().describe("Opaque cursor from a prior response's next_cursor"),
745
+ limit: z7.number().optional().describe("Max rows for this page")
742
746
  };
743
747
  var orderFilter = {
744
- order: z6.enum(["asc", "desc"]).optional().describe("asc (default) reads oldest first; desc reads newest first. A cursor only resumes under the order that issued it.")
748
+ order: z7.enum(["asc", "desc"]).optional().describe("asc (default) reads oldest first; desc reads newest first. A cursor only resumes under the order that issued it.")
745
749
  };
746
750
  var heightFilters = {
747
751
  fromHeight: rangeFilters.fromHeight,
@@ -753,47 +757,47 @@ function registerIndexTools(server, clientProvider = getClient) {
753
757
  defineTool(server, "index_ft_transfers", "List decoded SIP-010 fungible-token transfers from Index. Reads are keyless.", {
754
758
  ...rangeFilters,
755
759
  ...orderFilter,
756
- sender: z6.string().optional().describe("Filter by sender principal"),
757
- recipient: z6.string().optional().describe("Filter by recipient principal"),
758
- assetIdentifier: z6.string().optional().describe("Filter by asset identifier (contract::asset), e.g. SP…sbtc-token::sbtc-token")
760
+ sender: z7.string().optional().describe("Filter by sender principal"),
761
+ recipient: z7.string().optional().describe("Filter by recipient principal"),
762
+ assetIdentifier: z7.string().optional().describe("Filter by asset identifier (contract::asset), e.g. SP…sbtc-token::sbtc-token")
759
763
  }, async (params) => jsonResponse(await clientProvider().index.ftTransfers.list(params)));
760
764
  defineTool(server, "index_nft_transfers", "List decoded SIP-009 non-fungible-token transfers from Index. Reads are keyless.", {
761
765
  ...rangeFilters,
762
766
  ...orderFilter,
763
- sender: z6.string().optional().describe("Filter by sender principal"),
764
- recipient: z6.string().optional().describe("Filter by recipient principal"),
765
- assetIdentifier: z6.string().optional().describe("Filter by asset identifier (contract::asset)")
767
+ sender: z7.string().optional().describe("Filter by sender principal"),
768
+ recipient: z7.string().optional().describe("Filter by recipient principal"),
769
+ assetIdentifier: z7.string().optional().describe("Filter by asset identifier (contract::asset)")
766
770
  }, async (params) => jsonResponse(await clientProvider().index.nftTransfers.list(params)));
767
771
  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.", {
768
- eventType: z6.enum(INDEX_EVENT_TYPES).describe("Required. Decoded event type to list."),
772
+ eventType: z7.enum(INDEX_EVENT_TYPES).describe("Required. Decoded event type to list."),
769
773
  ...rangeFilters,
770
774
  ...orderFilter,
771
- sender: z6.string().optional().describe("Filter by sender principal"),
772
- recipient: z6.string().optional().describe("Filter by recipient principal"),
773
- assetIdentifier: z6.string().optional().describe("Filter by asset identifier where applicable"),
774
- 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."),
775
- 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.")
775
+ sender: z7.string().optional().describe("Filter by sender principal"),
776
+ recipient: z7.string().optional().describe("Filter by recipient principal"),
777
+ assetIdentifier: z7.string().optional().describe("Filter by asset identifier where applicable"),
778
+ trait: z7.string().optional().describe("Match contracts conforming to a trait/standard (e.g. sip-010). Mutually exclusive with contractId; contract-keyed event types only."),
779
+ txContext: z7.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.")
776
780
  }, async (params) => jsonResponse(await clientProvider().index.events.list(params)));
777
781
  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.", {
778
782
  ...rangeFilters,
779
- functionName: z6.string().optional().describe("Filter by called function name"),
780
- sender: z6.string().optional().describe("Filter by caller principal"),
781
- trait: z6.string().optional().describe("Match contracts conforming to a trait/standard (e.g. sip-010). Mutually exclusive with contractId.")
783
+ functionName: z7.string().optional().describe("Filter by called function name"),
784
+ sender: z7.string().optional().describe("Filter by caller principal"),
785
+ trait: z7.string().optional().describe("Match contracts conforming to a trait/standard (e.g. sip-010). Mutually exclusive with contractId.")
782
786
  }, async (params) => jsonResponse(await clientProvider().index.contractCalls.list(params)));
783
787
  defineTool(server, "index_blocks", "List decoded blocks from Index. Reads are keyless.", { ...heightFilters }, async (params) => jsonResponse(await clientProvider().index.blocks.list(params)));
784
788
  defineTool(server, "index_transactions", "List decoded transactions from Index. Filter by type, sender, or contract. Reads are keyless.", {
785
789
  ...rangeFilters,
786
- type: z6.string().optional().describe("Filter by transaction type"),
787
- sender: z6.string().optional().describe("Filter by sender principal")
790
+ type: z7.string().optional().describe("Filter by transaction type"),
791
+ sender: z7.string().optional().describe("Filter by sender principal")
788
792
  }, async (params) => jsonResponse(await clientProvider().index.transactions.list(params)));
789
793
  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.", {
790
- contractId: z6.string().describe("Contract id (SP….name) whose print events to profile")
794
+ contractId: z7.string().describe("Contract id (SP….name) whose print events to profile")
791
795
  }, async (params) => jsonResponse(await clientProvider().index.printSchema(params.contractId)));
792
796
  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()));
793
797
  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.", {
794
- requests: z6.array(z6.object({
795
- path: z6.string().describe("Public /v1 read path"),
796
- params: z6.record(z6.string(), z6.string()).optional()
798
+ requests: z7.array(z7.object({
799
+ path: z7.string().describe("Public /v1 read path"),
800
+ params: z7.record(z7.string(), z7.string()).optional()
797
801
  })).min(1).max(10).describe("Read descriptors, executed concurrently")
798
802
  }, async (params) => jsonResponse(await clientProvider().batch(params.requests)));
799
803
  }
@@ -814,7 +818,7 @@ import {
814
818
  generateSubgraphCode,
815
819
  generateTokenSubgraphFromAbi
816
820
  } from "@secondlayer/scaffold";
817
- import { z as z7 } from "zod";
821
+ import { z as z8 } from "zod";
818
822
  async function fetchAbi(clientProvider, contractId) {
819
823
  const contract = await clientProvider().contracts.get(contractId, {
820
824
  includeAbi: true
@@ -829,8 +833,8 @@ async function fetchAbi(clientProvider, contractId) {
829
833
  }
830
834
  function registerScaffoldTools(server, clientProvider = getClient) {
831
835
  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.", {
832
- contractId: z7.string().describe("Fully qualified contract ID (e.g. SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-pool-v2-01)"),
833
- subgraphName: z7.string().optional().describe("Override the subgraph name (defaults to contract name)")
836
+ contractId: z8.string().describe("Fully qualified contract ID (e.g. SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-pool-v2-01)"),
837
+ subgraphName: z8.string().optional().describe("Override the subgraph name (defaults to contract name)")
834
838
  }, async ({ contractId, subgraphName }) => {
835
839
  const printSchema = await clientProvider().index.printSchema(contractId);
836
840
  if (printSchema && printSchema.topics.length > 0) {
@@ -872,7 +876,7 @@ import { DECODED_EVENT_TYPES as DECODED_EVENT_TYPES2 } from "@secondlayer/shared
872
876
  import {
873
877
  runSubgraphTest
874
878
  } from "@secondlayer/subgraphs/testing";
875
- import { z as z8 } from "zod";
879
+ import { z as z9 } from "zod";
876
880
  function eventTypeFor(filter) {
877
881
  if (filter.type === "contract_deploy")
878
882
  return null;
@@ -898,13 +902,13 @@ function registerSubgraphTools(server, clientProvider = getClient) {
898
902
  const { data } = await clientProvider().subgraphs.list();
899
903
  return jsonResponse(data.map(formatSubgraphSummary));
900
904
  });
901
- defineTool(server, "subgraphs_status", "Get full details of a subgraph including schema, health (incl. health.emptyMapping when processed events wrote 0 rows), and table columns.", { name: z8.string().describe("Subgraph name") }, async ({ name }) => {
905
+ defineTool(server, "subgraphs_status", "Get full details of a subgraph including schema, health (incl. health.emptyMapping when processed events wrote 0 rows), and table columns.", { name: z9.string().describe("Subgraph name") }, async ({ name }) => {
902
906
  const detail = await clientProvider().subgraphs.status(name);
903
907
  return jsonResponse(detail);
904
908
  });
905
909
  defineTool(server, "subgraphs_spec", "Fetch a subgraph's self-describing spec — the tables, columns, filters, and read URLs a consumer needs, without guessing. `agent` (default) returns the compact JSON schema built for tool use, `openapi` the OpenAPI document for the subgraph's read routes, `markdown` human-readable docs. Read it before writing queries against an unfamiliar subgraph.", {
906
- name: z8.string().describe("Subgraph name"),
907
- format: z8.enum(["agent", "openapi", "markdown"]).optional().describe("agent = JSON schema for tool use (default), openapi = OpenAPI JSON, markdown = docs.md")
910
+ name: z9.string().describe("Subgraph name"),
911
+ format: z9.enum(["agent", "openapi", "markdown"]).optional().describe("agent = JSON schema for tool use (default), openapi = OpenAPI JSON, markdown = docs.md")
908
912
  }, async ({ name, format }) => {
909
913
  const client = clientProvider();
910
914
  if (format === "openapi")
@@ -914,15 +918,15 @@ function registerSubgraphTools(server, clientProvider = getClient) {
914
918
  return jsonResponse(await client.subgraphs.schema(name));
915
919
  });
916
920
  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.', {
917
- name: z8.string().describe("Subgraph name"),
918
- table: z8.string().describe("Table name"),
919
- filters: z8.record(z8.string(), z8.string()).optional().describe('Column filters — plain values or with operators (e.g. {"amount.gte": "1000", "sender": "SP..."})'),
920
- sort: z8.string().optional().describe("Column to sort by"),
921
- order: z8.enum(["asc", "desc"]).optional().describe("Sort order"),
922
- limit: z8.number().max(200).optional().describe("Max rows (default 50, max 200)"),
923
- cursor: z8.string().optional().describe("Resume from a previous response's nextCursor"),
924
- fields: z8.string().optional().describe('Comma-separated column list to return (e.g. "sender,amount")'),
925
- count: z8.boolean().optional().describe("If true, return row count instead of rows")
921
+ name: z9.string().describe("Subgraph name"),
922
+ table: z9.string().describe("Table name"),
923
+ filters: z9.record(z9.string(), z9.string()).optional().describe('Column filters — plain values or with operators (e.g. {"amount.gte": "1000", "sender": "SP..."})'),
924
+ sort: z9.string().optional().describe("Column to sort by"),
925
+ order: z9.enum(["asc", "desc"]).optional().describe("Sort order"),
926
+ limit: z9.number().max(200).optional().describe("Max rows (default 50, max 200)"),
927
+ cursor: z9.string().optional().describe("Resume from a previous response's nextCursor"),
928
+ fields: z9.string().optional().describe('Comma-separated column list to return (e.g. "sender,amount")'),
929
+ count: z9.boolean().optional().describe("If true, return row count instead of rows")
926
930
  }, async ({
927
931
  name,
928
932
  table,
@@ -952,15 +956,15 @@ function registerSubgraphTools(server, clientProvider = getClient) {
952
956
  return jsonResponse({ ...capped, nextCursor: next_cursor, tip });
953
957
  });
954
958
  defineTool(server, "subgraphs_reindex", "Reindex a subgraph: drops and rebuilds the whole subgraph from its start block to chain tip. Takes no block range — use subgraphs_backfill to process a specific range. Returns an operationId — check subgraphs_status (health) or the REST operations endpoint to track progress to completion.", {
955
- name: z8.string().describe("Subgraph name")
959
+ name: z9.string().describe("Subgraph name")
956
960
  }, async ({ name }) => {
957
961
  const result = await clientProvider().subgraphs.reindex(name);
958
962
  return jsonResponse(result);
959
963
  });
960
964
  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_status (health) or the REST operations endpoint to track progress.", {
961
- name: z8.string().describe("Subgraph name"),
962
- fromBlock: z8.number().int().nonnegative().describe("Start block (inclusive)"),
963
- toBlock: z8.number().int().nonnegative().describe("End block (inclusive)")
965
+ name: z9.string().describe("Subgraph name"),
966
+ fromBlock: z9.number().int().nonnegative().describe("Start block (inclusive)"),
967
+ toBlock: z9.number().int().nonnegative().describe("End block (inclusive)")
964
968
  }, async ({ name, fromBlock, toBlock }) => {
965
969
  const result = await clientProvider().subgraphs.backfill(name, {
966
970
  fromBlock,
@@ -968,15 +972,15 @@ function registerSubgraphTools(server, clientProvider = getClient) {
968
972
  });
969
973
  return jsonResponse(result);
970
974
  });
971
- defineTool(server, "subgraphs_stop", "Cancel an in-flight reindex or backfill operation for a subgraph. Returns the stop request status; check subgraphs_status (health) or the REST operations endpoint to confirm it reaches a terminal state.", { name: z8.string().describe("Subgraph name") }, async ({ name }) => {
975
+ defineTool(server, "subgraphs_stop", "Cancel an in-flight reindex or backfill operation for a subgraph. Returns the stop request status; check subgraphs_status (health) or the REST operations endpoint to confirm it reaches a terminal state.", { name: z9.string().describe("Subgraph name") }, async ({ name }) => {
972
976
  const result = await clientProvider().subgraphs.stop(name);
973
977
  return jsonResponse(result);
974
978
  });
975
979
  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.", {
976
- name: z8.string().describe("Subgraph name"),
977
- limit: z8.number().int().positive().optional().describe("Max gaps to return"),
978
- offset: z8.number().int().nonnegative().optional().describe("Pagination offset"),
979
- resolved: z8.boolean().optional().describe("Filter by resolved state (omit for unresolved only)")
980
+ name: z9.string().describe("Subgraph name"),
981
+ limit: z9.number().int().positive().optional().describe("Max gaps to return"),
982
+ offset: z9.number().int().nonnegative().optional().describe("Pagination offset"),
983
+ resolved: z9.boolean().optional().describe("Filter by resolved state (omit for unresolved only)")
980
984
  }, async ({ name, limit, offset, resolved }) => {
981
985
  const result = await clientProvider().subgraphs.gaps(name, {
982
986
  limit,
@@ -986,20 +990,20 @@ function registerSubgraphTools(server, clientProvider = getClient) {
986
990
  return jsonResponse(result);
987
991
  });
988
992
  defineTool(server, "subgraphs_operations", "Operation history for a subgraph (deploy/reindex/backfill/stop), newest first — status, block range, progress, and error. THIS IS THE VERIFY CALL: after subgraphs_deploy, subgraphs_reindex, subgraphs_backfill, or subgraphs_stop, poll it with the returned operationId until `status` is terminal (completed/failed/cancelled) before reporting success. Omit operationId for the recent history.", {
989
- name: z8.string().describe("Subgraph name"),
990
- operationId: z8.string().optional().describe("Fetch one operation by id (the operationId returned by reindex/backfill/stop); omit for recent history")
993
+ name: z9.string().describe("Subgraph name"),
994
+ operationId: z9.string().optional().describe("Fetch one operation by id (the operationId returned by reindex/backfill/stop); omit for recent history")
991
995
  }, async ({ name, operationId }) => {
992
996
  const client = clientProvider();
993
997
  return jsonResponse(operationId ? await client.subgraphs.getOperation(name, operationId) : await client.subgraphs.operations(name));
994
998
  });
995
- defineTool(server, "subgraphs_delete", "Delete a subgraph permanently.", { name: z8.string().describe("Subgraph name") }, async ({ name }) => {
999
+ defineTool(server, "subgraphs_delete", "Delete a subgraph permanently.", { name: z9.string().describe("Subgraph name") }, async ({ name }) => {
996
1000
  const result = await clientProvider().subgraphs.delete(name);
997
1001
  return textResponse(result.message);
998
1002
  });
999
1003
  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. dryRun validates schema/DDL only and does not run handlers — call subgraphs_test first and deploy only when it returns ok: true with written >= 1. Call subgraphs_reindex separately if you need a forced reindex.", {
1000
- code: z8.string().describe("TypeScript source code containing a defineSubgraph() call"),
1001
- startBlock: z8.number().int().nonnegative().optional().describe("Override the definition startBlock for this deploy"),
1002
- dryRun: z8.boolean().optional().describe("Validate schema/DDL only — does not run handlers. Use subgraphs_test to prove a mapping writes rows.")
1004
+ code: z9.string().describe("TypeScript source code containing a defineSubgraph() call"),
1005
+ startBlock: z9.number().int().nonnegative().optional().describe("Override the definition startBlock for this deploy"),
1006
+ dryRun: z9.boolean().optional().describe("Validate schema/DDL only — does not run handlers. Use subgraphs_test to prove a mapping writes rows.")
1003
1007
  }, async ({ code, startBlock, dryRun }) => {
1004
1008
  const bundled = await bundleSubgraphCode(code);
1005
1009
  const result = await clientProvider().subgraphs.deploy({
@@ -1015,10 +1019,10 @@ function registerSubgraphTools(server, clientProvider = getClient) {
1015
1019
  return jsonResponse(result);
1016
1020
  });
1017
1021
  defineTool(server, "subgraphs_test", "Prove a subgraph mapping writes rows against Index data before deploy. Pass full defineSubgraph() source plus a height range. Returns ok/written/tables; EMPTY_MAPPING means events matched but 0 rows were written — read hint for observed event.data keys and do not invent fields. subgraphs_deploy dryRun is DDL only; do not deploy until ok: true with written >= 1.", {
1018
- code: z8.string().describe("TypeScript source containing a defineSubgraph() call"),
1019
- fromHeight: z8.number().int().nonnegative().describe("Start block height (inclusive)"),
1020
- toHeight: z8.number().int().nonnegative().optional().describe("End block height (inclusive); default fromHeight+100"),
1021
- limit: z8.number().int().positive().max(200).optional().describe("Max Index rows per source (default 50, max 200)")
1022
+ code: z9.string().describe("TypeScript source containing a defineSubgraph() call"),
1023
+ fromHeight: z9.number().int().nonnegative().describe("Start block height (inclusive)"),
1024
+ toHeight: z9.number().int().nonnegative().optional().describe("End block height (inclusive); default fromHeight+100"),
1025
+ limit: z9.number().int().positive().max(200).optional().describe("Max Index rows per source (default 50, max 200)")
1022
1026
  }, async ({ code, fromHeight, toHeight, limit }) => {
1023
1027
  const bundled = await bundleSubgraphCode(code);
1024
1028
  const def = await loadBundledDefinition(bundled.handlerCode);
@@ -1099,36 +1103,36 @@ function registerSubgraphTools(server, clientProvider = getClient) {
1099
1103
 
1100
1104
  // src/tools/webhooks.ts
1101
1105
  import { CHAIN_TRIGGER_TYPES } from "@secondlayer/shared";
1102
- import { z as z9 } from "zod";
1106
+ import { z as z10 } from "zod";
1103
1107
  function registerWebhookTools(server, clientProvider = getClient) {
1104
1108
  defineTool(server, "webhooks_list", "List all webhooks for the current account. Returns summary fields (no secrets).", {}, async () => {
1105
1109
  const { data } = await clientProvider().webhooks.list();
1106
1110
  return jsonResponse(data);
1107
1111
  });
1108
- defineTool(server, "webhooks_get", "Get full detail for a webhook (triggers, auth, retry config, circuit state).", { id: z9.string().describe("Webhook id") }, async ({ id }) => {
1112
+ defineTool(server, "webhooks_get", "Get full detail for a webhook (triggers, auth, retry config, circuit state).", { id: z10.string().describe("Webhook id") }, async ({ id }) => {
1109
1113
  const detail = await clientProvider().webhooks.get(id);
1110
1114
  return jsonResponse(detail);
1111
1115
  });
1112
1116
  defineTool(server, "webhooks_create", "Create a webhook that fires on raw chain events (set triggers). Returns `signingSecret` ONCE — forward it to the user so they can wire it into their receiver.", {
1113
- name: z9.string().describe("Human-readable name, unique per account"),
1114
- triggers: z9.array(z9.object({
1115
- type: z9.enum(CHAIN_TRIGGER_TYPES),
1116
- contractId: z9.string().optional(),
1117
- functionName: z9.string().optional(),
1118
- caller: z9.string().optional(),
1119
- sender: z9.string().optional(),
1120
- recipient: z9.string().optional(),
1121
- assetIdentifier: z9.string().optional(),
1122
- deployer: z9.string().optional(),
1123
- contractName: z9.string().optional(),
1124
- topic: z9.string().optional(),
1125
- lockedAddress: z9.string().optional(),
1126
- trait: z9.string().optional(),
1127
- minAmount: z9.union([z9.string(), z9.number()]).optional(),
1128
- maxAmount: z9.union([z9.string(), z9.number()]).optional()
1117
+ name: z10.string().describe("Human-readable name, unique per account"),
1118
+ triggers: z10.array(z10.object({
1119
+ type: z10.enum(CHAIN_TRIGGER_TYPES),
1120
+ contractId: z10.string().optional(),
1121
+ functionName: z10.string().optional(),
1122
+ caller: z10.string().optional(),
1123
+ sender: z10.string().optional(),
1124
+ recipient: z10.string().optional(),
1125
+ assetIdentifier: z10.string().optional(),
1126
+ deployer: z10.string().optional(),
1127
+ contractName: z10.string().optional(),
1128
+ topic: z10.string().optional(),
1129
+ lockedAddress: z10.string().optional(),
1130
+ trait: z10.string().optional(),
1131
+ minAmount: z10.union([z10.string(), z10.number()]).optional(),
1132
+ maxAmount: z10.union([z10.string(), z10.number()]).optional()
1129
1133
  })).describe("Chain triggers. 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."),
1130
- url: z9.string().describe("Webhook URL"),
1131
- format: z9.enum([
1134
+ url: z10.string().describe("Webhook URL"),
1135
+ format: z10.enum([
1132
1136
  "standard-webhooks",
1133
1137
  "inngest",
1134
1138
  "trigger",
@@ -1136,17 +1140,17 @@ function registerWebhookTools(server, clientProvider = getClient) {
1136
1140
  "cloudevents",
1137
1141
  "raw"
1138
1142
  ]).optional().describe("Wire format (default standard-webhooks)"),
1139
- authConfig: z9.record(z9.string(), z9.unknown()).optional().describe('Receiver auth sent with each delivery, e.g. {"type": "bearer", "token": "..."}')
1143
+ authConfig: z10.record(z10.string(), z10.unknown()).optional().describe('Receiver auth sent with each delivery, e.g. {"type": "bearer", "token": "..."}')
1140
1144
  }, async (input) => {
1141
1145
  const res = await clientProvider().webhooks.create(input);
1142
1146
  return jsonResponse(res);
1143
1147
  });
1144
1148
  defineTool(server, "webhooks_update", "Patch a webhook (name, url, authConfig, format, retry, timeout, concurrency).", {
1145
- id: z9.string(),
1146
- name: z9.string().optional().describe("Rename the webhook"),
1147
- url: z9.string().optional(),
1148
- authConfig: z9.record(z9.string(), z9.unknown()).optional().describe("Receiver auth sent with each delivery (bearer/etc.)"),
1149
- format: z9.enum([
1149
+ id: z10.string(),
1150
+ name: z10.string().optional().describe("Rename the webhook"),
1151
+ url: z10.string().optional(),
1152
+ authConfig: z10.record(z10.string(), z10.unknown()).optional().describe("Receiver auth sent with each delivery (bearer/etc.)"),
1153
+ format: z10.enum([
1150
1154
  "standard-webhooks",
1151
1155
  "inngest",
1152
1156
  "trigger",
@@ -1154,35 +1158,35 @@ function registerWebhookTools(server, clientProvider = getClient) {
1154
1158
  "cloudevents",
1155
1159
  "raw"
1156
1160
  ]).optional(),
1157
- maxRetries: z9.number().int().min(0).optional(),
1158
- timeoutMs: z9.number().int().min(100).optional(),
1159
- concurrency: z9.number().int().min(1).optional()
1161
+ maxRetries: z10.number().int().min(0).optional(),
1162
+ timeoutMs: z10.number().int().min(100).optional(),
1163
+ concurrency: z10.number().int().min(1).optional()
1160
1164
  }, async ({ id, ...patch }) => {
1161
1165
  const res = await clientProvider().webhooks.update(id, patch);
1162
1166
  return jsonResponse(res);
1163
1167
  });
1164
- defineTool(server, "webhooks_delete", "Delete a webhook. Pending outbox rows are cascade-deleted.", { id: z9.string() }, async ({ id }) => {
1168
+ defineTool(server, "webhooks_delete", "Delete a webhook. Pending outbox rows are cascade-deleted.", { id: z10.string() }, async ({ id }) => {
1165
1169
  const res = await clientProvider().webhooks.delete(id);
1166
1170
  return jsonResponse(res);
1167
1171
  });
1168
- defineTool(server, "webhooks_test", "Send a one-off test webhook to a webhook's URL (built for its format, SSRF-guarded). Logged as a delivery row. Returns {ok, statusCode, error, durationMs, deliveryId}.", { id: z9.string().describe("Webhook id") }, async ({ id }) => {
1172
+ defineTool(server, "webhooks_test", "Send a one-off test webhook to a webhook's URL (built for its format, SSRF-guarded). Logged as a delivery row. Returns {ok, statusCode, error, durationMs, deliveryId}.", { id: z10.string().describe("Webhook id") }, async ({ id }) => {
1169
1173
  const res = await clientProvider().webhooks.test(id);
1170
1174
  return jsonResponse(res);
1171
1175
  });
1172
- defineTool(server, "webhooks_pause", "Pause a webhook: stops delivery attempts and stops queueing new ones. Nothing is deleted — resume picks the webhook back up from the tip. Verify with webhooks_get (status).", { id: z9.string().describe("Webhook id") }, async ({ id }) => jsonResponse(await clientProvider().webhooks.pause(id)));
1173
- defineTool(server, "webhooks_resume", "Resume a paused webhook (also clears a tripped circuit breaker). Deliveries restart from the current tip — use webhooks_replay for the blocks missed while paused. Verify with webhooks_get (status).", { id: z9.string().describe("Webhook id") }, async ({ id }) => jsonResponse(await clientProvider().webhooks.resume(id)));
1174
- defineTool(server, "webhooks_rotate_secret", "Rotate a webhook's signing secret. Returns the NEW `signingSecret` ONCE — forward it to the user; deliveries signed with the old secret stop verifying as soon as this returns, so the receiver must be updated.", { id: z9.string().describe("Webhook id") }, async ({ id }) => jsonResponse(await clientProvider().webhooks.rotateSecret(id)));
1175
- defineTool(server, "webhooks_deliveries", "List recent delivery attempts for a webhook — status code, attempt count, error, duration, timestamps. THIS IS THE VERIFY CALL: after webhooks_create, webhooks_test, or webhooks_replay, read it to confirm the webhook actually landed (and to see the receiver's response when it didn't) instead of trusting the enqueue result.", { id: z9.string().describe("Webhook id") }, async ({ id }) => jsonResponse(await clientProvider().webhooks.deliveries(id)));
1176
- defineTool(server, "webhooks_dead", "List a webhook's dead-letter queue — deliveries that exhausted their retries, with the outbox id, payload, and last error. Diagnose the receiver first (webhooks_get for the URL/auth, webhooks_test for a live probe), then requeue rows with webhooks_requeue.", { id: z9.string().describe("Webhook id") }, async ({ id }) => jsonResponse(await clientProvider().webhooks.dead(id)));
1176
+ defineTool(server, "webhooks_pause", "Pause a webhook: stops delivery attempts and stops queueing new ones. Nothing is deleted — resume picks the webhook back up from the tip. Verify with webhooks_get (status).", { id: z10.string().describe("Webhook id") }, async ({ id }) => jsonResponse(await clientProvider().webhooks.pause(id)));
1177
+ defineTool(server, "webhooks_resume", "Resume a paused webhook (also clears a tripped circuit breaker). Deliveries restart from the current tip — use webhooks_replay for the blocks missed while paused. Verify with webhooks_get (status).", { id: z10.string().describe("Webhook id") }, async ({ id }) => jsonResponse(await clientProvider().webhooks.resume(id)));
1178
+ defineTool(server, "webhooks_rotate_secret", "Rotate a webhook's signing secret. Returns the NEW `signingSecret` ONCE — forward it to the user; deliveries signed with the old secret stop verifying as soon as this returns, so the receiver must be updated.", { id: z10.string().describe("Webhook id") }, async ({ id }) => jsonResponse(await clientProvider().webhooks.rotateSecret(id)));
1179
+ defineTool(server, "webhooks_deliveries", "List recent delivery attempts for a webhook — status code, attempt count, error, duration, timestamps. THIS IS THE VERIFY CALL: after webhooks_create, webhooks_test, or webhooks_replay, read it to confirm the webhook actually landed (and to see the receiver's response when it didn't) instead of trusting the enqueue result.", { id: z10.string().describe("Webhook id") }, async ({ id }) => jsonResponse(await clientProvider().webhooks.deliveries(id)));
1180
+ defineTool(server, "webhooks_dead", "List a webhook's dead-letter queue — deliveries that exhausted their retries, with the outbox id, payload, and last error. Diagnose the receiver first (webhooks_get for the URL/auth, webhooks_test for a live probe), then requeue rows with webhooks_requeue.", { id: z10.string().describe("Webhook id") }, async ({ id }) => jsonResponse(await clientProvider().webhooks.dead(id)));
1177
1181
  defineTool(server, "webhooks_requeue", "Requeue ONE dead-lettered delivery for another attempt, by its outbox id from webhooks_dead. Fix the receiver first — a requeue against a still-broken endpoint just dies again. Verify with webhooks_deliveries.", {
1178
- id: z9.string().describe("Webhook id"),
1179
- outboxId: z9.string().describe("Outbox id of the dead delivery (from webhooks_dead)")
1182
+ id: z10.string().describe("Webhook id"),
1183
+ outboxId: z10.string().describe("Outbox id of the dead delivery (from webhooks_dead)")
1180
1184
  }, async ({ id, outboxId }) => jsonResponse(await clientProvider().webhooks.requeue(id, outboxId)));
1181
1185
  defineTool(server, "webhooks_replay", "Replay a block range for a webhook. Replays run at 10% of batch capacity — use sparingly. Pass `force` (a short idempotency suffix) to re-run a range that was already replayed.", {
1182
- id: z9.string(),
1183
- fromBlock: z9.number().int().nonnegative(),
1184
- toBlock: z9.number().int().nonnegative(),
1185
- force: z9.string().optional().describe("Idempotency suffix to force a duplicate replay of the range")
1186
+ id: z10.string(),
1187
+ fromBlock: z10.number().int().nonnegative(),
1188
+ toBlock: z10.number().int().nonnegative(),
1189
+ force: z10.string().optional().describe("Idempotency suffix to force a duplicate replay of the range")
1186
1190
  }, async ({ id, fromBlock, toBlock, force }) => {
1187
1191
  const res = await clientProvider().webhooks.replay(id, {
1188
1192
  fromBlock,
@@ -1380,5 +1384,5 @@ httpServer.listen(port, () => {
1380
1384
  console.error("Warning: SECONDLAYER_MCP_SECRET not set, authentication disabled");
1381
1385
  });
1382
1386
 
1383
- //# debugId=6E7F90DFCC1F6AE864756E2164756E21
1387
+ //# debugId=2D47CECF2113416564756E2164756E21
1384
1388
  //# sourceMappingURL=bin-http.js.map