@aibtc/mcp-server 1.70.1 → 1.72.0

package/dist/tools/pillar-direct.tools.js

@@ -88,6 +88,21 @@ function formatSigAuthForApi(sigAuth) {
             : "0x" + sigAuth.pubkey,
     };
 }
+/**
+ * The Pillar smart wallet's Fast Pool functions are hardcoded to pox-4
+ * (`pox-4.allow-contract-caller` + `pox4-fast-pool-v3.delegate-stx`, and
+ * `pox-4.revoke-delegate-stx`). Once PoX has moved past pox-4 those calls abort
+ * on chain, so refuse before signing instead of burning gas on a sure failure.
+ */
+async function assertFastPoolPoxActive(action) {
+    const pox = await getHiroApi(NETWORK).getPoxInfo();
+    if (!pox.contract_id.endsWith(".pox-4")) {
+        throw new Error(`${action} is unavailable: the Pillar smart wallet's Fast Pool path calls pox-4, but the ` +
+            `active PoX contract is ${pox.contract_id}, so the transaction would abort on chain. ` +
+            `This needs a Pillar wallet contract update. For STX staking on PoX-5, use stack_stx ` +
+            `with a signer manager (see list_stacking_signers).`);
+    }
+}
 // ============================================================================
 // Tool Registration
 // ============================================================================
@@ -99,13 +114,13 @@ export function registerPillarDirectTools(server) {
         description: "Generate a new secp256k1 signing keypair for Pillar smart wallet direct operations. " +
             "Returns the compressed public key (33 bytes hex). " +
             "After generation, propose this pubkey on your smart wallet contract (admin must do this).",
-        inputSchema: {
+        inputSchema: z.object({
             smartWallet: z
                 .string()
                 .default("pending")
                 .describe("Smart wallet contract ID this key is for (e.g. SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.my-wallet). " +
                 "Use 'pending' if creating a new wallet — pillar_direct_create_wallet will update it automatically."),
-        },
+        }),
     }, async ({ smartWallet }) => {
         try {
             const keyService = getSigningKeyService();
@@ -126,12 +141,12 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_key_unlock", {
         description: "Unlock a signing key for Pillar direct operations. " +
             "Uses auto-derived password. Usually not needed — tools auto-unlock on first use.",
-        inputSchema: {
+        inputSchema: z.object({
             keyId: z
                 .string()
                 .optional()
                 .describe("The signing key ID to unlock. If omitted, unlocks the first stored key."),
-        },
+        }),
     }, async ({ keyId }) => {
         try {
             const keyService = getSigningKeyService();
@@ -160,7 +175,7 @@ export function registerPillarDirectTools(server) {
     });
     server.registerTool("pillar_key_lock", {
         description: "Lock the signing key, clearing sensitive data from memory.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const keyService = getSigningKeyService();
@@ -176,7 +191,7 @@ export function registerPillarDirectTools(server) {
     });
     server.registerTool("pillar_key_info", {
         description: "Show signing key info: pubkey, smart wallet, lock status, and all stored keys.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const keyService = getSigningKeyService();
@@ -215,7 +230,7 @@ export function registerPillarDirectTools(server) {
             "Agent-signed, no browser needed. Your sBTC is supplied to Zest, borrowed against, " +
             "and re-supplied for amplified Bitcoin exposure. Backend sponsors gas. " +
             "For simple yield without leverage, use pillar_direct_supply instead.",
-        inputSchema: {
+        inputSchema: z.object({
             sbtcAmount: z
                 .number()
                 .positive()
@@ -228,7 +243,7 @@ export function registerPillarDirectTools(server) {
                 .number()
                 .positive()
                 .describe("Min sBTC from swap in sats (slippage protection)"),
-        },
+        }),
     }, async ({ sbtcAmount, aeUsdcToBorrow, minSbtcFromSwap }) => {
         try {
             const { keyService, session } = await requireActiveKey();
@@ -265,7 +280,7 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_direct_unwind", {
         description: "Close or reduce your leveraged sBTC position. Agent-signed, no browser needed. " +
             "Swaps sBTC to aeUSDC to repay debt, then withdraws remaining sBTC collateral. Backend sponsors gas.",
-        inputSchema: {
+        inputSchema: z.object({
             sbtcToSwap: z
                 .number()
                 .positive()
@@ -278,7 +293,7 @@ export function registerPillarDirectTools(server) {
                 .number()
                 .positive()
                 .describe("Min aeUSDC from swap (slippage protection, 6 decimals)"),
-        },
+        }),
     }, async ({ sbtcToSwap, sbtcToWithdraw, minAeUsdcFromSwap }) => {
         try {
             const { keyService, session } = await requireActiveKey();
@@ -317,12 +332,12 @@ export function registerPillarDirectTools(server) {
         description: "Earn yield on your Bitcoin. Supply sBTC from your Pillar smart wallet to Zest Protocol. " +
             "No leverage, no liquidation risk. Agent-signed, no browser needed. Backend sponsors gas. " +
             "For leveraged exposure (1.5x), use pillar_direct_boost instead.",
-        inputSchema: {
+        inputSchema: z.object({
             sbtcAmount: z
                 .number()
                 .positive()
                 .describe("sBTC amount in sats to supply"),
-        },
+        }),
     }, async ({ sbtcAmount }) => {
         try {
             const { keyService, session } = await requireActiveKey();
@@ -357,7 +372,7 @@ export function registerPillarDirectTools(server) {
         description: "Send sBTC from your Pillar smart wallet to a recipient. " +
             "Agent-signed, no browser needed. Supports BNS names, wallet names, or Stacks addresses. " +
             "Backend sponsors gas.",
-        inputSchema: {
+        inputSchema: z.object({
             to: z
                 .string()
                 .describe("Recipient: BNS name (muneeb.btc), Pillar wallet name, or Stacks address (SP...)"),
@@ -369,7 +384,7 @@ export function registerPillarDirectTools(server) {
                 .enum(["bns", "wallet", "address"])
                 .default("bns")
                 .describe("Type of recipient: 'bns' (default), 'wallet', or 'address'"),
-        },
+        }),
     }, async ({ to, amount, recipientType }) => {
         try {
             const { keyService, session } = await requireActiveKey();
@@ -435,7 +450,7 @@ export function registerPillarDirectTools(server) {
         description: "Configure auto-compound for your Pillar wallet. " +
             "When enabled, a keeper automatically boosts when sBTC accumulates above the trigger. " +
             "Agent-signed, no browser needed. Backend sponsors gas.",
-        inputSchema: {
+        inputSchema: z.object({
             enabled: z.boolean().describe("Enable or disable auto-compound"),
             minSbtc: z
                 .number()
@@ -445,7 +460,7 @@ export function registerPillarDirectTools(server) {
                 .number()
                 .positive()
                 .describe("sBTC amount above minimum that triggers auto-compound (in sats)"),
-        },
+        }),
     }, async ({ enabled, minSbtc, trigger }) => {
         try {
             const { keyService, session } = await requireActiveKey();
@@ -483,7 +498,7 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_direct_position", {
         description: "View your Pillar smart wallet balances (STX, sBTC, aeUSDC) and Zest position. " +
             "No signing needed — reads on-chain data.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const { session } = await requireActiveKey();
@@ -584,12 +599,12 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_direct_withdraw_collateral", {
         description: "Withdraw sBTC collateral from Zest on the Pillar smart wallet. " +
             "Agent-signed, no browser needed. Backend sponsors gas.",
-        inputSchema: {
+        inputSchema: z.object({
             sbtcAmount: z
                 .number()
                 .positive()
                 .describe("sBTC amount in sats to withdraw"),
-        },
+        }),
     }, async ({ sbtcAmount }) => {
         try {
             const { keyService, session } = await requireActiveKey();
@@ -623,11 +638,11 @@ export function registerPillarDirectTools(server) {
         description: "Add a backup admin address to your Pillar smart wallet for recovery purposes. " +
             "Agent-signed, no browser needed. The admin can help recover funds if you lose access to your passkey. " +
             "Backend sponsors gas.",
-        inputSchema: {
+        inputSchema: z.object({
             newAdmin: z
                 .string()
                 .describe("Stacks address (SP...) to add as backup admin"),
-        },
+        }),
     }, async ({ newAdmin }) => {
         try {
             const { keyService, session } = await requireActiveKey();
@@ -666,7 +681,7 @@ export function registerPillarDirectTools(server) {
             "and deploys a new smart wallet with the pubkey registered. " +
             "Backend deploys the contract and calls onboard() in background. " +
             "After ~20-30 seconds the wallet is ready for pillar_direct_* operations.",
-        inputSchema: {
+        inputSchema: z.object({
             walletName: z
                 .string()
                 .min(3)
@@ -678,7 +693,7 @@ export function registerPillarDirectTools(server) {
                 .default("SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.beta-v2-wallet")
                 .describe("Contract address of the referring wallet. " +
                 "Defaults to the Pillar team wallet if not provided."),
-        },
+        }),
     }, async ({ walletName, referredBy }) => {
         try {
             const api = getPillarApi();
@@ -744,11 +759,11 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_direct_dca_invite", {
         description: "Invite a DCA partner by email or wallet address. " +
             "DCA partners hold each other accountable — both must boost each week to keep the streak alive.",
-        inputSchema: {
+        inputSchema: z.object({
             partner: z
                 .string()
                 .describe("Partner's email address or Stacks wallet address (SP...)"),
-        },
+        }),
     }, async ({ partner }) => {
         try {
             const { session } = await requireActiveKey();
@@ -778,7 +793,7 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_direct_dca_partners", {
         description: "View your DCA partners and weekly status. " +
             "Shows active partnerships with streak, PnL, and weekly status badges, plus any pending invites.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const { session } = await requireActiveKey();
@@ -816,7 +831,7 @@ export function registerPillarDirectTools(server) {
     // --- pillar_direct_dca_leaderboard (twin of pillar_dca_leaderboard) ---
     server.registerTool("pillar_direct_dca_leaderboard", {
         description: "View the DCA streak leaderboard. Shows top partnerships by streak length, and highlights your entry if you have one.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const { session } = await requireActiveKey();
@@ -854,7 +869,7 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_direct_dca_status", {
         description: "Check your DCA schedule status. Shows all active DCA schedules (up to 10) with chunk progress " +
             "(completed, pending, failed) and next execution time.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const { session } = await requireActiveKey();
@@ -945,12 +960,12 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_direct_quote", {
         description: "Get a boost quote showing projected leverage, LTV, and swap details. " +
             "No signing needed. Use this to determine aeUsdcToBorrow and minSbtcFromSwap before calling pillar_direct_boost.",
-        inputSchema: {
+        inputSchema: z.object({
             sbtcAmount: z
                 .number()
                 .positive()
                 .describe("sBTC amount in sats to boost"),
-        },
+        }),
     }, async ({ sbtcAmount }) => {
         try {
             const api = getPillarApi();
@@ -970,7 +985,7 @@ export function registerPillarDirectTools(server) {
         description: "Resolve a recipient before sending. Resolves BNS names (.btc) via backend, " +
             "Pillar wallet names via backend, or validates a Stacks address. " +
             "Use this BEFORE pillar_direct_send to confirm the resolved address with the user.",
-        inputSchema: {
+        inputSchema: z.object({
             to: z
                 .string()
                 .describe("Recipient: BNS name (muneeb.btc), Pillar wallet name, or Stacks address (SP...)"),
@@ -978,7 +993,7 @@ export function registerPillarDirectTools(server) {
                 .enum(["bns", "wallet", "address"])
                 .default("bns")
                 .describe("Type of recipient: 'bns' (default), 'wallet', or 'address'"),
-        },
+        }),
     }, async ({ to, recipientType }) => {
         try {
             const api = getPillarApi();
@@ -1041,10 +1056,11 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_direct_stack_stx", {
         description: "Stack STX from your Pillar smart wallet via Fast Pool or Stacking DAO. " +
             "Agent-signed, no browser needed. Backend sponsors gas. " +
-            "Fast Pool delegates STX to the pox4-fast-pool-v3 contract. " +
+            "Fast Pool delegates STX to the pox4-fast-pool-v3 contract through pox-4, and is refused while " +
+            "pox-4 is not the active PoX contract (PoX-5 is live; use stack_stx for PoX-5 staking). " +
             "Stacking DAO deposits STX into Stacking DAO core for stSTX yield. " +
             "Your wallet must be enrolled in dual stacking first (automatic for v2 wallets with sBTC).",
-        inputSchema: {
+        inputSchema: z.object({
             stxAmount: z
                 .number()
                 .positive()
@@ -1053,9 +1069,12 @@ export function registerPillarDirectTools(server) {
                 .enum(["fast-pool", "stacking-dao"])
                 .describe("Stacking pool to use: 'fast-pool' (delegates to pox4-fast-pool-v3) " +
                 "or 'stacking-dao' (deposits into Stacking DAO for stSTX)"),
-        },
+        }),
     }, async ({ stxAmount, pool }) => {
         try {
+            if (pool === "fast-pool") {
+                await assertFastPoolPoxActive("Fast Pool stacking");
+            }
             const { keyService, session } = await requireActiveKey();
             const authId = generateAuthId();
             // Build SIP-018 structured data matching the contract's hash builder.
@@ -1099,12 +1118,14 @@ export function registerPillarDirectTools(server) {
     });
     // --- pillar_direct_revoke_fast_pool ---
     server.registerTool("pillar_direct_revoke_fast_pool", {
-        description: "Revoke Fast Pool STX delegation from your Pillar smart wallet. " +
+        description: "Revoke Fast Pool STX delegation from your Pillar smart wallet (pox-4 revoke-delegate-stx; " +
+            "refused while pox-4 is not the active PoX contract). " +
             "Agent-signed, no browser needed. Backend sponsors gas. " +
             "After revoking, STX stays locked until the current PoX cycle ends, then returns to liquid.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
+            await assertFastPoolPoxActive("Revoking Fast Pool");
             const { keyService, session } = await requireActiveKey();
             const authId = generateAuthId();
             const structuredData = tupleCV({
@@ -1138,7 +1159,7 @@ export function registerPillarDirectTools(server) {
             "No signing needed — reads on-chain data. " +
             "Shows STX balance (locked vs liquid), current PoX cycle info, " +
             "and dual stacking enrollment status.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const { session } = await requireActiveKey();

package/dist/tools/pillar.tools.d.ts

@@ -1,3 +1,3 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer } from "@modelcontextprotocol/server";
 export declare function registerPillarTools(server: McpServer): void;
 //# sourceMappingURL=pillar.tools.d.ts.map

package/dist/tools/pillar.tools.js

@@ -1,3 +1,5 @@
+// Pillar MCP Tools - Handoff model
+// MCP creates intent → Opens frontend → Frontend handles signing → MCP polls for result
 import { z } from "zod";
 import { getPillarApi } from "../services/pillar-api.service.js";
 import { createJsonResponse, createErrorResponse } from "../utils/index.js";
@@ -89,7 +91,7 @@ export function registerPillarTools(server) {
     server.registerTool("pillar_connect", {
         description: "Connect to your Pillar smart wallet. Opens the Pillar website - if you're logged in, " +
             "it will automatically connect and return your wallet address. Use this first before other Pillar actions.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const api = getPillarApi();
@@ -143,7 +145,7 @@ export function registerPillarTools(server) {
     // Tool 2: Disconnect from Pillar
     server.registerTool("pillar_disconnect", {
         description: "Disconnect from Pillar. Clears locally stored wallet address.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         const session = await loadSession();
         await clearSession();
@@ -157,7 +159,7 @@ export function registerPillarTools(server) {
     // Tool 3: Get Pillar connection status
     server.registerTool("pillar_status", {
         description: "Check if you're connected to Pillar and get your wallet address.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         const session = await loadSession();
         if (session) {
@@ -178,11 +180,11 @@ export function registerPillarTools(server) {
         description: "Send sBTC from your Pillar smart wallet. Requires being connected first (use pillar_connect). " +
             "Opens the frontend for signing, then waits for confirmation. " +
             "Supports three recipient types: 'bns' for BNS names (muneeb.btc), 'wallet' for Pillar wallet names (iphone), 'address' for Stacks addresses (SP...).",
-        inputSchema: {
+        inputSchema: z.object({
             to: z.string().describe("Recipient: BNS name (muneeb.btc), Pillar wallet name (iphone), or Stacks address (SP...)"),
             amount: z.number().positive().describe("Amount in satoshis"),
             recipientType: z.enum(["bns", "wallet", "address"]).optional().describe("Type of recipient: 'bns' (default), 'wallet' for Pillar smart wallets, or 'address' for raw Stacks addresses"),
-        },
+        }),
     }, async ({ to, amount, recipientType }) => {
         try {
             // Get wallet address from session
@@ -249,10 +251,10 @@ export function registerPillarTools(server) {
             "- 'btc': Deposit BTC from your Leather/Xverse wallet - auto-converts to sBTC\n" +
             "- 'sbtc': Deposit sBTC directly from your Leather/Xverse wallet\n" +
             "Opens the frontend with the appropriate deposit flow.",
-        inputSchema: {
+        inputSchema: z.object({
             method: z.enum(["exchange", "btc", "sbtc"]).describe("Funding method: 'exchange' (deposit from Coinbase/Binance), 'btc' (from Leather/Xverse BTC), 'sbtc' (from Leather/Xverse sBTC)"),
             amount: z.number().positive().optional().describe("Amount in satoshis to deposit (optional, can be set in UI)"),
-        },
+        }),
     }, async ({ method, amount }) => {
         try {
             const session = await loadSession();
@@ -300,9 +302,9 @@ export function registerPillarTools(server) {
     server.registerTool("pillar_add_admin", {
         description: "Add a backup admin address to your Pillar smart wallet for recovery purposes. " +
             "The admin can help recover funds if you lose access to your passkey.",
-        inputSchema: {
+        inputSchema: z.object({
             adminAddress: z.string().optional().describe("Stacks address (SP...) to add as backup admin (can be set in UI)"),
-        },
+        }),
     }, async ({ adminAddress }) => {
         try {
             const session = await loadSession();
@@ -346,9 +348,9 @@ export function registerPillarTools(server) {
         description: "Earn yield on your Bitcoin. Supply sBTC from your Pillar smart wallet to Zest Protocol. " +
             "Your sBTC earns interest with no leverage and no liquidation risk. " +
             "This is the simplest way to earn on Pillar (Earn tab). For leveraged exposure, use pillar_boost instead.",
-        inputSchema: {
+        inputSchema: z.object({
             amount: z.number().positive().optional().describe("Amount in satoshis to supply (optional, can be set in UI)"),
-        },
+        }),
     }, async ({ amount }) => {
         try {
             const session = await loadSession();
@@ -391,10 +393,10 @@ export function registerPillarTools(server) {
     server.registerTool("pillar_auto_compound", {
         description: "Configure auto-compound for your Pillar wallet. " +
             "When enabled, a keeper will automatically boost your position when sBTC accumulates in your wallet.",
-        inputSchema: {
+        inputSchema: z.object({
             minSbtc: z.number().nonnegative().optional().describe("Minimum sBTC to keep in wallet (in sats)"),
             trigger: z.number().positive().optional().describe("Amount above minimum that triggers auto-compound (in sats)"),
-        },
+        }),
     }, async ({ minSbtc, trigger }) => {
         try {
             const session = await loadSession();
@@ -435,9 +437,9 @@ export function registerPillarTools(server) {
     server.registerTool("pillar_unwind", {
         description: "Close or reduce your leveraged sBTC position. " +
             "Opens a modal to repay borrowed sBTC and withdraw collateral back to your wallet.",
-        inputSchema: {
+        inputSchema: z.object({
             percentage: z.number().min(1).max(100).optional().describe("Percentage of position to unwind (1-100, optional, can be set in UI)"),
-        },
+        }),
     }, async ({ percentage }) => {
         try {
             const session = await loadSession();
@@ -484,9 +486,9 @@ export function registerPillarTools(server) {
             "For simple yield without leverage, use pillar_supply (Earn) instead. " +
             "Amounts over 100,000 sats automatically enter DCA mode -- split into daily 100k-sat chunks " +
             "(max 700k sats per schedule). The first chunk executes immediately, the rest follow daily.",
-        inputSchema: {
+        inputSchema: z.object({
             amount: z.number().positive().optional().describe("Amount in satoshis to boost (optional, shown as suggestion)"),
-        },
+        }),
     }, async ({ amount }) => {
         try {
             const session = await loadSession();
@@ -529,7 +531,7 @@ export function registerPillarTools(server) {
     server.registerTool("pillar_position", {
         description: "View your Pillar wallet balance and Zest position. " +
             "Opens the Position page in the browser AND returns the data (sBTC balance, collateral, borrowed, LTV, liquidation price).",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const session = await loadSession();
@@ -606,9 +608,9 @@ export function registerPillarTools(server) {
         description: "Create a new Pillar smart wallet. Opens the Pillar website to complete registration. " +
             "You'll need to enter your email to receive updates. " +
             "If the user doesn't have a referral link, tell them they can DM @pillar_btc on X (https://x.com/pillar_btc) to request one before signing up.",
-        inputSchema: {
+        inputSchema: z.object({
             referral: z.string().optional().describe("Referral wallet address (optional, defaults to MCP referral)"),
-        },
+        }),
     }, async ({ referral }) => {
         try {
             // Check if already connected
@@ -662,7 +664,7 @@ export function registerPillarTools(server) {
     // Tool 13: Get referral/invite link
     server.registerTool("pillar_invite", {
         description: "Get your Pillar referral link to invite friends. Share this link and earn rewards when friends sign up.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const session = await loadSession();
@@ -688,9 +690,9 @@ export function registerPillarTools(server) {
     server.registerTool("pillar_dca_invite", {
         description: "Invite a DCA partner by email or wallet address. " +
             "DCA partners hold each other accountable — both must boost each week to keep the streak alive.",
-        inputSchema: {
+        inputSchema: z.object({
             partner: z.string().describe("Partner's email address or Stacks wallet address (SP...)"),
-        },
+        }),
     }, async ({ partner }) => {
         try {
             const session = await loadSession();
@@ -724,7 +726,7 @@ export function registerPillarTools(server) {
     server.registerTool("pillar_dca_partners", {
         description: "View your DCA partners and weekly status. " +
             "Shows active partnerships with streak, PnL, and weekly status badges, plus any pending invites.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const session = await loadSession();
@@ -766,7 +768,7 @@ export function registerPillarTools(server) {
     // Tool 16: DCA streak leaderboard (direct API)
     server.registerTool("pillar_dca_leaderboard", {
         description: "View the DCA streak leaderboard. Shows top partnerships by streak length, and highlights your entry if you have one.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const session = await loadSession();
@@ -806,7 +808,7 @@ export function registerPillarTools(server) {
     server.registerTool("pillar_dca_status", {
         description: "Check your DCA schedule status. Shows all active DCA schedules (up to 10) with chunk progress " +
             "(completed, pending, failed) and next execution time.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const session = await loadSession();

package/dist/tools/profiles.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Tool profiles: which tools the server exposes.
+ *
+ * Every tool definition is sent to the client's model on each session, so
+ * `--install` writes `AIBTC_TOOLS=core`: a lean set covering wallet, balances,
+ * transfers, x402 and earning. Other groups are added with
+ * `AIBTC_TOOLS=core,defi,ordinals` (the core set is always included).
+ *
+ * An unset AIBTC_TOOLS loads every tool: configs written before profiles
+ * existed have no AIBTC_TOOLS, and their users keep the tools they had.
+ */
+/** Tools exposed by default, whatever groups are enabled. */
+export declare const CORE_TOOLS: ReadonlySet<string>;
+export declare const TOOL_GROUPS: {
+    readonly wallet: "Wallet management extras, encrypted credential store";
+    readonly stacks: "Stacks transactions, contracts, tokens, NFTs, chain queries, nonce tools";
+    readonly sbtc: "sBTC deposit/withdraw, Styx BTC→sBTC";
+    readonly bitcoin: "Bitcoin L1 UTXOs, mempool watch";
+    readonly lightning: "Lightning (Spark) wallet and L402 payments";
+    readonly stacking: "PoX stacking, dual stacking, StackSpot";
+    readonly defi: "ALEX, Zest, Bitflow, Jingswap, yield hunter/dashboard, Tenero analytics";
+    readonly pillar: "Pillar smart wallet";
+    readonly ordinals: "Inscriptions, runes, PSBT, ordinals marketplace/P2P, taproot multisig";
+    readonly bns: "BNS names";
+    readonly identity: "ERC-8004 identity and reputation, message signing";
+    readonly social: "Nostr, AIBTC inbox";
+    readonly earn: "Bounty board (create, accept, pay, my views)";
+    readonly legion: "AIBTC News Legion";
+    readonly markets: "Stacks prediction market, At Stake";
+    readonly dev: "Scaffolding, OpenRouter, settings, inference marketplace, arXiv";
+};
+export type ToolGroup = keyof typeof TOOL_GROUPS;
+/** Which tools to expose: every tool, or the core set plus the named groups. */
+export type ToolSelection = {
+    all: true;
+} | {
+    all: false;
+    groups: ReadonlySet<ToolGroup>;
+};
+export declare const ALL_TOOLS: ToolSelection;
+export declare function isToolGroup(name: string): name is ToolGroup;
+export declare function isToolSelected(selection: ToolSelection, name: string, group: ToolGroup): boolean;
+/**
+ * Resolve the selection from `--profile <lean|full>` and `AIBTC_TOOLS`
+ * (`all`, or `core` and/or comma-separated group names; unset means `all`).
+ * Unknown values throw so a typo doesn't silently hide tools.
+ */
+export declare function resolveToolSelection(argv?: readonly string[], env?: NodeJS.ProcessEnv): ToolSelection;
+/** Server-instructions paragraph telling the agent what is off and how to turn it on. */
+export declare function describeSelection(selection: ToolSelection): string;
+//# sourceMappingURL=profiles.d.ts.map