@leashmarket/mcp-core 0.1.0

package/dist/tools/set-spend-limit.js

@@ -0,0 +1,52 @@
+/**
+ * `leash_set_spend_limit` — owner-driven update of the SPL `Approve`
+ * delegation that lets the executive spend stables out of the agent
+ * treasury PDA.
+ *
+ * Why this exists
+ * ---------------
+ * On mint, `mintAgentLocally` writes `u64::MAX` so the very first
+ * `leash_pay_payment_link` doesn't fail with `no_delegate`. That's the
+ * right default for a fresh agent — but operators sometimes want
+ * tighter control:
+ *
+ *   - Set a hard cap (e.g. $100 USDC) the agent cannot exceed without
+ *     an explicit re-approval.
+ *   - Revoke entirely while paused / under maintenance.
+ *   - Bump the cap back to unlimited after a revoke.
+ *
+ * The standalone MCP signs the tx with the local owner keypair; the
+ * chat product returns a `manual` artifact and points the user at
+ * Profile → Agent (browser-side signing via Privy).
+ */
+import { z } from 'zod';
+import { defineTool } from '../tool.js';
+const inputSchema = z.object({
+    symbol: z
+        .enum(['USDC', 'USDG', 'USDT'])
+        .optional()
+        .describe('SPL stable to update the delegation for. Defaults to USDC. The agent treasury can hold each independently — set per-mint as needed.'),
+    mode: z
+        .enum(['unlimited', 'revoke', 'amount'])
+        .optional()
+        .describe('`unlimited` (default) — write `u64::MAX`, the protocol default. `revoke` — drop the delegation entirely; the executive can no longer move funds from the treasury until you re-approve. `amount` — set a custom cap, requires the `amount` field.'),
+    amount: z
+        .number()
+        .positive()
+        .max(1_000_000_000)
+        .optional()
+        .describe('Required when `mode: "amount"`. Decimal amount in human-readable token units (e.g. `100` = $100 USDC). The host applies the mint\'s `decimals` automatically.'),
+});
+export const setSpendLimitTool = defineTool({
+    name: 'leash_set_spend_limit',
+    description: [
+        "Update the SPL `Approve` delegation that lets the agent's executive keypair spend stables from the treasury PDA.",
+        'On mint Leash writes unlimited (`u64::MAX`) so the agent can settle x402 payments without a `no_delegate` failure. Use this tool to tighten, loosen, or revoke that authority later.',
+        'Pass `mode: "amount"` + `amount` to set a per-token cap (e.g. $100 USDC). Pass `mode: "revoke"` to zero it out; the agent will not be able to settle outgoing payments until you re-approve. Pass `mode: "unlimited"` (or omit `mode`) to restore the default.',
+        'Owner-only — the tx is signed locally with the executive/owner keypair (`mpl-core::Execute(SPL.Approve|Revoke)`). Effects are immediate on confirmation.',
+        'Reading: pair this with `leash_get_spend_limit` to inspect the current delegation + treasury balance before / after the change.',
+    ].join(' '),
+    inputSchema,
+    handler: async (args, ctx) => ctx.setSpendLimit(args),
+});
+//# sourceMappingURL=set-spend-limit.js.map

package/dist/tools/set-spend-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-spend-limit.js","sourceRoot":"","sources":["../../src/tools/set-spend-limit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;SAC9B,QAAQ,EAAE;SACV,QAAQ,CACP,qIAAqI,CACtI;IACH,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;SACvC,QAAQ,EAAE;SACV,QAAQ,CACP,mPAAmP,CACpP;IACH,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,GAAG,CAAC,aAAa,CAAC;SAClB,QAAQ,EAAE;SACV,QAAQ,CACP,+JAA+J,CAChK;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;IAC1C,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE;QACX,kHAAkH;QAClH,sLAAsL;QACtL,gQAAgQ;QAChQ,0JAA0J;QAC1J,iIAAiI;KAClI,CAAC,IAAI,CAAC,GAAG,CAAC;IACX,WAAW;IACX,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC;CACtD,CAAC,CAAC"}

package/dist/tools/transaction-history.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `leash_transaction_history` — list every receipt the active agent
+ * has earned or spent within a configurable rolling window.
+ *
+ * This complements `leash_receipts` (which is paginated + open-ended)
+ * by treating the question as "what happened in the last N days?".
+ * The host paginates the underlying `/v1/receipts/{agent}` feed,
+ * trims to the window client-side (newest-first → break on the first
+ * row older than `now - days`), and returns:
+ *
+ *   - The receipts themselves (canonical fields the LLM can quote
+ *     verbatim: hash, direction, decision, amount, currency, tx_sig,
+ *     timestamp, request URL).
+ *   - Running totals for the window: `total_sent_usd`,
+ *     `total_received_usd`, `net_usd`, plus per-direction counts.
+ *
+ * All Leash-supported stables (USDC/USDG/USDT) are summed as USD 1:1
+ * \u2014 every receipt amount is already a decimal in the token's display
+ * units. Receipts in non-stable currencies (rare, future) get counted
+ * but excluded from the USD totals.
+ */
+export declare const transactionHistoryTool: import("../tool.js").LeashTool;
+//# sourceMappingURL=transaction-history.d.ts.map

package/dist/tools/transaction-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-history.d.ts","sourceRoot":"","sources":["../../src/tools/transaction-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAiCH,eAAO,MAAM,sBAAsB,gCAUjC,CAAC"}

package/dist/tools/transaction-history.js

@@ -0,0 +1,55 @@
+/**
+ * `leash_transaction_history` — list every receipt the active agent
+ * has earned or spent within a configurable rolling window.
+ *
+ * This complements `leash_receipts` (which is paginated + open-ended)
+ * by treating the question as "what happened in the last N days?".
+ * The host paginates the underlying `/v1/receipts/{agent}` feed,
+ * trims to the window client-side (newest-first → break on the first
+ * row older than `now - days`), and returns:
+ *
+ *   - The receipts themselves (canonical fields the LLM can quote
+ *     verbatim: hash, direction, decision, amount, currency, tx_sig,
+ *     timestamp, request URL).
+ *   - Running totals for the window: `total_sent_usd`,
+ *     `total_received_usd`, `net_usd`, plus per-direction counts.
+ *
+ * All Leash-supported stables (USDC/USDG/USDT) are summed as USD 1:1
+ * \u2014 every receipt amount is already a decimal in the token's display
+ * units. Receipts in non-stable currencies (rare, future) get counted
+ * but excluded from the USD totals.
+ */
+import { z } from 'zod';
+import { defineTool } from '../tool.js';
+const inputSchema = z.object({
+    days: z
+        .number()
+        .int()
+        .min(1)
+        .max(90)
+        .optional()
+        .describe('Window size in days, anchored to "now". Defaults to 7 (a one-week rolling view). Capped at 90 server-side to keep responses bounded; for longer ranges paginate `leash_receipts` directly.'),
+    direction: z
+        .enum(['both', 'outgoing', 'incoming'])
+        .optional()
+        .describe('Filter the feed: `outgoing` = the agent paid (spend receipts), `incoming` = the agent was paid (earn receipts). Defaults to `both`.'),
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .max(1000)
+        .optional()
+        .describe('Hard cap on the total receipts returned across pagination. Defaults to 200; the underlying feed page size stays at 200 so this only matters when the day window contains more.'),
+});
+export const transactionHistoryTool = defineTool({
+    name: 'leash_transaction_history',
+    description: [
+        "List the active agent's earn + spend receipts within a rolling day-window (last 7 days by default).",
+        'Returns the receipts (newest-first) plus aggregate totals: total_sent_usd, total_received_usd, net_usd, and per-direction counts. Stables (USDC/USDG/USDT) are summed as USD 1:1.',
+        'Use this when the user asks "what did my agent do this week?", "show me last 30 days of payments", or wants a quick P&L summary. For "today only" pass `days: 1`. For deep paging (>90d) fall back to `leash_receipts`.',
+        'On `status: "ok"`, the `range` block names the window (`from`, `to`, `days`) and `count` is the number of receipts returned.',
+    ].join(' '),
+    inputSchema,
+    handler: async (args, ctx) => ctx.transactionHistory(args),
+});
+//# sourceMappingURL=transaction-history.js.map

package/dist/tools/transaction-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-history.js","sourceRoot":"","sources":["../../src/tools/transaction-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CACP,4LAA4L,CAC7L;IACH,SAAS,EAAE,CAAC;SACT,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;SACtC,QAAQ,EAAE;SACV,QAAQ,CACP,qIAAqI,CACtI;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,gLAAgL,CACjL;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAU,CAAC;IAC/C,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE;QACX,qGAAqG;QACrG,mLAAmL;QACnL,yNAAyN;QACzN,8HAA8H;KAC/H,CAAC,IAAI,CAAC,GAAG,CAAC;IACX,WAAW;IACX,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC;CAC3D,CAAC,CAAC"}

package/dist/tools/withdraw-treasury.d.ts

@@ -0,0 +1,2 @@
+export declare const withdrawTreasuryTool: import("../tool.js").LeashTool;
+//# sourceMappingURL=withdraw-treasury.d.ts.map

package/dist/tools/withdraw-treasury.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdraw-treasury.d.ts","sourceRoot":"","sources":["../../src/tools/withdraw-treasury.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,oBAAoB,gCAW/B,CAAC"}

package/dist/tools/withdraw-treasury.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { defineTool } from '../tool.js';
+const inputSchema = z.object({
+    token: z
+        .enum(['SOL', 'USDC', 'USDG', 'USDT'])
+        .describe('Token to withdraw. SOL for native lamports; otherwise an SPL stable.'),
+    amount: z
+        .number()
+        .positive()
+        .describe('Amount in whole units (e.g. 100 for 100 USDC, 0.5 for 0.5 SOL). Positive only.'),
+    destination: z
+        .string()
+        .min(32)
+        .max(44)
+        .describe("Recipient Solana wallet address (base58). Must NOT be the treasury itself; it's the destination wallet, not its ATA."),
+});
+export const withdrawTreasuryTool = defineTool({
+    name: 'leash_withdraw_treasury',
+    description: [
+        'Withdraw SOL or an SPL stable (USDC/USDG/USDT) from the agent treasury to any Solana wallet.',
+        'Behaviour depends on the host runtime:',
+        '  - In the chat product the call DOES NOT settle on its own — only the asset owner (the user’s Privy wallet) can sign the on-chain `mpl-core::Execute`. It returns a `withdraw_request` artifact the chat UI renders as a Withdraw card; reply with one short sentence asking the user to approve.',
+        '  - In the standalone MCP / CLI runtime the call SIGNS and SETTLES the withdrawal using the local executive keypair and returns a `withdraw_receipt` blob with the tx signature.',
+        'On `status: "error"`, surface the `message` verbatim. Never claim a withdrawal completed and never invent a tx hash.',
+    ].join(' '),
+    inputSchema,
+    handler: async (args, ctx) => ctx.withdraw(args),
+});
+//# sourceMappingURL=withdraw-treasury.js.map

package/dist/tools/withdraw-treasury.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdraw-treasury.js","sourceRoot":"","sources":["../../src/tools/withdraw-treasury.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,KAAK,EAAE,CAAC;SACL,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;SACrC,QAAQ,CAAC,sEAAsE,CAAC;IACnF,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gFAAgF,CAAC;IAC7F,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,CAAC;SACP,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CACP,sHAAsH,CACvH;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;IAC7C,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE;QACX,8FAA8F;QAC9F,wCAAwC;QACxC,oSAAoS;QACpS,kLAAkL;QAClL,sHAAsH;KACvH,CAAC,IAAI,CAAC,GAAG,CAAC;IACX,WAAW;IACX,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;CACjD,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "publishConfig": {
+    "access": "public"
+  },
+  "name": "@leashmarket/mcp-core",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./helpers": {
+      "types": "./dist/helpers/index.d.ts",
+      "import": "./dist/helpers/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "lint": "echo lint:mcp-core",
+    "test": "vitest run"
+  }
+}