@leashmarket/mcp-core 0.1.0

package/dist/host.d.ts

@@ -0,0 +1,326 @@
+/**
+ * `LeashHost` is the runtime contract every Leash MCP host (chat
+ * product, standalone STDIO MCP, CLI, etc.) implements. The shared
+ * tool definitions in `./tools` delegate to this interface, so the
+ * same tool name + schema works across surfaces with completely
+ * different settlement semantics:
+ *
+ * - Chat product: `pay()` returns a `payment_request` artifact (the
+ *   UI renders a "Pay" card; the user signs in their browser via
+ *   Privy). Treasury reads happen server-side over the cluster RPC.
+ *
+ * - Standalone MCP / CLI: `pay()` actually settles the payment by
+ *   signing the buyer-kit transfer with the local executive
+ *   keypair and returns the receipt. No human in the loop.
+ *
+ * Adding a new tool is one file in `./tools` plus one method on each
+ * implementer of this interface.
+ */
+import type { LeashToolResult } from './tool.js';
+/** SVM cluster slugs as used by the Leash API + Metaplex SDK. */
+export type SvmNetwork = 'solana-devnet' | 'solana-mainnet';
+/** Stablecoins the Leash treasury supports across networks. */
+export type StableSymbol = 'USDC' | 'USDG' | 'USDT';
+/** Tokens supported by the withdraw tool — adds SOL on top of stables. */
+export type WithdrawableToken = 'SOL' | StableSymbol;
+export type CreatePaymentLinkArgs = {
+    amount: number;
+    currency: StableSymbol;
+    label: string;
+    description?: string;
+};
+export type PayArgs = {
+    url: string;
+};
+export type WithdrawArgs = {
+    token: WithdrawableToken;
+    amount: number;
+    destination: string;
+};
+export type CheckTreasuryBalanceArgs = {
+    symbol?: string;
+};
+export type RegisterAgentArgs = {
+    /**
+     * Friendly agent name recorded in MPL Core metadata. Optional —
+     * defaults to `Agent <executive_pubkey[0..8]>` when omitted.
+     */
+    name?: string;
+    /**
+     * Free-text description recorded in the MPL Core asset and the
+     * EIP-8004 RegistrationV1 metadata doc.
+     */
+    description?: string;
+    /**
+     * Optional public image URL written into the RegistrationV1
+     * metadata's `image` field (e.g. an avatar / logo).
+     */
+    image_url?: string;
+    /**
+     * EIP-8004 RegistrationV1 `services[]` entries the agent
+     * advertises. Threaded into three places at mint time:
+     *   1. On-chain MPL Core `agentMetadata.services[]`.
+     *   2. Off-chain RegistrationV1 doc embedded in the asset `uri`.
+     *   3. Platform `services` column written by `/v1/agents/record`.
+     * The Leash protocol always auto-injects a `receipts` entry, so
+     * callers don't need to supply one. Each entry must be `{ name,
+     * endpoint }` where `endpoint` is a valid URL.
+     *
+     * Persisted alongside the executive in `pending_register` so the
+     * SECOND `leash_register_agent` call (after the user funds the
+     * pubkey) doesn't need to re-collect them.
+     */
+    services?: {
+        name: string;
+        endpoint: string;
+    }[];
+    /**
+     * Owner-keypair source.
+     *   - `'generate'` (default) — host generates a fresh ed25519 keypair
+     *     locally, persists it to `~/.config/leash/agent.json` under
+     *     `pending_register`, and asks the user to fund it.
+     *   - `'import'` — caller supplies an existing keypair via
+     *     `executive_secret_base58`. Same persistence + funding-check
+     *     path; the caller stays in control of the signing key.
+     *
+     * The mode is only consulted on the FIRST call. Subsequent calls
+     * (after the user funds the executive) ignore `mode` and resume
+     * from `pending_register`.
+     */
+    mode?: 'generate' | 'import';
+    /**
+     * Required when `mode === 'import'`. The executive's 64-byte
+     * ed25519 secret key, base58-encoded. The host validates the
+     * length + curve before persisting and never echoes the secret
+     * back in any tool response.
+     */
+    executive_secret_base58?: string;
+};
+export type GetIdentityArgs = Record<string, never>;
+export type ReceiptsArgs = {
+    /** Filter by direction. `'both'` returns spend + earn receipts. */
+    direction?: 'both' | 'outgoing' | 'incoming';
+    /** Max items to return. Capped server-side. */
+    limit?: number;
+};
+export type DiscoverArgs = {
+    /** Free-text capability label (e.g. "ocr", "weather"). */
+    capability?: string;
+    /** Maximum decimal USDC price per call. */
+    max_price_usdc?: number;
+    /** Pricing-type filter. */
+    pricing_type?: 'free' | 'per_call' | 'variable';
+    /**
+     * Restrict to a single catalogue:
+     *   - `'leash'`: agents listed on the Leash marketplace.
+     *   - `'pay-skills'`: providers in the Solana Foundation
+     *     `pay-skills` registry.
+     *   - `'all'` (default): merged.
+     */
+    source?: 'leash' | 'pay-skills' | 'all';
+    /** Max items to return. Server-capped. */
+    limit?: number;
+};
+export type ReputationArgs = {
+    agent_mint: string;
+    network?: SvmNetwork;
+};
+/**
+ * Inputs for `leash_pay_skills_endpoints` — expand a chosen
+ * `pay-skills` provider (returned by `leash_discover`) into its
+ * paid endpoint list. Mirrors `pay skills endpoints <fqn>` from the
+ * pay.sh CLI.
+ */
+export type PaySkillsProviderArgs = {
+    /**
+     * Fully-qualified provider name as published in the catalogue.
+     * Two- or three-segment paths, e.g. `agentmail/email` or
+     * `coinbase-cdp/coinbase-developer-platform/baseSepoliaWalletApi`.
+     * Lift this verbatim from a `leash_discover` item that has
+     * `source === 'pay-skills'` (the FQN lives in `slug`).
+     */
+    fqn: string;
+};
+/**
+ * Inputs for `leash_set_spend_limit`. Lets the owner change the cap
+ * the agent treasury PDA delegates to the executive keypair for an
+ * SPL stable. `unlimited` writes `u64::MAX`; `revoke` zeros the
+ * delegation; an explicit decimal amount sets that cap (in
+ * human-readable units of the token).
+ */
+export type SetSpendLimitArgs = {
+    /** SPL stable to update the delegation for. Defaults to USDC. */
+    symbol?: StableSymbol;
+    /**
+     * What to write.
+     *   - `'unlimited'` (default) — `u64::MAX`, the protocol default.
+     *   - `'revoke'` — drop the delegation; the executive can no
+     *     longer move funds from the treasury until re-approved.
+     *   - `'amount'` — set a custom cap from `amount`.
+     */
+    mode?: 'unlimited' | 'revoke' | 'amount';
+    /**
+     * Required when `mode === 'amount'`. Decimal amount in
+     * human-readable units of the token (e.g. `100` = $100 USDC).
+     * Server applies the mint's `decimals` before broadcasting.
+     */
+    amount?: number;
+};
+/**
+ * Inputs for `leash_get_spend_limit`. No knobs beyond the symbol —
+ * the host already knows the agent + network from session state.
+ */
+export type GetSpendLimitArgs = {
+    /** SPL stable to inspect. Defaults to USDC. */
+    symbol?: StableSymbol;
+};
+/**
+ * Inputs for `leash_get_receipt`. Looks up one ReceiptV1 by its
+ * deterministic `receipt_hash` (the same hash the explorer URL
+ * carries: `/receipt/{hash}`). Network is host-bound so a hash from
+ * the sibling cluster returns `not_found`.
+ */
+export type GetReceiptArgs = {
+    /** 64-hex-char receipt_hash from the seller-side ReceiptV1. */
+    receipt_hash: string;
+};
+/**
+ * Inputs for `leash_transaction_history`. Lists every receipt for the
+ * active agent within the last `days` days, both directions by
+ * default. The host paginates the underlying `/v1/receipts/{agent}`
+ * feed and trims to the day window client-side.
+ */
+export type TransactionHistoryArgs = {
+    /** Window size in days (1 ≤ N ≤ 90). Defaults to 7. */
+    days?: number;
+    /** Filter by direction. Defaults to `both`. */
+    direction?: 'both' | 'outgoing' | 'incoming';
+    /** Hard cap on the total receipts returned (default 200, max 1000). */
+    limit?: number;
+};
+/**
+ * Inputs for `leash_daily_transactions`. Same window as
+ * `transaction_history` but the host bins receipts by UTC ingest
+ * date and returns per-day aggregates (count + USD-equivalent sums)
+ * plus grand totals. Stables (USDC/USDG/USDT) are summed as USD 1:1.
+ */
+export type DailyTransactionsArgs = {
+    /** Window size in days (1 ≤ N ≤ 90). Defaults to 7. */
+    days?: number;
+};
+export interface LeashHost {
+    /** The agent's MPL Core asset address. `null` while the user is in onboarding. */
+    agentMint: string | null;
+    /** Pubkey of the wallet that owns the agent (Privy embedded wallet OR local executive). */
+    ownerWallet: string | null;
+    /** Cluster the agent is registered on. */
+    network: SvmNetwork;
+    /** RPC URL the host's tools should use for direct chain reads. */
+    rpcUrl: string;
+    /** Base URL of the Leash API (`https://api.leash.market` in prod). */
+    apiBaseUrl: string;
+    /**
+     * Mint a real x402 payment link. Implementations decide how the call
+     * authenticates with the Leash API (chat product reveals a stored
+     * platform API key; standalone MCP signs an X-Leash-Sig header).
+     */
+    createPaymentLink(args: CreatePaymentLinkArgs): Promise<LeashToolResult>;
+    /**
+     * Pay an x402 link.
+     *   - chat product impl: probes the URL, returns a `payment_request`
+     *     artifact for the UI to settle.
+     *   - standalone MCP impl: probes, signs, settles, and returns the
+     *     `payment_receipt` blob with the on-chain signature.
+     */
+    pay(args: PayArgs): Promise<LeashToolResult>;
+    /**
+     * Withdraw SOL or an SPL stable from the agent treasury.
+     *   - chat product impl: validates + returns a `withdraw_request`
+     *     artifact for the UI.
+     *   - standalone MCP impl: actually constructs and signs the
+     *     `mpl-core::Execute` instruction with the local owner key.
+     */
+    withdraw(args: WithdrawArgs): Promise<LeashToolResult>;
+    /**
+     * Read the agent treasury balance. Both surfaces return the same
+     * shape (network/RPC reads are host-agnostic).
+     */
+    checkTreasuryBalance(args: CheckTreasuryBalanceArgs): Promise<LeashToolResult>;
+    /**
+     * Provision a new on-chain agent for the caller.
+     *   - standalone MCP impl: hits `POST /v1/sandbox/agent` (devnet),
+     *     writes `~/.config/leash/agent.json` with the returned secret,
+     *     returns the funding details.
+     *   - chat product impl: returns a `kind: 'register_agent', status:
+     *     'manual'` blob telling the model to direct the user to
+     *     "Profile → Agent" (the chat UI handles minting today).
+     */
+    registerAgent(args: RegisterAgentArgs): Promise<LeashToolResult>;
+    /**
+     * Self-introspection — what agent am I, what's my network, who's
+     * the executive. Both impls read from local context and never hit
+     * the network. Cheap by design so the LLM can call it freely.
+     */
+    getIdentity(args: GetIdentityArgs): Promise<LeashToolResult>;
+    /**
+     * List recent receipts for the active agent. Both impls call the
+     * Leash API; the standalone host uses the legacy API-key bearer
+     * until X-Leash-Sig auth lands in batch 6.
+     */
+    receipts(args: ReceiptsArgs): Promise<LeashToolResult>;
+    /**
+     * Search the Leash marketplace for paid services by capability +
+     * price. Public — both hosts hit `GET /v1/discover` directly.
+     */
+    discover(args: DiscoverArgs): Promise<LeashToolResult>;
+    /**
+     * Pull the live reputation snapshot for any on-chain agent. Public
+     * — both hosts hit `GET /v1/agents/:mint/reputation` directly.
+     */
+    reputation(args: ReputationArgs): Promise<LeashToolResult>;
+    /**
+     * Expand a `pay-skills` discover item into its paid endpoints.
+     * Public — hits `GET /v1/discover/pay-skills/:fqn` directly. The
+     * returned `endpoint_urls[]` are absolute URLs the agent can pay
+     * via `pay()` without any extra plumbing.
+     */
+    paySkillsProvider(args: PaySkillsProviderArgs): Promise<LeashToolResult>;
+    /**
+     * Owner-driven update of the SPL `Approve` delegation that lets
+     * the executive spend stables out of the agent treasury PDA.
+     * Standalone MCP / CLI signs the `mpl-core::Execute(SPL.Approve|Revoke)`
+     * tx with the local owner key; chat product returns a
+     * `kind: 'spend_limit', status: 'manual'` artifact pointing the
+     * user at the Profile → Agent UI.
+     */
+    setSpendLimit(args: SetSpendLimitArgs): Promise<LeashToolResult>;
+    /**
+     * Read the current delegation + treasury balance for an SPL stable.
+     * Cheap — host-agnostic RPC read. Returns delegate pubkey,
+     * delegated atomic amount + decimal-formatted version, and current
+     * balance.
+     */
+    getSpendLimit(args: GetSpendLimitArgs): Promise<LeashToolResult>;
+    /**
+     * Look up a single receipt by its `receipt_hash`. Returns the full
+     * ReceiptV1 (the same JSON the explorer renders at
+     * `/receipt/{hash}`) plus a few convenience fields the LLM can
+     * inline into a reply (explorer URL, direction, ingested_at).
+     */
+    getReceipt(args: GetReceiptArgs): Promise<LeashToolResult>;
+    /**
+     * List every receipt for the active agent within the last `days`
+     * days, both directions by default. The host paginates the
+     * underlying `/v1/receipts/{agent}` feed and trims to the window
+     * client-side. Returns the receipts plus running USD totals.
+     */
+    transactionHistory(args: TransactionHistoryArgs): Promise<LeashToolResult>;
+    /**
+     * Bin the same receipts as `transactionHistory` by UTC ingest date
+     * and return per-day aggregates (count + USD-equivalent sums for
+     * each direction) plus grand totals. Useful for "show me last
+     * week's revenue" style prompts.
+     */
+    dailyTransactions(args: DailyTransactionsArgs): Promise<LeashToolResult>;
+}
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"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"}

package/dist/host.js

@@ -0,0 +1,20 @@
+/**
+ * `LeashHost` is the runtime contract every Leash MCP host (chat
+ * product, standalone STDIO MCP, CLI, etc.) implements. The shared
+ * tool definitions in `./tools` delegate to this interface, so the
+ * same tool name + schema works across surfaces with completely
+ * different settlement semantics:
+ *
+ * - Chat product: `pay()` returns a `payment_request` artifact (the
+ *   UI renders a "Pay" card; the user signs in their browser via
+ *   Privy). Treasury reads happen server-side over the cluster RPC.
+ *
+ * - Standalone MCP / CLI: `pay()` actually settles the payment by
+ *   signing the buyer-kit transfer with the local executive
+ *   keypair and returns the receipt. No human in the loop.
+ *
+ * Adding a new tool is one file in `./tools` plus one method on each
+ * implementer of this interface.
+ */
+export {};
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `@leashmarket/mcp-core` — host-agnostic core for every Leash MCP surface.
+ *
+ * What lives here
+ * ---------------
+ *   - `LeashHost`     : runtime contract every host implements
+ *   - `LeashTool`     : tool-definition primitive (name, schema, handler)
+ *   - `LEASH_TOOLS`   : the canonical tool list adapters iterate
+ *   - `helpers/*`     : pure utilities (probe, address-shape, token catalog)
+ *
+ * What does NOT live here
+ * -----------------------
+ * Anything that takes a hard dep on a specific runtime (Claude Agent
+ * SDK, `@modelcontextprotocol/sdk`, Node-only modules, browser-only
+ * modules). Adapters glue this package to those runtimes.
+ */
+export type { LeashHost, SvmNetwork, StableSymbol, WithdrawableToken, CreatePaymentLinkArgs, PayArgs, WithdrawArgs, CheckTreasuryBalanceArgs, RegisterAgentArgs, GetIdentityArgs, ReceiptsArgs, DiscoverArgs, PaySkillsProviderArgs, ReputationArgs, SetSpendLimitArgs, GetSpendLimitArgs, GetReceiptArgs, TransactionHistoryArgs, DailyTransactionsArgs, } from './host.js';
+export { defineTool, jsonResult, noAgentResult, type LeashTool, type LeashToolResult, } from './tool.js';
+export { LEASH_TOOLS, checkBalancesTool, createPaymentLinkTool, dailyTransactionsTool, discoverTool, getIdentityTool, getReceiptTool, getSpendLimitTool, payPaymentLinkTool, paySkillsEndpointsTool, receiptsTool, registerAgentTool, reputationTool, setSpendLimitTool, transactionHistoryTool, withdrawTreasuryTool, } from './tools/index.js';
+export { isLikelyBase58Address, lookupTokenBySymbolSafe, symbolForMintSafe, decodeBase64Json, probePaymentLink, fetchDiscover, fetchPaySkillsProvider, fetchReputation, type TokenMeta, type TokenProgramId, type PaymentRequirementPreview, type DiscoverItem, type DiscoverSource, type PaySkillsEndpoint, type PaySkillsProvider, type ReputationSnapshot, } from './helpers/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,YAAY,EACV,SAAS,EACT,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,OAAO,EACP,YAAY,EACZ,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * `@leashmarket/mcp-core` — host-agnostic core for every Leash MCP surface.
+ *
+ * What lives here
+ * ---------------
+ *   - `LeashHost`     : runtime contract every host implements
+ *   - `LeashTool`     : tool-definition primitive (name, schema, handler)
+ *   - `LEASH_TOOLS`   : the canonical tool list adapters iterate
+ *   - `helpers/*`     : pure utilities (probe, address-shape, token catalog)
+ *
+ * What does NOT live here
+ * -----------------------
+ * Anything that takes a hard dep on a specific runtime (Claude Agent
+ * SDK, `@modelcontextprotocol/sdk`, Node-only modules, browser-only
+ * modules). Adapters glue this package to those runtimes.
+ */
+export { defineTool, jsonResult, noAgentResult, } from './tool.js';
+export { LEASH_TOOLS, checkBalancesTool, createPaymentLinkTool, dailyTransactionsTool, discoverTool, getIdentityTool, getReceiptTool, getSpendLimitTool, payPaymentLinkTool, paySkillsEndpointsTool, receiptsTool, registerAgentTool, reputationTool, setSpendLimitTool, transactionHistoryTool, withdrawTreasuryTool, } from './tools/index.js';
+export { isLikelyBase58Address, lookupTokenBySymbolSafe, symbolForMintSafe, decodeBase64Json, probePaymentLink, fetchDiscover, fetchPaySkillsProvider, fetchReputation, } from './helpers/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAwBH,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,GAGd,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,eAAe,GAShB,MAAM,oBAAoB,CAAC"}

package/dist/tool.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Tool-definition primitive shared by every Leash MCP surface. A
+ * `LeashTool` is host-agnostic data — name, description, Zod input
+ * schema, and a handler that dispatches to the host's typed methods.
+ *
+ * Each runtime adapter (Claude Agent SDK in `apps/agents`, MCP SDK in
+ * `packages/mcp`, CLI in `packages/cli`) wraps these definitions in
+ * its own tool-registration call.
+ */
+import type { z } from 'zod';
+import type { LeashHost } from './host.js';
+/**
+ * Result shape both Anthropic's Claude Agent SDK and `@modelcontextprotocol/sdk`
+ * accept verbatim — a list of typed content parts. We only emit text
+ * parts; the JSON payload is stringified into the single text content
+ * (downstream models parse it as JSON).
+ */
+export type LeashToolResult = {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+};
+/**
+ * A tool definition is intentionally non-generic on its `inputSchema`
+ * so the canonical `LEASH_TOOLS` array can hold tools that have
+ * different schemas without TypeScript variance complaints. Use the
+ * `defineTool` helper below to author tools with type-safe arguments.
+ */
+export interface LeashTool {
+    /** Tool name as exposed to the LLM (`leash_*` prefix is convention). */
+    name: string;
+    /** Description the LLM sees when deciding whether to call this tool. */
+    description: string;
+    /** Zod schema for the structured input arguments. */
+    inputSchema: z.ZodTypeAny;
+    /** Async handler. Returns whatever JSON shape makes sense for the host. */
+    handler: (args: unknown, ctx: LeashHost) => Promise<LeashToolResult>;
+}
+/**
+ * Authoring helper that preserves type-safe `args` inside the handler
+ * while erasing the schema generic on the returned `LeashTool` so it
+ * fits in the canonical array.
+ */
+export declare function defineTool<TSchema extends z.ZodTypeAny>(def: {
+    name: string;
+    description: string;
+    inputSchema: TSchema;
+    handler: (args: z.infer<TSchema>, ctx: LeashHost) => Promise<LeashToolResult>;
+}): LeashTool;
+/**
+ * Wrap an arbitrary JSON-serializable payload into the
+ * `{ content: [{ type: 'text', text: <stringified> }] }` shape both
+ * SDKs expect. Used by every tool's handler so the on-the-wire format
+ * stays consistent.
+ */
+export declare function jsonResult(payload: unknown): LeashToolResult;
+/**
+ * Helper for the `agentMint == null` branch most tools share — surfaces
+ * a `no_agent` JSON blob the LLM is trained to format as "ask the user
+ * to mint an agent first".
+ */
+export declare function noAgentResult(kind: string, message?: string): LeashToolResult;
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC;IAC1B,2EAA2E;IAC3E,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;CACtE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,EAAE,GAAG,EAAE;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,SAAS,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;CAC/E,GAAG,SAAS,CAEZ;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,CAQ7E"}

package/dist/tool.js

@@ -0,0 +1,40 @@
+/**
+ * Tool-definition primitive shared by every Leash MCP surface. A
+ * `LeashTool` is host-agnostic data — name, description, Zod input
+ * schema, and a handler that dispatches to the host's typed methods.
+ *
+ * Each runtime adapter (Claude Agent SDK in `apps/agents`, MCP SDK in
+ * `packages/mcp`, CLI in `packages/cli`) wraps these definitions in
+ * its own tool-registration call.
+ */
+/**
+ * Authoring helper that preserves type-safe `args` inside the handler
+ * while erasing the schema generic on the returned `LeashTool` so it
+ * fits in the canonical array.
+ */
+export function defineTool(def) {
+    return def;
+}
+/**
+ * Wrap an arbitrary JSON-serializable payload into the
+ * `{ content: [{ type: 'text', text: <stringified> }] }` shape both
+ * SDKs expect. Used by every tool's handler so the on-the-wire format
+ * stays consistent.
+ */
+export function jsonResult(payload) {
+    return { content: [{ type: 'text', text: JSON.stringify(payload) }] };
+}
+/**
+ * Helper for the `agentMint == null` branch most tools share — surfaces
+ * a `no_agent` JSON blob the LLM is trained to format as "ask the user
+ * to mint an agent first".
+ */
+export function noAgentResult(kind, message) {
+    return jsonResult({
+        kind,
+        status: 'no_agent',
+        message: message ??
+            'No on-chain agent yet. Mint one with the leash_register_agent tool (or under Profile → Agent in the chat UI) before calling this tool.',
+    });
+}
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiCH;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAA+B,GAKxD;IACC,OAAO,GAA2B,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;AACxE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,OAAgB;IAC1D,OAAO,UAAU,CAAC;QAChB,IAAI;QACJ,MAAM,EAAE,UAAU;QAClB,OAAO,EACL,OAAO;YACP,wIAAwI;KAC3I,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/check-balances.d.ts

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

package/dist/tools/check-balances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-balances.d.ts","sourceRoot":"","sources":["../../src/tools/check-balances.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,iBAAiB,gCAM5B,CAAC"}

package/dist/tools/check-balances.js

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { defineTool } from '../tool.js';
+const inputSchema = z.object({
+    symbol: z
+        .string()
+        .optional()
+        .describe('Optional ticker filter — e.g. "USDC". When omitted, returns all balances.'),
+});
+export const checkBalancesTool = defineTool({
+    name: 'leash_check_treasury_balance',
+    description: 'Read the agent treasury balance — SOL plus every SPL token held (USDC, USDG, USDT pinned even when zero).',
+    inputSchema,
+    handler: async (args, ctx) => ctx.checkTreasuryBalance(args),
+});
+//# sourceMappingURL=check-balances.js.map

package/dist/tools/check-balances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-balances.js","sourceRoot":"","sources":["../../src/tools/check-balances.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,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2EAA2E,CAAC;CACzF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;IAC1C,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,2GAA2G;IAC7G,WAAW;IACX,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,CAAC;CAC7D,CAAC,CAAC"}

package/dist/tools/create-payment-link.d.ts

@@ -0,0 +1,2 @@
+export declare const createPaymentLinkTool: import("../tool.js").LeashTool;
+//# sourceMappingURL=create-payment-link.d.ts.map

package/dist/tools/create-payment-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-payment-link.d.ts","sourceRoot":"","sources":["../../src/tools/create-payment-link.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,qBAAqB,gCAQhC,CAAC"}

package/dist/tools/create-payment-link.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { defineTool } from '../tool.js';
+const inputSchema = z.object({
+    amount: z
+        .number()
+        .positive()
+        .describe('Amount the buyer must pay. Use whole units (e.g. 20 for 20 USDC).'),
+    currency: z
+        .enum(['USDC', 'USDG', 'USDT'])
+        .default('USDC')
+        .describe('Stablecoin to charge in. Defaults to USDC.'),
+    label: z
+        .string()
+        .min(1)
+        .max(120)
+        .describe('Human-readable label for the link (e.g. "Coffee — large").'),
+    description: z.string().max(500).optional(),
+});
+export const createPaymentLinkTool = defineTool({
+    name: 'leash_create_payment_link',
+    description: [
+        'Create an x402 payment link the user (or another agent) can call to pay this agent in USDC/USDG/USDT.',
+        'Requires an on-chain agent (treasury). Returns the public share URL on success — quote it back as a markdown link.',
+    ].join(' '),
+    inputSchema,
+    handler: async (args, ctx) => ctx.createPaymentLink(args),
+});
+//# sourceMappingURL=create-payment-link.js.map

package/dist/tools/create-payment-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-payment-link.js","sourceRoot":"","sources":["../../src/tools/create-payment-link.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,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mEAAmE,CAAC;IAChF,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;SAC9B,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,4CAA4C,CAAC;IACzD,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,4DAA4D,CAAC;IACzE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAC;IAC9C,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE;QACX,uGAAuG;QACvG,oHAAoH;KACrH,CAAC,IAAI,CAAC,GAAG,CAAC;IACX,WAAW;IACX,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC;CAC1D,CAAC,CAAC"}

package/dist/tools/daily-transactions.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `leash_daily_transactions` — bin the active agent's earn + spend
+ * receipts by UTC day for a rolling window and return per-day
+ * aggregates plus grand totals.
+ *
+ * Operates on the same underlying `/v1/receipts/{agent}` feed as
+ * `leash_transaction_history`, but folds individual receipts into
+ * per-date buckets. Each bucket reports:
+ *
+ *   - `date`              `YYYY-MM-DD` (UTC of `ingested_at`).
+ *   - `sent_count`        # of outgoing (spend) receipts that day.
+ *   - `sent_usd`          USD-equivalent total sent that day.
+ *   - `received_count`    # of incoming (earn) receipts that day.
+ *   - `received_usd`      USD-equivalent total received that day.
+ *   - `net_usd`           `received_usd - sent_usd`.
+ *
+ * Days with zero activity are still emitted (filled with zeros) so
+ * the LLM can render a continuous row without holes. Days are sorted
+ * newest-first to match the rest of the receipt surface.
+ *
+ * Stables (USDC/USDG/USDT) are summed as USD 1:1; receipts in other
+ * currencies are counted but excluded from the USD totals (with a
+ * `non_usd_count` callout in the response).
+ */
+export declare const dailyTransactionsTool: import("../tool.js").LeashTool;
+//# sourceMappingURL=daily-transactions.d.ts.map

package/dist/tools/daily-transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daily-transactions.d.ts","sourceRoot":"","sources":["../../src/tools/daily-transactions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAkBH,eAAO,MAAM,qBAAqB,gCAUhC,CAAC"}