@0xwh1sker/mantle-core 0.1.3

package/dist/config/protocols.d.ts

@@ -0,0 +1,20 @@
+import type { Network } from "../types.js";
+interface ProtocolEntry {
+    name: string;
+    type: string;
+    status: "enabled" | "planned";
+    contracts: Record<string, string>;
+    source_url?: string;
+}
+export declare const MANTLE_PROTOCOLS: Record<Network, Record<string, ProtocolEntry>>;
+/**
+ * Check whether an address is on the competition whitelist.
+ * Used by `mantle_buildApprove` to validate spender targets.
+ */
+export declare function isWhitelistedContract(address: string, network: Network): boolean;
+/**
+ * Return the human-readable label for a whitelisted contract, or null.
+ */
+export declare function whitelistLabel(address: string, network: Network): string | null;
+export {};
+//# sourceMappingURL=protocols.d.ts.map

package/dist/config/protocols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocols.d.ts","sourceRoot":"","sources":["../../src/config/protocols.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CA6D3E,CAAC;AA0BF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,GACf,OAAO,CAGT;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,GACf,MAAM,GAAG,IAAI,CAef"}

package/dist/config/protocols.js

@@ -0,0 +1,112 @@
+export const MANTLE_PROTOCOLS = {
+    mainnet: {
+        agni: {
+            name: "Agni Finance",
+            type: "dex",
+            status: "enabled",
+            source_url: "https://agni.finance",
+            contracts: {
+                swap_router: "0x319B69888b0d11cEC22caA5034e25FfFBDc88421",
+                position_manager: "0x218bf598D1453383e2F4AA7b14fFB9BfB102D637",
+                factory: "0x25780dc8Fc3cfBD75F33bFDAB65e969b603b2035",
+                quoter_v2: "0xc4aaDc921E1cdb66c5300Bc158a313292923C0cb"
+            }
+        },
+        fluxion: {
+            name: "Fluxion",
+            type: "dex",
+            status: "enabled",
+            source_url: "https://app.fluxion.network",
+            contracts: {
+                swap_router: "0x5628a59df0ecac3f3171f877a94beb26ba6dfaa0",
+                position_manager: "0x2b70c4e7ca8e920435a5db191e066e9e3afd8db3",
+                factory: "0xF883162Ed9c7E8EF604214c964c678E40c9B737C"
+            }
+        },
+        merchant_moe: {
+            name: "Merchant Moe",
+            type: "dex",
+            status: "enabled",
+            source_url: "https://docs.merchantmoe.com/resources/contracts",
+            contracts: {
+                moe_router: "0xeaEE7EE68874218c3558b40063c42B82D3E7232a",
+                lb_router_v2_2: "0x013e138EF6008ae5FDFDE29700e3f2Bc61d21E3a",
+                lb_factory_v2_2: "0xa6630671775c4EA2743840F9A5016dCf2A104054",
+                lb_quoter_v2_2: "0x501b8AFd35df20f531fF45F6f695793AC3316c85"
+            }
+        },
+        aave_v3: {
+            name: "Aave V3",
+            type: "lending",
+            status: "enabled",
+            source_url: "https://github.com/bgd-labs/aave-address-book/blob/main/src/AaveV3Mantle.sol",
+            contracts: {
+                pool: "0x458F293454fE0d67EC0655f3672301301DD51422",
+                pool_data_provider: "0x487c5c669D9eee6057C44973207101276cf73b68",
+                pool_addresses_provider: "0xba50Cd2A20f6DA35D788639E581bca8d0B5d4D5f",
+                weth_gateway: "0x9C6cCAC66b1c9AbA4855e2dD284b9e16e41E06eA",
+                oracle: "0x47a063CfDa980532267970d478EC340C0F80E8df"
+            }
+        },
+        ondo: {
+            name: "Ondo Finance",
+            type: "rwa",
+            status: "planned",
+            contracts: {
+                router: "BLOCKER: fill from Ondo official docs and verify on Mantlescan",
+                vault_manager: "BLOCKER: fill from Ondo official docs and verify on Mantlescan"
+            }
+        }
+    },
+    sepolia: {}
+};
+// ---------------------------------------------------------------------------
+// Whitelist helpers — used by defi-write tools to validate targets
+// ---------------------------------------------------------------------------
+/** All whitelisted contract addresses on mainnet (lowercase for comparison). */
+const WHITELISTED_CONTRACTS_MAINNET = new Set([
+    // Merchant Moe
+    "0xeaEE7EE68874218c3558b40063c42B82D3E7232a", // MoeRouter
+    "0x013e138EF6008ae5FDFDE29700e3f2Bc61d21E3a", // LB Router V2.2
+    // Agni
+    "0x319B69888b0d11cEC22caA5034e25FfFBDc88421", // SwapRouter
+    "0x218bf598D1453383e2F4AA7b14fFB9BfB102D637", // PositionManager
+    // Fluxion
+    "0x5628a59df0ecac3f3171f877a94beb26ba6dfaa0", // SwapRouter
+    "0x2b70c4e7ca8e920435a5db191e066e9e3afd8db3", // PositionManager
+    // Aave V3
+    "0x458F293454fE0d67EC0655f3672301301DD51422", // Pool
+    "0x9C6cCAC66b1c9AbA4855e2dD284b9e16e41E06eA", // WETHGateway
+    // WMNT
+    "0x78c1b0C915c4FAA5FffA6CAbf0219DA63d7f4cb8"
+].map((a) => a.toLowerCase()));
+/**
+ * Check whether an address is on the competition whitelist.
+ * Used by `mantle_buildApprove` to validate spender targets.
+ */
+export function isWhitelistedContract(address, network) {
+    if (network !== "mainnet")
+        return false;
+    return WHITELISTED_CONTRACTS_MAINNET.has(address.toLowerCase());
+}
+/**
+ * Return the human-readable label for a whitelisted contract, or null.
+ */
+export function whitelistLabel(address, network) {
+    if (network !== "mainnet")
+        return null;
+    const lower = address.toLowerCase();
+    const labels = {
+        "0xeaee7ee68874218c3558b40063c42b82d3e7232a": "Merchant Moe MoeRouter",
+        "0x013e138ef6008ae5fdfde29700e3f2bc61d21e3a": "Merchant Moe LB Router V2.2",
+        "0x319b69888b0d11cec22caa5034e25fffbdc88421": "Agni SwapRouter",
+        "0x218bf598d1453383e2f4aa7b14ffb9bfb102d637": "Agni PositionManager",
+        "0x5628a59df0ecac3f3171f877a94beb26ba6dfaa0": "Fluxion SwapRouter",
+        "0x2b70c4e7ca8e920435a5db191e066e9e3afd8db3": "Fluxion PositionManager",
+        "0x458f293454fe0d67ec0655f3672301301dd51422": "Aave V3 Pool",
+        "0x9c6ccac66b1c9aba4855e2dd284b9e16e41e06ea": "Aave V3 WETHGateway",
+        "0x78c1b0c915c4faa5fffa6cabf0219da63d7f4cb8": "WMNT"
+    };
+    return labels[lower] ?? null;
+}
+//# sourceMappingURL=protocols.js.map

package/dist/config/protocols.js.map

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

package/dist/config/registry.json

@@ -0,0 +1,208 @@
+{
+    "schema_version": "1.0.0",
+    "network": "mantle",
+    "updated_at": "2026-02-28T00:00:00Z",
+    "notes": "Curated Mantle registry used by mantle_resolveAddress.",
+    "chain_ids": {
+        "mainnet": 5000,
+        "testnet": 5003
+    },
+    "contracts": [
+        {
+            "key": "WMNT",
+            "label": "Wrapped Mantle",
+            "environment": "mainnet",
+            "category": "token",
+            "address": "0x78c1b0C915c4FAA5FffA6CAbf0219DA63d7f4cb8",
+            "status": "active",
+            "is_official": true,
+            "aliases": ["Wrapped MNT"],
+            "source": {
+                "url": "https://docs.mantle.xyz/network/for-developers/quick-access",
+                "retrieved_at": "2026-02-28T00:00:00Z"
+            }
+        },
+        {
+            "key": "WETH",
+            "label": "Wrapped Ether",
+            "environment": "mainnet",
+            "category": "token",
+            "address": "0xdEAddEaDdeadDEadDEADDEAddEADDEAddead1111",
+            "status": "active",
+            "is_official": true,
+            "aliases": [],
+            "source": {
+                "url": "https://token-list.mantle.xyz",
+                "retrieved_at": "2026-02-28T00:00:00Z"
+            }
+        },
+        {
+            "key": "USDC",
+            "label": "USD Coin",
+            "environment": "mainnet",
+            "category": "token",
+            "address": "0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9",
+            "status": "active",
+            "is_official": true,
+            "aliases": [],
+            "source": {
+                "url": "https://token-list.mantle.xyz",
+                "retrieved_at": "2026-02-28T00:00:00Z"
+            }
+        },
+        {
+            "key": "USDT",
+            "label": "Tether",
+            "environment": "mainnet",
+            "category": "token",
+            "address": "0x201EBa5CC46D216Ce6DC03F6a759e8E766e956aE",
+            "status": "active",
+            "is_official": true,
+            "aliases": [],
+            "source": {
+                "url": "https://token-list.mantle.xyz",
+                "retrieved_at": "2026-02-28T00:00:00Z"
+            }
+        },
+        {
+            "key": "METH",
+            "label": "Mantle Staked ETH",
+            "environment": "mainnet",
+            "category": "token",
+            "address": "0xcDA86A272531e8640cD7F1a92c01839911B90bb0",
+            "status": "active",
+            "is_official": true,
+            "aliases": ["mETH"],
+            "source": {
+                "url": "https://token-list.mantle.xyz",
+                "retrieved_at": "2026-02-28T00:00:00Z"
+            }
+        },
+        {
+            "key": "CMETH",
+            "label": "Restaked mETH",
+            "environment": "mainnet",
+            "category": "token",
+            "address": "0xE6829d9a7eE3040e1276Fa75293Bde931859e8fA",
+            "status": "active",
+            "is_official": true,
+            "aliases": ["cmETH"],
+            "source": {
+                "url": "https://token-list.mantle.xyz",
+                "retrieved_at": "2026-02-28T00:00:00Z"
+            }
+        },
+        {
+            "key": "AGNI_ROUTER",
+            "label": "Agni Router",
+            "environment": "mainnet",
+            "category": "defi",
+            "address": "0x319B69888b0d11cEC22caA5034e25FfFBDc88421",
+            "status": "active",
+            "is_official": true,
+            "aliases": ["Agni Swap Router"],
+            "source": {
+                "url": "https://agni.finance",
+                "retrieved_at": "2026-02-28T00:00:00Z"
+            }
+        },
+        {
+            "key": "MERCHANT_MOE_ROUTER",
+            "label": "Merchant Moe MoeRouter (V1 swap)",
+            "environment": "mainnet",
+            "category": "defi",
+            "address": "0xeaEE7EE68874218c3558b40063c42B82D3E7232a",
+            "status": "active",
+            "is_official": true,
+            "aliases": ["Merchant Moe Router", "MoeRouter"],
+            "source": {
+                "url": "https://docs.merchantmoe.com/resources/contracts",
+                "retrieved_at": "2026-02-28T00:00:00Z"
+            }
+        },
+        {
+            "key": "MERCHANT_MOE_LB_ROUTER",
+            "label": "Merchant Moe LB Router v2.2",
+            "environment": "mainnet",
+            "category": "defi",
+            "address": "0x013e138EF6008ae5FDFDE29700e3f2Bc61d21E3a",
+            "status": "active",
+            "is_official": true,
+            "aliases": ["LB Router", "Liquidity Book Router"],
+            "source": {
+                "url": "https://docs.merchantmoe.com/resources/contracts",
+                "retrieved_at": "2026-02-28T00:00:00Z"
+            }
+        },
+        {
+            "key": "AAVE_V3_POOL",
+            "label": "Aave V3 Pool",
+            "environment": "mainnet",
+            "category": "defi",
+            "address": "0x458F293454fE0d67EC0655f3672301301DD51422",
+            "status": "active",
+            "is_official": true,
+            "aliases": ["Aave Pool"],
+            "source": {
+                "url": "https://github.com/bgd-labs/aave-address-book/blob/main/src/ts/AaveV3Mantle.ts",
+                "retrieved_at": "2026-02-28T00:00:00Z"
+            }
+        },
+        {
+            "key": "AAVE_V3_POOL_DATA_PROVIDER",
+            "label": "Aave V3 Pool Data Provider",
+            "environment": "mainnet",
+            "category": "defi",
+            "address": "0x487c5c669D9eee6057C44973207101276cf73b68",
+            "status": "active",
+            "is_official": true,
+            "aliases": ["Aave Data Provider"],
+            "source": {
+                "url": "https://github.com/bgd-labs/aave-address-book/blob/main/src/ts/AaveV3Mantle.ts",
+                "retrieved_at": "2026-02-28T00:00:00Z"
+            }
+        },
+        {
+            "key": "AAVE_V3_POOL_ADDRESSES_PROVIDER",
+            "label": "Aave V3 Pool Addresses Provider",
+            "environment": "mainnet",
+            "category": "defi",
+            "address": "0xba50Cd2A20f6DA35D788639E581bca8d0B5d4D5f",
+            "status": "active",
+            "is_official": true,
+            "aliases": ["Aave Addresses Provider"],
+            "source": {
+                "url": "https://github.com/bgd-labs/aave-address-book/blob/main/src/ts/AaveV3Mantle.ts",
+                "retrieved_at": "2026-02-28T00:00:00Z"
+            }
+        },
+        {
+            "key": "MANTLE_L2_STANDARD_BRIDGE",
+            "label": "Mantle L2 Standard Bridge",
+            "environment": "mainnet",
+            "category": "bridge",
+            "address": "0x4200000000000000000000000000000000000010",
+            "status": "active",
+            "is_official": true,
+            "aliases": ["Standard Bridge L2"],
+            "source": {
+                "url": "https://docs.mantle.xyz/network/system-information/off-chain-system/key-l2-contract-address",
+                "retrieved_at": "2026-02-28T00:00:00Z"
+            }
+        },
+        {
+            "key": "WMNT",
+            "label": "Wrapped Mantle",
+            "environment": "testnet",
+            "category": "token",
+            "address": "0x19f5557E23e9914A18239990f6C70D68FDF0deD5",
+            "status": "active",
+            "is_official": true,
+            "aliases": ["Wrapped MNT Sepolia"],
+            "source": {
+                "url": "https://docs.mantle.xyz/network/for-developers/quick-access",
+                "retrieved_at": "2026-02-28T00:00:00Z"
+            }
+        }
+    ]
+}

package/dist/config/tokens.d.ts

@@ -0,0 +1,9 @@
+import type { Network } from "../types.js";
+export interface TokenEntry {
+    address: string;
+    decimals: number;
+    name: string;
+    symbol: string;
+}
+export declare const MANTLE_TOKENS: Record<Network, Record<string, TokenEntry>>;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/config/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/config/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAqKrE,CAAC"}

package/dist/config/tokens.js

@@ -0,0 +1,167 @@
+export const MANTLE_TOKENS = {
+    mainnet: {
+        MNT: { address: "native", decimals: 18, name: "Mantle", symbol: "MNT" },
+        WMNT: {
+            address: "0x78c1b0C915c4FAA5FffA6CAbf0219DA63d7f4cb8",
+            decimals: 18,
+            name: "Wrapped Mantle",
+            symbol: "WMNT"
+        },
+        WETH: {
+            address: "0xdEAddEaDdeadDEadDEADDEAddEADDEAddead1111",
+            decimals: 18,
+            name: "Wrapped Ether",
+            symbol: "WETH"
+        },
+        USDC: {
+            address: "0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9",
+            decimals: 6,
+            name: "USD Coin",
+            symbol: "USDC"
+        },
+        USDT: {
+            address: "0x201EBa5CC46D216Ce6DC03F6a759e8E766e956aE",
+            decimals: 6,
+            name: "Tether",
+            symbol: "USDT"
+        },
+        USDT0: {
+            address: "0x779Ded0c9e1022225f8E0630b35a9b54bE713736",
+            decimals: 6,
+            name: "USDT0",
+            symbol: "USDT0"
+        },
+        USDe: {
+            address: "0x5d3a1Ff2b6BAb83b63cd9AD0787074081a52ef34",
+            decimals: 18,
+            name: "USDe",
+            symbol: "USDe"
+        },
+        sUSDe: {
+            address: "0x211Cc4DD073734dA055fbF44a2b4667d5E5fE5d2",
+            decimals: 18,
+            name: "Staked USDe",
+            symbol: "sUSDe"
+        },
+        mETH: {
+            address: "0xcDA86A272531e8640cD7F1a92c01839911B90bb0",
+            decimals: 18,
+            name: "Mantle Staked ETH",
+            symbol: "mETH"
+        },
+        cmETH: {
+            address: "0xE6829d9a7eE3040e1276Fa75293Bde931859e8fA",
+            decimals: 18,
+            name: "Restaked mETH",
+            symbol: "cmETH"
+        },
+        MOE: {
+            address: "0x4515A45337F461A11Ff0FE8aBF3c606AE5dC00c9",
+            decimals: 18,
+            name: "Moe Token",
+            symbol: "MOE"
+        },
+        FBTC: {
+            address: "0xC96dE26018A54D51c097160568752c4E3BD6C364",
+            decimals: 8,
+            name: "FBTC",
+            symbol: "FBTC"
+        },
+        GHO: {
+            address: "0xfc421aD3C883Bf9E7C4f42dE845C4e4405799e73",
+            decimals: 18,
+            name: "GHO",
+            symbol: "GHO"
+        },
+        // xStocks RWA tokens (all 18 decimals)
+        wTSLAx: {
+            address: "0x43680abf18cf54898be84c6ef78237cfbd441883",
+            decimals: 18,
+            name: "Tesla xStock",
+            symbol: "wTSLAx"
+        },
+        wAAPLx: {
+            address: "0x5aa7649fdbda47de64a07ac81d64b682af9c0724",
+            decimals: 18,
+            name: "Apple xStock",
+            symbol: "wAAPLx"
+        },
+        wNVDAx: {
+            address: "0x93e62845c1dd5822ebc807ab71a5fb750decd15a",
+            decimals: 18,
+            name: "Nvidia xStock",
+            symbol: "wNVDAx"
+        },
+        wGOOGLx: {
+            address: "0x1630f08370917e79df0b7572395a5e907508bbbc",
+            decimals: 18,
+            name: "Alphabet xStock",
+            symbol: "wGOOGLx"
+        },
+        wMETAx: {
+            address: "0x4e41a262caa93c6575d336e0a4eb79f3c67caa06",
+            decimals: 18,
+            name: "Meta xStock",
+            symbol: "wMETAx"
+        },
+        wQQQx: {
+            address: "0xdbd9232fee15351068fe02f0683146e16d9f2cea",
+            decimals: 18,
+            name: "Nasdaq xStock",
+            symbol: "wQQQx"
+        },
+        wSPYx: {
+            address: "0xc88fcd8b874fdb3256e8b55b3decb8c24eab4c02",
+            decimals: 18,
+            name: "S&P 500 xStock",
+            symbol: "wSPYx"
+        },
+        wMSTRx: {
+            address: "0x266e5923f6118f8b340ca5a23ae7f71897361476",
+            decimals: 18,
+            name: "MicroStrategy xStock",
+            symbol: "wMSTRx"
+        },
+        wHOODx: {
+            address: "0x953707d7a1cb30cc5c636bda8eaebe410341eb14",
+            decimals: 18,
+            name: "Robinhood xStock",
+            symbol: "wHOODx"
+        },
+        wCRCLx: {
+            address: "0xa90872aca656ebe47bdebf3b19ec9dd9c5adc7f8",
+            decimals: 18,
+            name: "Circle xStock",
+            symbol: "wCRCLx"
+        },
+        // Fluxion ecosystem tokens
+        BSB: {
+            address: "0xe5c330ADdf7aa9C7838dA836436142c56a15aa95",
+            decimals: 18,
+            name: "BSB",
+            symbol: "BSB"
+        },
+        ELSA: {
+            address: "0x29cC30f9D113B356Ce408667aa6433589CeCBDcA",
+            decimals: 18,
+            name: "ELSA",
+            symbol: "ELSA"
+        },
+        VOOI: {
+            address: "0xd81a4aDea9932a6BDba0bDBc8C5Fd4C78e5A09f1",
+            decimals: 18,
+            name: "VOOI",
+            symbol: "VOOI"
+        }
+    },
+    sepolia: {
+        MNT: { address: "native", decimals: 18, name: "Mantle", symbol: "MNT" },
+        WMNT: {
+            address: "0x19f5557E23e9914A18239990f6C70D68FDF0deD5",
+            decimals: 18,
+            name: "Wrapped Mantle",
+            symbol: "WMNT"
+        }
+    }
+};
+//# sourceMappingURL=tokens.js.map

package/dist/config/tokens.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,14 @@
+export declare class MantleMcpError extends Error {
+    readonly code: string;
+    readonly suggestion: string;
+    readonly details: Record<string, unknown> | null;
+    constructor(code: string, message: string, suggestion: string, details?: Record<string, unknown> | null);
+}
+export declare function toErrorPayload(error: unknown): {
+    error: true;
+    code: string;
+    message: string;
+    suggestion: string;
+    details: Record<string, unknown> | null;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;gBAG/C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAW;CAOjD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG;IAC9C,KAAK,EAAE,IAAI,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACzC,CAkBA"}

package/dist/errors.js

@@ -0,0 +1,30 @@
+export class MantleMcpError extends Error {
+    code;
+    suggestion;
+    details;
+    constructor(code, message, suggestion, details = null) {
+        super(message);
+        this.code = code;
+        this.suggestion = suggestion;
+        this.details = details;
+    }
+}
+export function toErrorPayload(error) {
+    if (error instanceof MantleMcpError) {
+        return {
+            error: true,
+            code: error.code,
+            message: error.message,
+            suggestion: error.suggestion,
+            details: error.details
+        };
+    }
+    return {
+        error: true,
+        code: "INTERNAL_ERROR",
+        message: error instanceof Error ? error.message : String(error),
+        suggestion: "Retry the operation or check server logs.",
+        details: null
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAS;IACb,UAAU,CAAS;IACnB,OAAO,CAAiC;IAEjD,YACE,IAAY,EACZ,OAAe,EACf,UAAkB,EAClB,UAA0C,IAAI;QAE9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAO3C,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,OAAO;YACL,KAAK,EAAE,IAAI;YACX,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/D,UAAU,EAAE,2CAA2C;QACvD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./errors.js";
+export * from "./types.js";
+export { allTools } from "./tools/index.js";
+export { capabilityCatalog, type CapabilityEntry } from "./capability-catalog.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,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./errors.js";
+export * from "./types.js";
+export { allTools } from "./tools/index.js";
+export { capabilityCatalog } from "./capability-catalog.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,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAwB,MAAM,yBAAyB,CAAC"}