keyring-agent-core 0.1.1 → 0.2.1

package/dist/tools/builtin/nft/BaseNftMessageTool.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseNftMessageTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+/**
+ * Shared base for the canned-message NFT notice tools (`send-nft`,
+ * `get-wallet-nfts`, `get-nft-metadata`, `get-nft-contract-info`).
+ *
+ * Each tool emits one fixed sentence that points the user at a website. The
+ * phrase "this website" is rendered as a Markdown link to `config.url` when one
+ * was supplied at AgentCore construction; otherwise it stays plain text. The
+ * tool takes no arguments — it returns the fully-built Markdown message plus
+ * `_instructions` telling the agent to reply with it verbatim.
+ */
+class BaseNftMessageTool extends BaseTool_1.BaseTool {
+    kind = 'data';
+    category = 'nft';
+    // The message points the user at a concrete next step (a website), so generic
+    // follow-up suggestions would only add noise.
+    noSuggestions = true;
+    parameters = [];
+    /** The phrase inside the template that links to the website. */
+    linkPhrase = 'this website';
+    /** Resolved (trimmed) URL, or undefined when none was configured. */
+    url;
+    constructor(config) {
+        super();
+        const u = config?.url?.trim();
+        this.url = u ? u : undefined;
+    }
+    async run() {
+        const link = this.url ? `[${this.linkPhrase}](${this.url})` : this.linkPhrase;
+        const message = this.template.replace('{link}', link);
+        return {
+            message,
+            _instructions: 'This is a fixed notice. Output it to the user EXACTLY as written below — in English, ' +
+                'without translating, rephrasing, summarising, or adding/removing any words. ' +
+                'Preserve the Markdown link verbatim (do not change, wrap, or drop the URL or the linked words). ' +
+                'Do not mention tools. Reply with only this message:\n\n' +
+                message,
+        };
+    }
+}
+exports.BaseNftMessageTool = BaseNftMessageTool;
+//# sourceMappingURL=BaseNftMessageTool.js.map

package/dist/tools/builtin/nft/BaseNftMessageTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseNftMessageTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/BaseNftMessageTool.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAY1C;;;;;;;;;GASG;AACH,MAAsB,kBAAmB,SAAQ,mBAAQ;IACvD,IAAI,GAAa,MAAM,CAAC;IACxB,QAAQ,GAAG,KAAK,CAAC;IACjB,8EAA8E;IAC9E,8CAA8C;IAC9C,aAAa,GAAG,IAAI,CAAC;IACrB,UAAU,GAAoB,EAAE,CAAC;IAEjC,gEAAgE;IAC7C,UAAU,GAAG,cAAc,CAAC;IAI/C,qEAAqE;IAClD,GAAG,CAAU;IAEhC,YAAY,MAA6B;QACvC,KAAK,EAAE,CAAC;QACR,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/B,CAAC;IAES,KAAK,CAAC,GAAG;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACtD,OAAO;YACL,OAAO;YACP,aAAa,EACX,uFAAuF;gBACvF,8EAA8E;gBAC9E,kGAAkG;gBAClG,yDAAyD;gBACzD,OAAO;SACV,CAAC;IACJ,CAAC;CACF;AAnCD,gDAmCC"}

package/dist/tools/builtin/nft/NFTContractInfoTool.d.ts

@@ -1,21 +1,15 @@
-import { BaseTool } from '../../BaseTool';
-import type { ToolParameter, UserContext } from '../../../types';
-import { type MoralisServiceConfig } from '../../../services/MoralisService';
-export type NFTContractInfoToolConfig = MoralisServiceConfig;
+import { BaseNftMessageTool, type NftMessageToolConfig } from './BaseNftMessageTool';
+export type NFTContractInfoToolConfig = NftMessageToolConfig;
 /**
  * Tool: get-nft-contract-info
  *
- * Fetches metadata for an NFT contract (name, symbol, type) via Moralis EVM API.
+ * Points the user to the NFT website instead of returning collection/contract
+ * metadata. Emits a fixed NFT website notice; "this website" links to the
+ * configured `nftLink` URL when set, otherwise it stays plain text.
  */
-export declare class NFTContractInfoTool extends BaseTool {
+export declare class NFTContractInfoTool extends BaseNftMessageTool {
     name: string;
     description: string;
-    category: string;
-    parameters: ToolParameter[];
-    private service;
-    constructor(config?: NFTContractInfoToolConfig);
-    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<import("../../../services/MoralisService").NFTContractMetadata | {
-        error: string;
-    } | undefined>;
+    protected readonly template = "Please view your NFT collection on {link} for more details";
 }
 //# sourceMappingURL=NFTContractInfoTool.d.ts.map

package/dist/tools/builtin/nft/NFTContractInfoTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NFTContractInfoTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/NFTContractInfoTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAE7F,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,CAAC;AAE7D;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,IAAI,SAA2B;IAC/B,WAAW,SAGsE;IACjF,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CAezB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,yBAAyB;cAK9B,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;CAmB7E"}
+{"version":3,"file":"NFTContractInfoTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/NFTContractInfoTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAErF,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,CAAC;AAE7D;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,kBAAkB;IACzD,IAAI,SAA2B;IAC/B,WAAW,SAEuE;IAElF,SAAS,CAAC,QAAQ,CAAC,QAAQ,gEAAgE;CAC5F"}

package/dist/tools/builtin/nft/NFTContractInfoTool.js

@@ -1,54 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NFTContractInfoTool = void 0;
-const BaseTool_1 = require("../../BaseTool");
-const MoralisService_1 = require("../../../services/MoralisService");
+const BaseNftMessageTool_1 = require("./BaseNftMessageTool");
 /**
  * Tool: get-nft-contract-info
  *
- * Fetches metadata for an NFT contract (name, symbol, type) via Moralis EVM API.
+ * Points the user to the NFT website instead of returning collection/contract
+ * metadata. Emits a fixed NFT website notice; "this website" links to the
+ * configured `nftLink` URL when set, otherwise it stays plain text.
  */
-class NFTContractInfoTool extends BaseTool_1.BaseTool {
+class NFTContractInfoTool extends BaseNftMessageTool_1.BaseNftMessageTool {
     name = 'get-nft-contract-info';
-    description = 'Get metadata for an NFT collection/contract: name, symbol, and contract type (ERC721/ERC1155). ' +
-        'Use this when the user asks about a specific NFT collection or contract address. ' +
-        'Supports: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea';
-    category = 'blockchain-data';
-    parameters = [
-        {
-            name: 'contractAddress',
-            type: 'string',
-            description: 'NFT contract address (0x…).',
-            required: true,
-        },
-        {
-            name: 'chain',
-            type: 'string',
-            description: 'Hex chain ID: "0x1" Ethereum, "0xa" Optimism, "0x38" BSC, "0x89" Polygon, "0x2105" Base, ' +
-                '"0xa4b1" Arbitrum, "0xa86a" Avalanche, "0xe708" Linea . Defaults to connected chain.',
-            required: true,
-        },
-    ];
-    service;
-    constructor(config) {
-        super();
-        this.service = new MoralisService_1.MoralisService(config);
-    }
-    async run(args, userContext) {
-        const contractAddress = args.contractAddress;
-        const chain = args.chain || userContext?.chain || undefined;
-        if (!contractAddress) {
-            return { error: 'NFT contract address is required.' };
-        }
-        const result = await this.service.getNftContractMetadata({
-            address: contractAddress,
-            chain,
-        });
-        if (!result.success) {
-            return { error: result.error || 'Failed to fetch NFT contract metadata' };
-        }
-        return result.data;
-    }
+    description = 'Use when the user asks about an NFT collection / contract (name, symbol, type, floor, socials). ' +
+        'Returns a fixed notice directing them to the NFT website. Takes no arguments.';
+    template = 'Please view your NFT collection on {link} for more details';
 }
 exports.NFTContractInfoTool = NFTContractInfoTool;
 //# sourceMappingURL=NFTContractInfoTool.js.map

package/dist/tools/builtin/nft/NFTContractInfoTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"NFTContractInfoTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/NFTContractInfoTool.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAE1C,qEAA6F;AAI7F;;;;GAIG;AACH,MAAa,mBAAoB,SAAQ,mBAAQ;IAC/C,IAAI,GAAG,uBAAuB,CAAC;IAC/B,WAAW,GACT,iGAAiG;QACjG,mFAAmF;QACnF,8EAA8E,CAAC;IACjF,QAAQ,GAAG,iBAAiB,CAAC;IAC7B,UAAU,GAAoB;QAC5B;YACE,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,6BAA6B;YAC1C,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,2FAA2F;gBAC3F,sFAAsF;YACxF,QAAQ,EAAE,IAAI;SACf;KACF,CAAC;IAEM,OAAO,CAAiB;IAEhC,YAAY,MAAkC;QAC5C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,+BAAc,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAES,KAAK,CAAC,GAAG,CAAC,IAA6B,EAAE,WAAyB;QAC1E,MAAM,eAAe,GAAG,IAAI,CAAC,eAAyB,CAAC;QACvD,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,WAAW,EAAE,KAAK,IAAI,SAAS,CAAC;QAExE,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;QACxD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC;YACvD,OAAO,EAAE,eAAe;YACxB,KAAK;SACN,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,uCAAuC,EAAE,CAAC;QAC5E,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;CACF;AAlDD,kDAkDC"}
+{"version":3,"file":"NFTContractInfoTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/NFTContractInfoTool.ts"],"names":[],"mappings":";;;AAAA,6DAAqF;AAIrF;;;;;;GAMG;AACH,MAAa,mBAAoB,SAAQ,uCAAkB;IACzD,IAAI,GAAG,uBAAuB,CAAC;IAC/B,WAAW,GACT,kGAAkG;QAClG,+EAA+E,CAAC;IAE/D,QAAQ,GAAG,4DAA4D,CAAC;CAC5F;AAPD,kDAOC"}

package/dist/tools/builtin/nft/NFTMetadataTool.d.ts

@@ -1,121 +1,15 @@
-import { BaseTool } from '../../BaseTool';
-import type { ToolParameter, UserContext } from '../../../types';
-import { type MoralisServiceConfig } from '../../../services/MoralisService';
-export type NFTMetadataToolConfig = MoralisServiceConfig;
+import { BaseNftMessageTool, type NftMessageToolConfig } from './BaseNftMessageTool';
+export type NFTMetadataToolConfig = NftMessageToolConfig;
 /**
  * Tool: get-nft-metadata
  *
- * Fetches full metadata for a single NFT identified by its contract address
- * and token id via the Moralis EVM `GET /nft/{address}/{token_id}` endpoint.
- *
- * Moralis docs: https://docs.moralis.com/data-api/evm/nft/metadata/nft-metadata
+ * Points the user to the NFT website instead of returning a single NFT's
+ * metadata. Emits a fixed NFT website notice; "this website" links to the
+ * configured `nftLink` URL when set, otherwise it stays plain text.
  */
-export declare class NFTMetadataTool extends BaseTool {
+export declare class NFTMetadataTool extends BaseNftMessageTool {
     name: string;
     description: string;
-    category: string;
-    parameters: ToolParameter[];
-    private service;
-    constructor(config?: NFTMetadataToolConfig);
-    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
-        error: string;
-        chain?: undefined;
-        contractAddress?: undefined;
-        tokenId?: undefined;
-        contractType?: undefined;
-        amount?: undefined;
-        owner?: undefined;
-        minter?: undefined;
-        blockNumber?: undefined;
-        blockNumberMinted?: undefined;
-        tokenHash?: undefined;
-        name?: undefined;
-        description?: undefined;
-        image?: undefined;
-        animationUrl?: undefined;
-        attributes?: undefined;
-        tokenUri?: undefined;
-        metadata?: undefined;
-        collection?: undefined;
-        media?: undefined;
-        floorPrice?: undefined;
-        floorPriceUsd?: undefined;
-        floorPriceCurrency?: undefined;
-        rarityRank?: undefined;
-        rarityPercentage?: undefined;
-        rarityLabel?: undefined;
-        verifiedCollection?: undefined;
-        possibleSpam?: undefined;
-        lastMetadataSync?: undefined;
-        lastTokenUriSync?: undefined;
-    } | {
-        chain: string | undefined;
-        contractAddress: string;
-        tokenId: string;
-        contractType: "ERC721" | "ERC1155";
-        amount: string;
-        owner: string;
-        minter: string | undefined;
-        blockNumber: string;
-        blockNumberMinted: string;
-        tokenHash: string;
-        name: string;
-        description: string | undefined;
-        image: string | undefined;
-        animationUrl: string | undefined;
-        attributes: {
-            trait_type: string;
-            value: string;
-        }[] | undefined;
-        tokenUri: string | undefined;
-        metadata: string | undefined;
-        collection: {
-            name: string;
-            symbol: string;
-            logo: string | undefined;
-            banner: string | undefined;
-            category: string | undefined;
-            projectUrl: string | undefined;
-            wikiUrl: string | undefined;
-            discordUrl: string | undefined;
-            telegramUrl: string | undefined;
-            twitter: string | undefined;
-            instagram: string | undefined;
-        };
-        media: {
-            mimetype: string | undefined;
-            status: string | undefined;
-            originalUrl: string | undefined;
-            previews: {
-                low?: {
-                    url: string;
-                    width: number;
-                    height: number;
-                };
-                medium?: {
-                    url: string;
-                    width: number;
-                    height: number;
-                };
-                high?: {
-                    url: string;
-                    width: number;
-                    height: number;
-                };
-            } | undefined;
-            updatedAt: string | undefined;
-        } | undefined;
-        floorPrice: string | undefined;
-        floorPriceUsd: string | undefined;
-        floorPriceCurrency: string | undefined;
-        rarityRank: number | undefined;
-        rarityPercentage: number | undefined;
-        rarityLabel: string | undefined;
-        verifiedCollection: boolean;
-        possibleSpam: boolean;
-        lastMetadataSync: string | undefined;
-        lastTokenUriSync: string | undefined;
-        error?: undefined;
-    }>;
+    protected readonly template = "Please view your NFT collection on {link} for more details";
 }
 //# sourceMappingURL=NFTMetadataTool.d.ts.map

package/dist/tools/builtin/nft/NFTMetadataTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NFTMetadataTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/NFTMetadataTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAE7F,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AAEzD;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,IAAI,SAAsB;IAC1B,WAAW,SAMuF;IAClG,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CA+CzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,qBAAqB;cAK1B,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0F7E"}
+{"version":3,"file":"NFTMetadataTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/NFTMetadataTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAErF,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AAEzD;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,kBAAkB;IACrD,IAAI,SAAsB;IAC1B,WAAW,SAGuE;IAElF,SAAS,CAAC,QAAQ,CAAC,QAAQ,gEAAgE;CAC5F"}

package/dist/tools/builtin/nft/NFTMetadataTool.js

@@ -1,159 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NFTMetadataTool = void 0;
-const BaseTool_1 = require("../../BaseTool");
-const MoralisService_1 = require("../../../services/MoralisService");
+const BaseNftMessageTool_1 = require("./BaseNftMessageTool");
 /**
  * Tool: get-nft-metadata
  *
- * Fetches full metadata for a single NFT identified by its contract address
- * and token id via the Moralis EVM `GET /nft/{address}/{token_id}` endpoint.
- *
- * Moralis docs: https://docs.moralis.com/data-api/evm/nft/metadata/nft-metadata
+ * Points the user to the NFT website instead of returning a single NFT's
+ * metadata. Emits a fixed NFT website notice; "this website" links to the
+ * configured `nftLink` URL when set, otherwise it stays plain text.
  */
-class NFTMetadataTool extends BaseTool_1.BaseTool {
+class NFTMetadataTool extends BaseNftMessageTool_1.BaseNftMessageTool {
     name = 'get-nft-metadata';
-    description = 'Get the full metadata for a specific NFT by its contract address and token ID: ' +
-        'name, description, image, attributes/traits, media variants, collection info, ' +
-        'floor price, rarity rank, owner, mint block, and sync timestamps. ' +
-        'Use this when the user asks about a specific NFT, e.g. "show NFT #1234 of collection X", ' +
-        '"details of token ID 42 in contract 0x…", "traits of this NFT", or "floor price of this NFT". ' +
-        'Only supports EVM chains: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Avalanche, Linea.';
-    category = 'blockchain-data';
-    parameters = [
-        {
-            name: 'contractAddress',
-            type: 'string',
-            description: 'NFT contract address (0x…). The collection / contract that mints the token.',
-            required: true,
-        },
-        {
-            name: 'tokenId',
-            type: 'string',
-            description: 'The NFT token ID to look up (as a string, in the format specified by the "format" parameter).',
-            required: true,
-        },
-        {
-            name: 'chain',
-            type: 'string',
-            description: 'Hex chain ID: "0x1" Ethereum, "0xa" Optimism, "0x38" BSC, "0x89" Polygon, "0x2105" Base, ' +
-                '"0xa4b1" Arbitrum, "0xa86a" Avalanche, "0xe708" Linea. Defaults to connected chain.',
-            required: true,
-        },
-        {
-            name: 'format',
-            type: 'string',
-            description: 'Format of the provided token ID: "decimal" (default) or "hex".',
-            required: false,
-        },
-        {
-            name: 'normalizeMetadata',
-            type: 'boolean',
-            description: 'Whether Moralis should return a normalized metadata object (name/description/image/attributes). Default: true.',
-            required: false,
-        },
-        {
-            name: 'mediaItems',
-            type: 'boolean',
-            description: 'Whether to include resized media variants (low / medium / high previews). Default: true.',
-            required: false,
-        },
-        {
-            name: 'include',
-            type: 'string',
-            description: 'Optional extra field to refresh / include in the response: "last_token_uri_sync" or "last_metadata_sync".',
-            required: false,
-        },
-    ];
-    service;
-    constructor(config) {
-        super();
-        this.service = new MoralisService_1.MoralisService(config);
-    }
-    async run(args, userContext) {
-        const contractAddress = args.contractAddress;
-        const tokenId = args.tokenId != null ? String(args.tokenId) : '';
-        const chain = args.chain || userContext?.chain || undefined;
-        const format = args.format || undefined;
-        const normalizeMetadata = typeof args.normalizeMetadata === 'boolean' ? args.normalizeMetadata : undefined;
-        const mediaItems = typeof args.mediaItems === 'boolean' ? args.mediaItems : undefined;
-        const include = args.include || undefined;
-        if (!contractAddress) {
-            return { error: 'NFT contract address is required.' };
-        }
-        if (!tokenId) {
-            return { error: 'Token ID is required.' };
-        }
-        const result = await this.service.getNftMetadata({
-            address: contractAddress,
-            tokenId,
-            chain,
-            format,
-            normalizeMetadata,
-            mediaItems,
-            include,
-        });
-        if (!result.success) {
-            return { error: result.error || 'Failed to fetch NFT metadata' };
-        }
-        const data = result.data;
-        if (!data) {
-            return { error: 'NFT not found' };
-        }
-        const normalized = data.normalized_metadata;
-        const media = data.media;
-        return {
-            chain: chain,
-            contractAddress: data.token_address,
-            tokenId: data.token_id,
-            contractType: data.contract_type,
-            amount: data.amount,
-            owner: data.owner_of,
-            minter: data.minter_address,
-            blockNumber: data.block_number,
-            blockNumberMinted: data.block_number_minted,
-            tokenHash: data.token_hash,
-            name: normalized?.name || data.name,
-            description: normalized?.description,
-            image: normalized?.image || media?.original_media_url,
-            animationUrl: normalized?.animation_url,
-            attributes: normalized?.attributes,
-            tokenUri: data.token_uri,
-            metadata: data.metadata,
-            collection: {
-                name: data.name,
-                symbol: data.symbol,
-                logo: data.collection_logo,
-                banner: data.collection_banner_image,
-                category: data.collection_category,
-                projectUrl: data.project_url,
-                wikiUrl: data.wiki_url,
-                discordUrl: data.discord_url,
-                telegramUrl: data.telegram_url,
-                twitter: data.twitter_username,
-                instagram: data.instagram_username,
-            },
-            media: media
-                ? {
-                    mimetype: media.mimetype,
-                    status: media.status,
-                    originalUrl: media.original_media_url,
-                    previews: media.media_collection,
-                    updatedAt: media.updated_at,
-                }
-                : undefined,
-            floorPrice: data.floor_price,
-            floorPriceUsd: data.floor_price_usd,
-            floorPriceCurrency: data.floor_price_currency,
-            rarityRank: data.rarity_rank,
-            rarityPercentage: data.rarity_percentage,
-            rarityLabel: data.rarity_label,
-            verifiedCollection: data.verified_collection,
-            possibleSpam: data.possible_spam,
-            lastMetadataSync: data.last_metadata_sync,
-            lastTokenUriSync: data.last_token_uri_sync,
-        };
-    }
+    description = 'Use when the user asks about a specific NFT — its details, traits, image, or floor price ' +
+        '("show NFT #1234 of collection X", "traits of this NFT", "floor price of this NFT"). ' +
+        'Returns a fixed notice directing them to the NFT website. Takes no arguments.';
+    template = 'Please view your NFT collection on {link} for more details';
 }
 exports.NFTMetadataTool = NFTMetadataTool;
 //# sourceMappingURL=NFTMetadataTool.js.map

package/dist/tools/builtin/nft/NFTMetadataTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"NFTMetadataTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/NFTMetadataTool.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAE1C,qEAA6F;AAI7F;;;;;;;GAOG;AACH,MAAa,eAAgB,SAAQ,mBAAQ;IAC3C,IAAI,GAAG,kBAAkB,CAAC;IAC1B,WAAW,GACT,iFAAiF;QACjF,gFAAgF;QAChF,oEAAoE;QACpE,2FAA2F;QAC3F,gGAAgG;QAChG,+FAA+F,CAAC;IAClG,QAAQ,GAAG,iBAAiB,CAAC;IAC7B,UAAU,GAAoB;QAC5B;YACE,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,6EAA6E;YAC1F,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+FAA+F;YAC5G,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,2FAA2F;gBAC3F,qFAAqF;YACvF,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gEAAgE;YAC7E,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,mBAAmB;YACzB,IAAI,EAAE,SAAS;YACf,WAAW,EACT,gHAAgH;YAClH,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,0FAA0F;YACvG,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,2GAA2G;YAC7G,QAAQ,EAAE,KAAK;SAChB;KACF,CAAC;IAEM,OAAO,CAAiB;IAEhC,YAAY,MAA8B;QACxC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,+BAAc,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAES,KAAK,CAAC,GAAG,CAAC,IAA6B,EAAE,WAAyB;QAC1E,MAAM,eAAe,GAAG,IAAI,CAAC,eAAyB,CAAC;QACvD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,WAAW,EAAE,KAAK,IAAI,SAAS,CAAC;QACxE,MAAM,MAAM,GAAI,IAAI,CAAC,MAAwC,IAAI,SAAS,CAAC;QAC3E,MAAM,iBAAiB,GAAG,OAAO,IAAI,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3G,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QACtF,MAAM,OAAO,GAAI,IAAI,CAAC,OAAoE,IAAI,SAAS,CAAC;QAExG,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;QAC5C,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;YAC/C,OAAO,EAAE,eAAe;YACxB,OAAO;YACP,KAAK;YACL,MAAM;YACN,iBAAiB;YACjB,UAAU;YACV,OAAO;SACR,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,8BAA8B,EAAE,CAAC;QACnE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;QACpC,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAEzB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,eAAe,EAAE,IAAI,CAAC,aAAa;YACnC,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,QAAQ;YACpB,MAAM,EAAE,IAAI,CAAC,cAAc;YAC3B,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,iBAAiB,EAAE,IAAI,CAAC,mBAAmB;YAC3C,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,IAAI,EAAE,UAAU,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI;YACnC,WAAW,EAAE,UAAU,EAAE,WAAW;YACpC,KAAK,EAAE,UAAU,EAAE,KAAK,IAAI,KAAK,EAAE,kBAAkB;YACrD,YAAY,EAAE,UAAU,EAAE,aAAa;YACvC,UAAU,EAAE,UAAU,EAAE,UAAU;YAClC,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU,EAAE;gBACV,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI,CAAC,eAAe;gBAC1B,MAAM,EAAE,IAAI,CAAC,uBAAuB;gBACpC,QAAQ,EAAE,IAAI,CAAC,mBAAmB;gBAClC,UAAU,EAAE,IAAI,CAAC,WAAW;gBAC5B,OAAO,EAAE,IAAI,CAAC,QAAQ;gBACtB,UAAU,EAAE,IAAI,CAAC,WAAW;gBAC5B,WAAW,EAAE,IAAI,CAAC,YAAY;gBAC9B,OAAO,EAAE,IAAI,CAAC,gBAAgB;gBAC9B,SAAS,EAAE,IAAI,CAAC,kBAAkB;aACnC;YACD,KAAK,EAAE,KAAK;gBACV,CAAC,CAAC;oBACE,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,WAAW,EAAE,KAAK,CAAC,kBAAkB;oBACrC,QAAQ,EAAE,KAAK,CAAC,gBAAgB;oBAChC,SAAS,EAAE,KAAK,CAAC,UAAU;iBAC5B;gBACH,CAAC,CAAC,SAAS;YACb,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,aAAa,EAAE,IAAI,CAAC,eAAe;YACnC,kBAAkB,EAAE,IAAI,CAAC,oBAAoB;YAC7C,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,gBAAgB,EAAE,IAAI,CAAC,iBAAiB;YACxC,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,kBAAkB,EAAE,IAAI,CAAC,mBAAmB;YAC5C,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,gBAAgB,EAAE,IAAI,CAAC,kBAAkB;YACzC,gBAAgB,EAAE,IAAI,CAAC,mBAAmB;SAC3C,CAAC;IACJ,CAAC;CACF;AA5JD,0CA4JC"}
+{"version":3,"file":"NFTMetadataTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/NFTMetadataTool.ts"],"names":[],"mappings":";;;AAAA,6DAAqF;AAIrF;;;;;;GAMG;AACH,MAAa,eAAgB,SAAQ,uCAAkB;IACrD,IAAI,GAAG,kBAAkB,CAAC;IAC1B,WAAW,GACT,2FAA2F;QAC3F,uFAAuF;QACvF,+EAA+E,CAAC;IAE/D,QAAQ,GAAG,4DAA4D,CAAC;CAC5F;AARD,0CAQC"}

package/dist/tools/builtin/nft/SendNftTool.d.ts

@@ -0,0 +1,14 @@
+import { BaseNftMessageTool } from './BaseNftMessageTool';
+/**
+ * Tool: send-nft
+ *
+ * Points the user to the website to send/transfer an NFT. Emits a fixed
+ * message; "this website" links to the configured `nftLink` URL when one is
+ * set, otherwise it stays plain text.
+ */
+export declare class SendNftTool extends BaseNftMessageTool {
+    name: string;
+    description: string;
+    protected readonly template = "Please select the NFT you would like to send from the list and proceed via {link}.";
+}
+//# sourceMappingURL=SendNftTool.d.ts.map

package/dist/tools/builtin/nft/SendNftTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SendNftTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/SendNftTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;GAMG;AACH,qBAAa,WAAY,SAAQ,kBAAkB;IACjD,IAAI,SAAc;IAClB,WAAW,SAGsB;IAEjC,SAAS,CAAC,QAAQ,CAAC,QAAQ,wFAAwF;CACpH"}

package/dist/tools/builtin/nft/SendNftTool.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SendNftTool = void 0;
+const BaseNftMessageTool_1 = require("./BaseNftMessageTool");
+/**
+ * Tool: send-nft
+ *
+ * Points the user to the website to send/transfer an NFT. Emits a fixed
+ * message; "this website" links to the configured `nftLink` URL when one is
+ * set, otherwise it stays plain text.
+ */
+class SendNftTool extends BaseNftMessageTool_1.BaseNftMessageTool {
+    name = 'send-nft';
+    description = 'Use when the user wants to SEND / transfer an NFT ("send my NFT", "transfer an NFT", ' +
+        '"gửi NFT"). Returns a fixed message directing them to select and send the NFT on the ' +
+        'website. Takes no arguments.';
+    template = 'Please select the NFT you would like to send from the list and proceed via {link}.';
+}
+exports.SendNftTool = SendNftTool;
+//# sourceMappingURL=SendNftTool.js.map

package/dist/tools/builtin/nft/SendNftTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SendNftTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/SendNftTool.ts"],"names":[],"mappings":";;;AAAA,6DAA0D;AAE1D;;;;;;GAMG;AACH,MAAa,WAAY,SAAQ,uCAAkB;IACjD,IAAI,GAAG,UAAU,CAAC;IAClB,WAAW,GACT,uFAAuF;QACvF,uFAAuF;QACvF,8BAA8B,CAAC;IAEd,QAAQ,GAAG,oFAAoF,CAAC;CACpH;AARD,kCAQC"}

package/dist/tools/builtin/nft/WalletNFTsTool.d.ts

@@ -1,82 +1,15 @@
-import { BaseTool } from '../../BaseTool';
-import type { ToolParameter, UserContext } from '../../../types';
-import { type MoralisServiceConfig } from '../../../services/MoralisService';
-export type WalletNFTsToolConfig = MoralisServiceConfig;
-interface NormalizedNftAttribute {
-    trait_type: string;
-    value: string;
-}
-interface NormalizedNftMedia {
-    original?: string;
-    low?: string;
-    medium?: string;
-    high?: string;
-    mimetype?: string;
-    status?: string;
-}
-interface NormalizedNft {
-    name: string | null;
-    collectionName: string | null;
-    symbol: string | null;
-    tokenId: string;
-    contractAddress: string;
-    contractType: 'ERC721' | 'ERC1155' | string;
-    amount: string;
-    ownerOf: string;
-    tokenHash: string;
-    tokenUri: string | null;
-    description: string | null;
-    image: string | null;
-    animationUrl: string | null;
-    media: NormalizedNftMedia;
-    attributes: NormalizedNftAttribute[];
-    verifiedCollection: boolean;
-    possibleSpam: boolean;
-    collectionLogo: string | null;
-    collectionBanner: string | null;
-    blockNumber: string;
-    blockNumberMinted: string;
-}
-interface WalletNFTsResult {
-    walletAddress: string;
-    chain: string;
-    filters: {
-        contractAddresses: string[] | null;
-        excludeSpam: boolean;
-        includePrices: boolean;
-        limit: number;
-        cursor: string | null;
-    };
-    pagination: {
-        cursor: string | null;
-        pageSize: number;
-        page: number | null;
-        hasMore: boolean;
-    };
-    nftCount: number;
-    nfts: NormalizedNft[];
-}
+import { BaseNftMessageTool, type NftMessageToolConfig } from './BaseNftMessageTool';
+export type WalletNFTsToolConfig = NftMessageToolConfig;
 /**
  * Tool: get-wallet-nfts
  *
- * Fetches NFTs owned by a wallet address via the Moralis EVM API
- * `GET /{address}/nft`. Returns normalized metadata, media variants,
- * collection info, and cursor-based pagination.
- *
- * Default page size is 10. Pass `cursor` from a previous response to
- * fetch the next page.
+ * Points the user to the NFT website instead of returning on-chain holdings.
+ * Emits a fixed NFT website notice; "this website" links to the configured
+ * `nftLink` URL when set, otherwise it stays plain text.
  */
-export declare class WalletNFTsTool extends BaseTool {
+export declare class WalletNFTsTool extends BaseNftMessageTool {
     name: string;
     description: string;
-    category: string;
-    parameters: ToolParameter[];
-    private service;
-    constructor(config?: WalletNFTsToolConfig);
-    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<WalletNFTsResult | {
-        error: string;
-    }>;
-    private normalize;
+    protected readonly template = "Please view your NFT collection on {link} for more details";
 }
-export {};
 //# sourceMappingURL=WalletNFTsTool.d.ts.map

package/dist/tools/builtin/nft/WalletNFTsTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WalletNFTsTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/WalletNFTsTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAkB,KAAK,oBAAoB,EAAgB,MAAM,kCAAkC,CAAC;AAE3G,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAExD,UAAU,sBAAsB;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,UAAU,gBAAgB;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,iBAAiB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACnC,WAAW,EAAE,OAAO,CAAC;QACrB,aAAa,EAAE,OAAO,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;IACF,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,aAAa,EAAE,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,IAAI,SAAqB;IACzB,WAAW,SAMuE;IAClF,QAAQ,SAAqB;IAC7B,UAAU,EAAE,aAAa,EAAE,CAmDzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,oBAAoB;cAKzB,GAAG,CACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,gBAAgB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IA2DhD,OAAO,CAAC,SAAS;CA0ClB"}
+{"version":3,"file":"WalletNFTsTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/nft/WalletNFTsTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAErF,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAExD;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,kBAAkB;IACpD,IAAI,SAAqB;IACzB,WAAW,SAGsC;IAEjD,SAAS,CAAC,QAAQ,CAAC,QAAQ,gEAAgE;CAC5F"}