dappily-agent-kit 0.1.0

package/dist/actions/transfer_nft.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const zod_1 = require("zod");
+const sdk_1 = require("@hashgraph/sdk");
+const transferNftAction = {
+    name: "TRANSFER_NFT",
+    similes: [
+        "transfer nft",
+        "send nft",
+        "give nft",
+        "move nft",
+        "nft transfer",
+    ],
+    description: "Transfer an NFT (by serial number) to another Hedera account. The recipient must have the NFT collection associated first. The sender defaults to the agent's operator account.",
+    examples: [
+        [
+            {
+                input: {
+                    tokenId: "0.0.88888",
+                    serial: 1,
+                    to: "0.0.54321",
+                },
+                output: {
+                    ok: true,
+                    summary: "Transferred NFT 0.0.88888 #1 to 0.0.54321",
+                    txId: "0.0.12345@1700000000.000000000",
+                    receipt: { status: "SUCCESS" },
+                    data: {
+                        tokenId: "0.0.88888",
+                        serial: 1,
+                        from: "0.0.12345",
+                        to: "0.0.54321",
+                        explorerUrl: "https://hashscan.io/testnet/transaction/...",
+                    },
+                },
+                explanation: "Transfer NFT serial #1 to another account",
+            },
+        ],
+    ],
+    schema: zod_1.z.object({
+        tokenId: zod_1.z
+            .string()
+            .regex(/^\d+\.\d+\.\d+$/, "Invalid Hedera Token ID format (must be 0.0.X)")
+            .describe("The NFT collection token ID"),
+        serial: zod_1.z
+            .number()
+            .int()
+            .positive()
+            .describe("The serial number of the NFT to transfer"),
+        to: zod_1.z
+            .string()
+            .regex(/^\d+\.\d+\.\d+$/, "Invalid Hedera Account ID format (must be 0.0.X)")
+            .describe("The recipient's Hedera Account ID"),
+        fromAccountId: zod_1.z
+            .string()
+            .regex(/^\d+\.\d+\.\d+$/, "Invalid Hedera Account ID format (must be 0.0.X)")
+            .optional()
+            .describe("Sender account ID. Defaults to the agent's operator account."),
+        memo: zod_1.z
+            .string()
+            .max(100)
+            .optional()
+            .describe("Optional transaction memo"),
+        senderPrivateKey: zod_1.z
+            .string()
+            .optional()
+            .describe("⚠️ Sender's private key (only if different from operator key)"),
+    }),
+    requiresConfirmation: true,
+    simulate: async (agent, input) => {
+        const from = input.fromAccountId || agent.accountId.toString();
+        return {
+            summary: `Transfer NFT ${input.tokenId} #${input.serial} from ${from} to ${input.to}`,
+            estimatedFeeHbar: 0.001,
+            warnings: [],
+        };
+    },
+    handler: async (agent, input) => {
+        try {
+            const tokenId = sdk_1.TokenId.fromString(input.tokenId);
+            const recipient = sdk_1.AccountId.fromString(input.to);
+            const sender = input.fromAccountId
+                ? sdk_1.AccountId.fromString(input.fromAccountId)
+                : agent.accountId;
+            // ── Pre-flight: check if recipient has the collection associated ──
+            try {
+                const recipientBalance = await new sdk_1.AccountBalanceQuery()
+                    .setAccountId(recipient)
+                    .execute(agent.client);
+                if (recipientBalance.tokens) {
+                    const balanceJson = recipientBalance.toJSON();
+                    const hasToken = balanceJson.tokens.some((t) => t.tokenId === input.tokenId);
+                    if (!hasToken) {
+                        return {
+                            ok: false,
+                            error: "TOKEN_NOT_ASSOCIATED_TO_ACCOUNT",
+                            details: `Account ${input.to} has not associated NFT collection ${input.tokenId}. The recipient must run ASSOCIATE_TOKEN first.`,
+                        };
+                    }
+                }
+            }
+            catch {
+                // Balance query failed — proceed and let the network return the real error
+            }
+            // ── Execute transfer ──
+            const tx = new sdk_1.TransferTransaction()
+                .addNftTransfer(tokenId, input.serial, sender, recipient);
+            if (input.memo) {
+                tx.setTransactionMemo(input.memo);
+            }
+            const frozenTx = await tx.freezeWith(agent.client);
+            if (input.senderPrivateKey) {
+                const senderKey = sdk_1.PrivateKey.fromString(input.senderPrivateKey);
+                await frozenTx.sign(senderKey);
+            }
+            const response = await frozenTx.execute(agent.client);
+            const receipt = await response.getReceipt(agent.client);
+            if (receipt.status !== sdk_1.Status.Success) {
+                const statusStr = receipt.status.toString();
+                if (statusStr.includes("TOKEN_NOT_ASSOCIATED_TO_ACCOUNT")) {
+                    return {
+                        ok: false,
+                        error: "TOKEN_NOT_ASSOCIATED_TO_ACCOUNT",
+                        details: `Account ${input.to} has not associated NFT collection ${input.tokenId}. Run ASSOCIATE_TOKEN first.`,
+                    };
+                }
+                return {
+                    ok: false,
+                    error: statusStr,
+                    details: `NFT transfer failed with status: ${statusStr}`,
+                };
+            }
+            const txId = response.transactionId.toString();
+            return {
+                ok: true,
+                summary: `Transferred NFT ${input.tokenId} #${input.serial} to ${input.to}`,
+                txId,
+                receipt: { status: receipt.status.toString() },
+                data: {
+                    tokenId: input.tokenId,
+                    serial: input.serial,
+                    from: sender.toString(),
+                    to: input.to,
+                    explorerUrl: agent.getExplorerUrl(txId),
+                },
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (message.includes("TOKEN_NOT_ASSOCIATED_TO_ACCOUNT")) {
+                return {
+                    ok: false,
+                    error: "TOKEN_NOT_ASSOCIATED_TO_ACCOUNT",
+                    details: `Account ${input.to} has not associated NFT collection ${input.tokenId}. Run ASSOCIATE_TOKEN first.`,
+                };
+            }
+            const knownErrors = {
+                INVALID_SIGNATURE: "Transaction signature is invalid. Check the sender's key.",
+                INVALID_ACCOUNT_ID: "The account ID does not exist on this network.",
+                INVALID_TOKEN_ID: "The token ID does not exist on this network.",
+                INVALID_NFT_ID: "The specified NFT serial does not exist in this collection.",
+                SENDER_DOES_NOT_OWN_NFT_SERIAL_NO: "The sender does not own this NFT serial number.",
+                ACCOUNT_DELETED: "The recipient account has been deleted.",
+                ACCOUNT_FROZEN_FOR_TOKEN: "This account is frozen for this NFT collection.",
+                INSUFFICIENT_PAYER_BALANCE: "Not enough HBAR to cover the transaction fee.",
+            };
+            const errorCode = Object.keys(knownErrors).find((code) => message.includes(code));
+            return {
+                ok: false,
+                error: errorCode || "TRANSFER_NFT_FAILED",
+                details: errorCode ? knownErrors[errorCode] : message,
+            };
+        }
+    },
+};
+exports.default = transferNftAction;
+//# sourceMappingURL=transfer_nft.js.map

package/dist/actions/transfer_nft.js.map

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

package/dist/actions/transfer_token.d.ts

@@ -0,0 +1,4 @@
+import { Action } from "../types/action";
+declare const transferTokenAction: Action;
+export default transferTokenAction;
+//# sourceMappingURL=transfer_token.d.ts.map

package/dist/actions/transfer_token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer_token.d.ts","sourceRoot":"","sources":["../../src/actions/transfer_token.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAgB,MAAM,iBAAiB,CAAC;AASvD,QAAA,MAAM,mBAAmB,EAAE,MAkN1B,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/actions/transfer_token.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const zod_1 = require("zod");
+const sdk_1 = require("@hashgraph/sdk");
+const transferTokenAction = {
+    name: "TRANSFER_TOKEN",
+    similes: [
+        "send token",
+        "transfer token",
+        "pay token",
+        "send fungible",
+        "token transfer",
+        "move token",
+    ],
+    description: "Transfer fungible tokens (HTS) from the agent's account (or a specified sender) to a recipient. The recipient must have previously associated the token, or you'll get a clear error with instructions.",
+    examples: [
+        [
+            {
+                input: {
+                    tokenId: "0.0.99999",
+                    to: "0.0.54321",
+                    amount: 500,
+                },
+                output: {
+                    ok: true,
+                    summary: "Transferred 500 of token 0.0.99999 to 0.0.54321",
+                    txId: "0.0.12345@1700000000.000000000",
+                    receipt: { status: "SUCCESS" },
+                    data: {
+                        tokenId: "0.0.99999",
+                        from: "0.0.12345",
+                        to: "0.0.54321",
+                        amount: 500,
+                        memo: null,
+                        explorerUrl: "https://hashscan.io/testnet/transaction/...",
+                    },
+                },
+                explanation: "Transfer 500 fungible tokens from agent to a recipient",
+            },
+        ],
+    ],
+    schema: zod_1.z.object({
+        tokenId: zod_1.z
+            .string()
+            .regex(/^\d+\.\d+\.\d+$/, "Invalid Hedera Token ID format (must be 0.0.X)")
+            .describe("The token ID to transfer (e.g. 0.0.99999)"),
+        to: zod_1.z
+            .string()
+            .regex(/^\d+\.\d+\.\d+$/, "Invalid Hedera Account ID format (must be 0.0.X)")
+            .describe("The recipient's Hedera Account ID"),
+        amount: zod_1.z
+            .number()
+            .int()
+            .positive()
+            .describe("Amount of tokens to transfer (in smallest unit)"),
+        fromAccountId: zod_1.z
+            .string()
+            .regex(/^\d+\.\d+\.\d+$/, "Invalid Hedera Account ID format (must be 0.0.X)")
+            .optional()
+            .describe("Sender account ID. Defaults to the agent's operator account."),
+        memo: zod_1.z
+            .string()
+            .max(100)
+            .optional()
+            .describe("Optional memo for the transaction"),
+    }),
+    requiresConfirmation: true,
+    simulate: async (agent, input) => {
+        const from = input.fromAccountId || agent.accountId.toString();
+        const warnings = [];
+        if (input.amount >= 1000000) {
+            warnings.push(`Large token transfer: ${input.amount.toLocaleString()} units. Please double-check.`);
+        }
+        return {
+            summary: `Transfer ${input.amount.toLocaleString()} of token ${input.tokenId} from ${from} to ${input.to}`,
+            estimatedFeeHbar: 0.001,
+            warnings,
+        };
+    },
+    handler: async (agent, input) => {
+        try {
+            const tokenId = sdk_1.TokenId.fromString(input.tokenId);
+            const recipient = sdk_1.AccountId.fromString(input.to);
+            const sender = input.fromAccountId
+                ? sdk_1.AccountId.fromString(input.fromAccountId)
+                : agent.accountId;
+            // ── Pre-flight: check if recipient has the token associated ──
+            try {
+                const recipientBalance = await new sdk_1.AccountBalanceQuery()
+                    .setAccountId(recipient)
+                    .execute(agent.client);
+                // If tokens map exists, check if our token is in it
+                if (recipientBalance.tokens) {
+                    const balanceJson = recipientBalance.toJSON();
+                    const hasToken = balanceJson.tokens.some((t) => t.tokenId === input.tokenId);
+                    if (!hasToken) {
+                        return {
+                            ok: false,
+                            error: "TOKEN_NOT_ASSOCIATED_TO_ACCOUNT",
+                            details: `Account ${input.to} has not associated token ${input.tokenId}. The recipient must run ASSOCIATE_TOKEN first before they can receive this token.`,
+                        };
+                    }
+                }
+            }
+            catch {
+                // Balance query failed — proceed anyway and let the transfer
+                // return the real error from the network.
+            }
+            // ── Execute transfer ──
+            const tx = new sdk_1.TransferTransaction()
+                .addTokenTransfer(tokenId, sender, -input.amount)
+                .addTokenTransfer(tokenId, recipient, input.amount);
+            if (input.memo) {
+                tx.setTransactionMemo(input.memo);
+            }
+            const response = await tx.execute(agent.client);
+            const receipt = await response.getReceipt(agent.client);
+            if (receipt.status !== sdk_1.Status.Success) {
+                // Map specific receipt failures
+                const statusStr = receipt.status.toString();
+                if (statusStr.includes("TOKEN_NOT_ASSOCIATED_TO_ACCOUNT")) {
+                    return {
+                        ok: false,
+                        error: "TOKEN_NOT_ASSOCIATED_TO_ACCOUNT",
+                        details: `Account ${input.to} has not associated token ${input.tokenId}. Run ASSOCIATE_TOKEN for this account first.`,
+                    };
+                }
+                return {
+                    ok: false,
+                    error: statusStr,
+                    details: `Token transfer failed with status: ${statusStr}`,
+                };
+            }
+            const txId = response.transactionId.toString();
+            return {
+                ok: true,
+                summary: `Transferred ${input.amount.toLocaleString()} of token ${input.tokenId} to ${input.to}`,
+                txId,
+                receipt: {
+                    status: receipt.status.toString(),
+                },
+                data: {
+                    tokenId: input.tokenId,
+                    from: sender.toString(),
+                    to: input.to,
+                    amount: input.amount,
+                    memo: input.memo || null,
+                    explorerUrl: agent.getExplorerUrl(txId),
+                },
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            // Catch the association error at the network/SDK level too
+            if (message.includes("TOKEN_NOT_ASSOCIATED_TO_ACCOUNT")) {
+                return {
+                    ok: false,
+                    error: "TOKEN_NOT_ASSOCIATED_TO_ACCOUNT",
+                    details: `Account ${input.to} has not associated token ${input.tokenId}. Run ASSOCIATE_TOKEN for this account first.`,
+                };
+            }
+            const knownErrors = {
+                INSUFFICIENT_TOKEN_BALANCE: "The sender does not have enough of this token.",
+                INVALID_ACCOUNT_ID: "The account ID does not exist on this network.",
+                INVALID_TOKEN_ID: "The token ID does not exist on this network.",
+                INVALID_SIGNATURE: "Transaction signature is invalid. Check your private key.",
+                INSUFFICIENT_PAYER_BALANCE: "Not enough HBAR to cover the transaction fee.",
+                ACCOUNT_FROZEN_FOR_TOKEN: "This account is frozen for this token and cannot send or receive it.",
+            };
+            const errorCode = Object.keys(knownErrors).find((code) => message.includes(code));
+            return {
+                ok: false,
+                error: errorCode || "TRANSFER_TOKEN_FAILED",
+                details: errorCode ? knownErrors[errorCode] : message,
+            };
+        }
+    },
+};
+exports.default = transferTokenAction;
+//# sourceMappingURL=transfer_token.js.map

package/dist/actions/transfer_token.js.map

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

package/dist/agent/index.d.ts

@@ -0,0 +1,13 @@
+import { Client, AccountId, PrivateKey } from "@hashgraph/sdk";
+export declare class HederaAgentKit {
+    client: Client;
+    accountId: AccountId;
+    privateKey: PrivateKey;
+    network: "mainnet" | "testnet" | "previewnet";
+    constructor(accountId: string, privateKey: string, network: "mainnet" | "testnet" | "previewnet");
+    /**
+     * Returns the explorer URL for a transaction ID
+     */
+    getExplorerUrl(txId: string): string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE/D,qBAAa,cAAc;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;gBAGnD,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY;IAiB/C;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAOrC"}

package/dist/agent/index.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HederaAgentKit = void 0;
+const sdk_1 = require("@hashgraph/sdk");
+class HederaAgentKit {
+    constructor(accountId, privateKey, network) {
+        this.network = network;
+        this.accountId = sdk_1.AccountId.fromString(accountId);
+        this.privateKey = sdk_1.PrivateKey.fromString(privateKey);
+        if (network === "mainnet") {
+            this.client = sdk_1.Client.forMainnet();
+        }
+        else if (network === "previewnet") {
+            this.client = sdk_1.Client.forPreviewnet();
+        }
+        else {
+            this.client = sdk_1.Client.forTestnet();
+        }
+        this.client.setOperator(this.accountId, this.privateKey);
+    }
+    /**
+     * Returns the explorer URL for a transaction ID
+     */
+    getExplorerUrl(txId) {
+        const formattedTxId = txId.replace(/@/g, "-").replace(/\./g, "-");
+        const baseUrl = this.network === "mainnet"
+            ? "https://hashscan.io/mainnet/transaction/"
+            : "https://hashscan.io/testnet/transaction/";
+        return `${baseUrl}${formattedTxId}`;
+    }
+}
+exports.HederaAgentKit = HederaAgentKit;
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":";;;AAAA,wCAA+D;AAE/D,MAAa,cAAc;IAMzB,YACE,SAAiB,EACjB,UAAkB,EAClB,OAA6C;QAE7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,eAAS,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,UAAU,GAAG,gBAAU,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAEpD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,GAAG,YAAM,CAAC,UAAU,EAAE,CAAC;QACpC,CAAC;aAAM,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,GAAG,YAAM,CAAC,aAAa,EAAE,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,GAAG,YAAM,CAAC,UAAU,EAAE,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,IAAY;QACzB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS;YACxC,CAAC,CAAC,0CAA0C;YAC5C,CAAC,CAAC,0CAA0C,CAAC;QAC/C,OAAO,GAAG,OAAO,GAAG,aAAa,EAAE,CAAC;IACtC,CAAC;CACF;AApCD,wCAoCC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { HederaAgentKit } from "./agent";
+export { actions, getActionByName, findActionBySimile, } from "./actions";
+export { getBalanceAction, hbarTransferAction, createTokenAction, associateTokenAction, transferTokenAction, mintTokenAction, burnTokenAction, createNftCollectionAction, mintNftAction, transferNftAction, burnNftAction, } from "./actions";
+export type { Action, ActionResult, ActionSuccess, ActionFailure, ActionExample, SimulationResult, Handler, } from "./types/action";
+//# 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":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGzC,OAAO,EACL,OAAO,EACP,eAAe,EACf,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,aAAa,EACb,iBAAiB,EACjB,aAAa,GACd,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,MAAM,EACN,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,OAAO,GACR,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+"use strict";
+// ── Dappily Agent Kit ──────────────────────────────────────────
+// Solana Agent Kit-style actions for Hedera (HTS + NFTs).
+// https://github.com/user/dappily-agent-kit
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.burnNftAction = exports.transferNftAction = exports.mintNftAction = exports.createNftCollectionAction = exports.burnTokenAction = exports.mintTokenAction = exports.transferTokenAction = exports.associateTokenAction = exports.createTokenAction = exports.hbarTransferAction = exports.getBalanceAction = exports.findActionBySimile = exports.getActionByName = exports.actions = exports.HederaAgentKit = void 0;
+// Core
+var agent_1 = require("./agent");
+Object.defineProperty(exports, "HederaAgentKit", { enumerable: true, get: function () { return agent_1.HederaAgentKit; } });
+// Actions — registry
+var actions_1 = require("./actions");
+Object.defineProperty(exports, "actions", { enumerable: true, get: function () { return actions_1.actions; } });
+Object.defineProperty(exports, "getActionByName", { enumerable: true, get: function () { return actions_1.getActionByName; } });
+Object.defineProperty(exports, "findActionBySimile", { enumerable: true, get: function () { return actions_1.findActionBySimile; } });
+// Actions — named exports
+var actions_2 = require("./actions");
+Object.defineProperty(exports, "getBalanceAction", { enumerable: true, get: function () { return actions_2.getBalanceAction; } });
+Object.defineProperty(exports, "hbarTransferAction", { enumerable: true, get: function () { return actions_2.hbarTransferAction; } });
+Object.defineProperty(exports, "createTokenAction", { enumerable: true, get: function () { return actions_2.createTokenAction; } });
+Object.defineProperty(exports, "associateTokenAction", { enumerable: true, get: function () { return actions_2.associateTokenAction; } });
+Object.defineProperty(exports, "transferTokenAction", { enumerable: true, get: function () { return actions_2.transferTokenAction; } });
+Object.defineProperty(exports, "mintTokenAction", { enumerable: true, get: function () { return actions_2.mintTokenAction; } });
+Object.defineProperty(exports, "burnTokenAction", { enumerable: true, get: function () { return actions_2.burnTokenAction; } });
+Object.defineProperty(exports, "createNftCollectionAction", { enumerable: true, get: function () { return actions_2.createNftCollectionAction; } });
+Object.defineProperty(exports, "mintNftAction", { enumerable: true, get: function () { return actions_2.mintNftAction; } });
+Object.defineProperty(exports, "transferNftAction", { enumerable: true, get: function () { return actions_2.transferNftAction; } });
+Object.defineProperty(exports, "burnNftAction", { enumerable: true, get: function () { return actions_2.burnNftAction; } });
+//# 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,kEAAkE;AAClE,0DAA0D;AAC1D,4CAA4C;;;AAE5C,OAAO;AACP,iCAAyC;AAAhC,uGAAA,cAAc,OAAA;AAEvB,qBAAqB;AACrB,qCAImB;AAHjB,kGAAA,OAAO,OAAA;AACP,0GAAA,eAAe,OAAA;AACf,6GAAA,kBAAkB,OAAA;AAGpB,0BAA0B;AAC1B,qCAYmB;AAXjB,2GAAA,gBAAgB,OAAA;AAChB,6GAAA,kBAAkB,OAAA;AAClB,4GAAA,iBAAiB,OAAA;AACjB,+GAAA,oBAAoB,OAAA;AACpB,8GAAA,mBAAmB,OAAA;AACnB,0GAAA,eAAe,OAAA;AACf,0GAAA,eAAe,OAAA;AACf,oHAAA,yBAAyB,OAAA;AACzB,wGAAA,aAAa,OAAA;AACb,4GAAA,iBAAiB,OAAA;AACjB,wGAAA,aAAa,OAAA"}

package/dist/types/action.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { HederaAgentKit } from "../agent";
+export interface ActionSuccess {
+    ok: true;
+    summary: string;
+    txId?: string;
+    receipt?: {
+        status: string;
+    };
+    data: Record<string, any>;
+}
+export interface ActionFailure {
+    ok: false;
+    error: string;
+    details?: string;
+}
+export type ActionResult = ActionSuccess | ActionFailure;
+export interface ActionExample {
+    input: Record<string, any>;
+    output: ActionResult;
+    explanation: string;
+}
+export type Handler = (agent: HederaAgentKit, input: any) => Promise<ActionResult>;
+export interface SimulationResult {
+    summary: string;
+    estimatedFeeHbar?: number;
+    warnings?: string[];
+}
+export interface Action {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: ActionExample[][];
+    schema: z.ZodTypeAny;
+    simulate?: (agent: HederaAgentKit, input: any) => Promise<SimulationResult>;
+    requiresConfirmation?: boolean;
+    handler: Handler;
+}
+//# sourceMappingURL=action.d.ts.map

package/dist/types/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/types/action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAK1C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,aAAa,CAAC;AAIzD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,OAAO,GAAG,CACpB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,GAAG,KACP,OAAO,CAAC,YAAY,CAAC,CAAC;AAE3B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,EAAE,EAAE,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5E,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/types/action.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=action.js.map

package/dist/types/action.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "dappily-agent-kit",
+  "version": "0.1.0",
+  "description": "Solana Agent Kit-style actions for Hedera — HTS tokens, NFTs, transfers, and more.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "npx ts-node src/test.ts",
+    "test:integration": "npx ts-node src/integration_test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "hedera",
+    "hts",
+    "nft",
+    "agent",
+    "ai",
+    "toolkit",
+    "web3",
+    "dappily",
+    "solana-agent-kit"
+  ],
+  "author": "Dappily <hello@dappily.io>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dappily/dappily-agent-kit"
+  },
+  "dependencies": {
+    "@hashgraph/sdk": "^2.80.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.33",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "@hashgraph/sdk": ">=2.50.0"
+  }
+}