@agentdomain/eliza-plugin 0.3.0 → 0.4.0

package/README.md

@@ -10,7 +10,7 @@ The plugin gives Eliza agents a complete AgentDomain lifecycle surface:
 
 - Registration quote and x402 registration
 - Registry discovery
-- Agent email send/list, primary address update, and Pro/Enterprise aliases
+- Agent email send/list/batch, monthly usage, signed inbound webhooks, primary address updates, and Starter/Pro/Enterprise aliases
 - DNS management
 - SSL repair/reconfiguration
 - RenewalVault status, funding, and auto-renew

package/dist/index.d.ts

@@ -81,6 +81,47 @@ export declare const sendEmailAction: {
         data: import("@agentdomain/sdk").EmailResult;
     }>;
 };
+export declare const emailUsageAction: {
+    name: string;
+    description: string;
+    similes: string[];
+    examples: never[];
+    validate: (runtime: IAgentRuntime) => Promise<boolean>;
+    handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+        text: string;
+        data: import("@agentdomain/sdk").EmailUsageResult;
+    }>;
+};
+export declare const configureEmailWebhookAction: {
+    name: string;
+    description: string;
+    similes: string[];
+    examples: never[];
+    validate: (runtime: IAgentRuntime) => Promise<boolean>;
+    handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+        text: string;
+        data: {
+            webhook: import("@agentdomain/sdk").EmailWebhookConfig;
+            signingSecret?: string;
+        };
+    }>;
+};
+export declare const sendEmailBatchAction: {
+    name: string;
+    description: string;
+    similes: string[];
+    examples: never[];
+    validate: (runtime: IAgentRuntime) => Promise<boolean>;
+    handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+        text: string;
+        data: {
+            batchId: string;
+            status: string;
+            jobs: unknown[];
+            errors: unknown[];
+        };
+    }>;
+};
 export declare const updatePrimaryEmailAction: {
     name: string;
     description: string;
@@ -315,6 +356,44 @@ export declare const agentDomainPlugin: {
             text: string;
             data: import("@agentdomain/sdk").EmailResult;
         }>;
+    } | {
+        name: string;
+        description: string;
+        similes: string[];
+        examples: never[];
+        validate: (runtime: IAgentRuntime) => Promise<boolean>;
+        handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+            text: string;
+            data: import("@agentdomain/sdk").EmailUsageResult;
+        }>;
+    } | {
+        name: string;
+        description: string;
+        similes: string[];
+        examples: never[];
+        validate: (runtime: IAgentRuntime) => Promise<boolean>;
+        handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+            text: string;
+            data: {
+                webhook: import("@agentdomain/sdk").EmailWebhookConfig;
+                signingSecret?: string;
+            };
+        }>;
+    } | {
+        name: string;
+        description: string;
+        similes: string[];
+        examples: never[];
+        validate: (runtime: IAgentRuntime) => Promise<boolean>;
+        handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+            text: string;
+            data: {
+                batchId: string;
+                status: string;
+                jobs: unknown[];
+                errors: unknown[];
+            };
+        }>;
     } | {
         name: string;
         description: string;

package/dist/index.js

@@ -1,24 +1,37 @@
-import { AgentDomain } from '@agentdomain/sdk';
-import { AGENTDOMAIN_API_BASE_URL, SERVICE_PLAN_KEYS, SUPPORTED_TLDS, } from '@agentdomain/shared/constants';
-import { createPublicClient, createWalletClient, http, } from 'viem';
-import { privateKeyToAccount } from 'viem/accounts';
-import { base, baseSepolia } from 'viem/chains';
-import { z } from 'zod';
+import { AgentDomain } from "@agentdomain/sdk";
+import { AGENTDOMAIN_API_BASE_URL, SERVICE_PLAN_KEYS, SUPPORTED_TLDS, } from "@agentdomain/shared/constants";
+import { createPublicClient, createWalletClient, http, } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { base, baseSepolia } from "viem/chains";
+import { z } from "zod";
 function getClients(runtime, opts = {}) {
-    const apiUrl = runtime.getSetting('AGENTDOMAIN_API_URL') ?? AGENTDOMAIN_API_BASE_URL;
-    const apiKey = runtime.getSetting('AGENTDOMAIN_API_KEY');
-    const pk = runtime.getSetting('AGENT_PRIVATE_KEY');
-    const rpc = runtime.getSetting('BASE_RPC_URL') ?? 'https://mainnet.base.org';
-    const network = runtime.getSetting('AGENTDOMAIN_NETWORK') ?? 'base';
-    const chain = network === 'base-sepolia' ? baseSepolia : base;
+    const apiUrl = runtime.getSetting("AGENTDOMAIN_API_URL") ?? AGENTDOMAIN_API_BASE_URL;
+    const apiKey = runtime.getSetting("AGENTDOMAIN_API_KEY");
+    const pk = runtime.getSetting("AGENT_PRIVATE_KEY");
+    const rpc = runtime.getSetting("BASE_RPC_URL") ?? "https://mainnet.base.org";
+    const network = runtime.getSetting("AGENTDOMAIN_NETWORK") ??
+        "base";
+    const chain = network === "base-sepolia" ? baseSepolia : base;
     if (!pk) {
         if (opts.requireWallet)
-            throw new Error('AGENT_PRIVATE_KEY not set');
+            throw new Error("AGENT_PRIVATE_KEY not set");
         const ad = new AgentDomain({ apiUrl, apiKey, network });
-        return { ad, account: null, walletClient: null, publicClient: null, network, chain, rpc };
+        return {
+            ad,
+            account: null,
+            walletClient: null,
+            publicClient: null,
+            network,
+            chain,
+            rpc,
+        };
     }
     const account = privateKeyToAccount(pk);
-    const walletClient = createWalletClient({ account, chain, transport: http(rpc) });
+    const walletClient = createWalletClient({
+        account,
+        chain,
+        transport: http(rpc),
+    });
     const publicClient = createPublicClient({ chain, transport: http(rpc) });
     const ad = new AgentDomain({
         apiUrl,
@@ -29,7 +42,7 @@ function getClients(runtime, opts = {}) {
     });
     return { ad, account, walletClient, publicClient, network, chain, rpc };
 }
-const TLD_PATTERN = new RegExp(String.raw `([a-z0-9-]{3,63})\.([a-z]{2,20})\b`, 'i');
+const TLD_PATTERN = new RegExp(String.raw `([a-z0-9-]{3,63})\.([a-z]{2,20})\b`, "i");
 const UUID_PATTERN = /[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/i;
 const AMOUNT_PATTERN = /\$?\s*(\d+(?:\.\d{1,6})?)\s*(?:usdc)?/i;
 const EMAIL_PATTERN = /[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/i;
@@ -37,7 +50,7 @@ const EMAIL_GLOBAL_PATTERN = /[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/gi;
 const EMAIL_USERNAME_PATTERN = /^[a-z0-9](?:[a-z0-9._+-]{0,62}[a-z0-9])?$/;
 const registerSchema = z.object({
     preferredName: z.string(),
-    tld: z.enum(SUPPORTED_TLDS).default('xyz'),
+    tld: z.enum(SUPPORTED_TLDS).default("xyz"),
     registerBasename: z.boolean().default(true),
     registerEns: z.boolean().default(false),
     emailEnabled: z.boolean().default(true),
@@ -46,13 +59,13 @@ const registerSchema = z.object({
         .trim()
         .toLowerCase()
         .regex(EMAIL_USERNAME_PATTERN)
-        .default('agent'),
+        .default("agent"),
     years: z.number().int().min(1).max(10).default(1),
     autoRenew: z.boolean().default(false),
-    premiumPlan: z.enum(SERVICE_PLAN_KEYS).default('included'),
+    premiumPlan: z.enum(SERVICE_PLAN_KEYS).default("included"),
 });
 const dnsRecordSchema = z.object({
-    type: z.enum(['A', 'AAAA', 'ALIAS', 'CNAME', 'MX', 'TXT', 'NS', 'SRV']),
+    type: z.enum(["A", "AAAA", "ALIAS", "CNAME", "MX", "TXT", "NS", "SRV"]),
     name: z.string(),
     value: z.string(),
     ttl: z.number().int().min(60).max(3600).default(3600),
@@ -62,46 +75,61 @@ function parseParamsFromText(text) {
     const m = text.match(TLD_PATTERN);
     const lower = text.toLowerCase();
     const yearsMatch = lower.match(/([1-9]|10)\s*years?/);
-    const noBasename = lower.includes('no basename') ||
-        lower.includes('without basename') ||
-        lower.includes('skip basename');
-    const noEns = lower.includes('no ens') || lower.includes('without ens') || lower.includes('skip ens');
+    const noBasename = lower.includes("no basename") ||
+        lower.includes("without basename") ||
+        lower.includes("skip basename");
+    const noEns = lower.includes("no ens") ||
+        lower.includes("without ens") ||
+        lower.includes("skip ens");
     const wantsEns = /\bens\b/.test(lower);
     return {
-        preferredName: m?.[1]?.toLowerCase() ?? 'agent',
-        tld: m?.[2]?.toLowerCase() ?? 'xyz',
+        preferredName: m?.[1]?.toLowerCase() ?? "agent",
+        tld: m?.[2]?.toLowerCase() ?? "xyz",
         registerBasename: !noBasename,
         registerEns: wantsEns && !noEns,
         emailEnabled: true,
-        emailUsername: parseEmailUsername(text) ?? 'agent',
+        emailUsername: parseEmailUsername(text) ?? "agent",
         years: yearsMatch ? parseInt(yearsMatch[1], 10) : 1,
-        autoRenew: lower.includes('auto renew') || lower.includes('auto-renew') || lower.includes('autorenew'),
+        autoRenew: lower.includes("auto renew") ||
+            lower.includes("auto-renew") ||
+            lower.includes("autorenew"),
         premiumPlan: parseRegistrationPlan(lower),
     };
 }
 function requireAgentId(text) {
     const agentId = text.match(UUID_PATTERN)?.[0];
     if (!agentId)
-        throw new Error('Agent ID UUID is required');
+        throw new Error("Agent ID UUID is required");
     return agentId;
 }
 function parseAmountUsdc(text) {
     const amount = text.match(AMOUNT_PATTERN)?.[1];
     if (!amount)
-        throw new Error('USDC amount is required');
+        throw new Error("USDC amount is required");
     return amount;
 }
 function parseRegistrationPlan(lower) {
-    if (lower.includes('enterprise'))
-        return 'enterprise';
-    if (lower.includes('pro'))
-        return 'pro';
-    return 'included';
+    if (lower.includes("enterprise"))
+        return "enterprise";
+    if (lower.includes("pro"))
+        return "pro";
+    if (lower.includes("starter"))
+        return "starter";
+    return "included";
 }
 function parsePlan(text) {
     const lower = text.toLowerCase();
-    const plan = lower.includes('enterprise') ? 'enterprise' : 'pro';
-    return { plan };
+    if (lower.includes("enterprise")) {
+        const match = lower.match(/(\d+(?:\.\d+)?)\s*(k|m)/);
+        const monthly = match
+            ? Math.round(Number(match[1]) * (match[2] === "m" ? 1_000_000 : 1_000))
+            : 100_000;
+        return {
+            plan: "enterprise",
+            planSku: `enterprise-${monthly}`,
+        };
+    }
+    return { plan: lower.includes("starter") ? "starter" : "pro" };
 }
 function parseDnsRecord(text) {
     const lower = text.toLowerCase();
@@ -111,17 +139,16 @@ function parseDnsRecord(text) {
     const ttlMatch = text.match(/\bttl[:=]\s*(\d+)/i);
     const priorityMatch = text.match(/\bpriority[:=]\s*(\d+)/i);
     const parsed = dnsRecordSchema.parse({
-        type: typeMatch?.[1]?.toUpperCase() ?? (lower.includes('txt') ? 'TXT' : 'A'),
-        name: nameMatch?.[1] ?? '@',
-        value: valueMatch?.[1] ?? text.match(/\b(?:\d{1,3}\.){3}\d{1,3}\b/)?.[0] ?? '',
+        type: typeMatch?.[1]?.toUpperCase() ?? (lower.includes("txt") ? "TXT" : "A"),
+        name: nameMatch?.[1] ?? "@",
+        value: valueMatch?.[1] ?? text.match(/\b(?:\d{1,3}\.){3}\d{1,3}\b/)?.[0] ?? "",
         ttl: ttlMatch ? Number(ttlMatch[1]) : 3600,
         priority: priorityMatch ? Number(priorityMatch[1]) : undefined,
     });
     return parsed;
 }
 function parseEmailUsername(text) {
-    const explicit = text.match(/\b(?:email\s+username|primary\s+email|username|alias)[:=]?\s*([a-z0-9._+-]{1,64})/i)?.[1] ??
-        text.match(EMAIL_PATTERN)?.[0]?.split('@')[0];
+    const explicit = text.match(/\b(?:email\s+username|primary\s+email|username|alias)[:=]?\s*([a-z0-9._+-]{1,64})/i)?.[1] ?? text.match(EMAIL_PATTERN)?.[0]?.split("@")[0];
     const username = explicit?.trim().toLowerCase();
     return username && EMAIL_USERNAME_PATTERN.test(username) ? username : null;
 }
@@ -129,18 +156,20 @@ function parseEmailRequest(text) {
     const fromAddress = text.match(/\bfrom[:=]\s*([A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,})/i)?.[1];
     const explicitTo = text.match(/\bto[:=]\s*([A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,})/i)?.[1];
     const emails = text.match(EMAIL_GLOBAL_PATTERN) ?? [];
-    const to = explicitTo ?? emails.find((email) => email.toLowerCase() !== fromAddress?.toLowerCase());
+    const to = explicitTo ??
+        emails.find((email) => email.toLowerCase() !== fromAddress?.toLowerCase());
     if (!to)
-        throw new Error('Recipient email address is required');
-    const subject = text.match(/\bsubject[:=]\s*([^|]+)/i)?.[1]?.trim() ?? 'AgentDomain message';
+        throw new Error("Recipient email address is required");
+    const subject = text.match(/\bsubject[:=]\s*([^|]+)/i)?.[1]?.trim() ??
+        "AgentDomain message";
     const body = text.match(/\b(?:text|body|message)[:=]\s*([\s\S]+)/i)?.[1]?.trim() ??
-        text.replace(to, '').trim();
-    return { to, fromAddress, subject, text: body || 'Hello from AgentDomain.' };
+        text.replace(to, "").trim();
+    return { to, fromAddress, subject, text: body || "Hello from AgentDomain." };
 }
 export const quoteRegistrationAction = {
-    name: 'QUOTE_AGENT_REGISTRATION',
-    description: 'Quote an AgentDomain registration before paying.',
-    similes: ['PRICE_DOMAIN', 'REGISTRATION_QUOTE', 'QUOTE_IDENTITY'],
+    name: "QUOTE_AGENT_REGISTRATION",
+    description: "Quote an AgentDomain registration before paying.",
+    similes: ["PRICE_DOMAIN", "REGISTRATION_QUOTE", "QUOTE_IDENTITY"],
     examples: [],
     validate: async () => true,
     handler: async (runtime, message) => {
@@ -154,51 +183,58 @@ export const quoteRegistrationAction = {
     },
 };
 export const registerIdentityAction = {
-    name: 'REGISTER_IDENTITY',
+    name: "REGISTER_IDENTITY",
     description: 'Register a complete agent identity bundle on AgentDomain. Domain, DNS, email setup, SSL certification, AgentID NFT orchestration, and platform fee are included by default. Users can say "no basename" to skip Basename, "with ENS" to add ENS, and "email username support" to customize the primary inbox.',
-    similes: ['CLAIM_DOMAIN', 'CREATE_IDENTITY', 'GET_DOMAIN'],
+    similes: ["CLAIM_DOMAIN", "CREATE_IDENTITY", "GET_DOMAIN"],
     examples: [
         [
-            { user: 'user1', content: { text: 'Register me as helpful-bot.ai email username support' } },
             {
-                user: 'agent',
+                user: "user1",
+                content: {
+                    text: "Register me as helpful-bot.ai email username support",
+                },
+            },
+            {
+                user: "agent",
                 content: {
                     text: "I'll register helpful-bot.ai with included email and SSL infrastructure now.",
-                    action: 'REGISTER_IDENTITY',
+                    action: "REGISTER_IDENTITY",
                 },
             },
         ],
     ],
-    validate: async (runtime, _message) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY')),
+    validate: async (runtime, _message) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY")),
     handler: async (runtime, message) => {
         const params = parseParamsFromText(message.content.text);
         const validated = registerSchema.parse(params);
-        const { ad, account, walletClient, chain } = getClients(runtime, { requireWallet: true });
+        const { ad, account, walletClient, chain } = getClients(runtime, {
+            requireWallet: true,
+        });
         if (!account || !walletClient)
-            throw new Error('AGENT_PRIVATE_KEY not set');
+            throw new Error("AGENT_PRIVATE_KEY not set");
         const result = await ad.register({
             ...validated,
             emailEnabled: true,
             wallet: account.address,
         });
-        let autoRenewMsg = '';
+        let autoRenewMsg = "";
         if (validated.autoRenew) {
-            const vaultAddress = runtime.getSetting('RENEWAL_VAULT_ADDRESS');
+            const vaultAddress = runtime.getSetting("RENEWAL_VAULT_ADDRESS");
             if (vaultAddress) {
                 try {
                     const txHash = await walletClient.writeContract({
                         address: vaultAddress,
                         abi: [
                             {
-                                type: 'function',
-                                name: 'setAutoRenew',
+                                type: "function",
+                                name: "setAutoRenew",
                                 inputs: [
-                                    { name: 'tokenId', type: 'uint256' },
-                                    { name: 'enabled', type: 'bool' },
+                                    { name: "tokenId", type: "uint256" },
+                                    { name: "enabled", type: "bool" },
                                 ],
                             },
                         ],
-                        functionName: 'setAutoRenew',
+                        functionName: "setAutoRenew",
                         args: [BigInt(result.nftTokenId), true],
                         chain,
                         account,
@@ -210,19 +246,20 @@ export const registerIdentityAction = {
                 }
             }
             else {
-                autoRenewMsg = ' (Requires RENEWAL_VAULT_ADDRESS env var to enable auto-renew on-chain).';
+                autoRenewMsg =
+                    " (Requires RENEWAL_VAULT_ADDRESS env var to enable auto-renew on-chain).";
             }
         }
         return {
-            text: `Registered ${result.domain}${result.basename ? ` and ${result.basename}` : ''}. Token #${result.nftTokenId}.${autoRenewMsg}`,
+            text: `Registered ${result.domain}${result.basename ? ` and ${result.basename}` : ""}. Token #${result.nftTokenId}.${autoRenewMsg}`,
             data: result,
         };
     },
 };
 export const searchAgentsAction = {
-    name: 'SEARCH_AGENTS',
-    description: 'Search the public AgentDomain registry by name, capability, or framework.',
-    similes: ['FIND_AGENT', 'DISCOVER_AGENT'],
+    name: "SEARCH_AGENTS",
+    description: "Search the public AgentDomain registry by name, capability, or framework.",
+    similes: ["FIND_AGENT", "DISCOVER_AGENT"],
     examples: [],
     validate: async () => true,
     handler: async (runtime, message) => {
@@ -236,104 +273,169 @@ export const searchAgentsAction = {
     },
 };
 export const listEmailAction = {
-    name: 'LIST_AGENT_EMAIL',
-    description: 'List text-only email messages and extracted verification codes for an AgentDomain identity.',
-    similes: ['CHECK_EMAIL', 'READ_INBOX'],
+    name: "LIST_AGENT_EMAIL",
+    description: "List text-only email messages and extracted verification codes for an AgentDomain identity.",
+    similes: ["CHECK_EMAIL", "READ_INBOX"],
     examples: [],
-    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY')),
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY")),
     handler: async (runtime, message) => {
         const { ad } = getClients(runtime);
         const agentId = message.content.text.match(/[0-9a-f-]{36}/i)?.[0];
         if (!agentId)
-            throw new Error('Agent ID UUID is required to list email');
+            throw new Error("Agent ID UUID is required to list email");
         const result = await ad.listEmail(agentId, { limit: 20 });
         return { text: `Found ${result.messages.length} messages.`, data: result };
     },
 };
 export const sendEmailAction = {
-    name: 'SEND_AGENT_EMAIL',
-    description: 'Send text-only email from an AgentDomain primary address or active alias.',
-    similes: ['SEND_EMAIL', 'EMAIL_FROM_AGENT'],
+    name: "SEND_AGENT_EMAIL",
+    description: "Send text-only email from an AgentDomain primary address or active alias.",
+    similes: ["SEND_EMAIL", "EMAIL_FROM_AGENT"],
     examples: [],
-    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY') || runtime.getSetting('AGENTDOMAIN_API_KEY')),
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY") ||
+        runtime.getSetting("AGENTDOMAIN_API_KEY")),
     handler: async (runtime, message) => {
         const { ad } = getClients(runtime);
         const agentId = requireAgentId(message.content.text);
         const payload = parseEmailRequest(message.content.text);
         const result = await ad.sendEmail(agentId, payload);
-        return { text: `Email sent: ${result.id}.`, data: result };
+        return { text: `Email queued: ${result.id}.`, data: result };
+    },
+};
+export const emailUsageAction = {
+    name: "GET_AGENT_EMAIL_USAGE",
+    description: "Get combined monthly sent and received email usage.",
+    similes: ["EMAIL_USAGE", "EMAIL_QUOTA"],
+    examples: [],
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY") ||
+        runtime.getSetting("AGENTDOMAIN_API_KEY")),
+    handler: async (runtime, message) => {
+        const { ad } = getClients(runtime);
+        const result = await ad.getEmailUsage(requireAgentId(message.content.text));
+        return {
+            text: `Used ${result.used} of ${result.limit} emails; ${result.remaining} remain.`,
+            data: result,
+        };
+    },
+};
+export const configureEmailWebhookAction = {
+    name: "CONFIGURE_EMAIL_WEBHOOK",
+    description: "Configure a signed inbound email webhook. Include an HTTPS URL in the request.",
+    similes: ["SET_EMAIL_WEBHOOK"],
+    examples: [],
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY") ||
+        runtime.getSetting("AGENTDOMAIN_API_KEY")),
+    handler: async (runtime, message) => {
+        const { ad } = getClients(runtime);
+        const agentId = requireAgentId(message.content.text);
+        const url = message.content.text.match(/https:\/\/[^\s]+/)?.[0];
+        if (!url)
+            throw new Error("HTTPS webhook URL is required");
+        const result = await ad.setEmailWebhook(agentId, {
+            url,
+            payloadMode: /inline/i.test(message.content.text)
+                ? "inline_text"
+                : "metadata",
+            enabled: true,
+        });
+        return { text: "Inbound email webhook configured.", data: result };
+    },
+};
+export const sendEmailBatchAction = {
+    name: "SEND_AGENT_EMAIL_BATCH",
+    description: "Queue up to 100 emails supplied as a JSON messages array.",
+    similes: ["BATCH_EMAIL"],
+    examples: [],
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY") ||
+        runtime.getSetting("AGENTDOMAIN_API_KEY")),
+    handler: async (runtime, message) => {
+        const { ad } = getClients(runtime);
+        const agentId = requireAgentId(message.content.text);
+        const json = message.content.text.slice(message.content.text.indexOf("{"));
+        const parsed = JSON.parse(json);
+        const result = await ad.sendEmailBatch(agentId, {
+            messages: parsed.messages,
+        });
+        return { text: `Queued ${result.jobs.length} email jobs.`, data: result };
     },
 };
 export const updatePrimaryEmailAction = {
-    name: 'UPDATE_PRIMARY_EMAIL',
-    description: 'Change an AgentDomain primary email username. The old primary address stops receiving new mail.',
-    similes: ['CHANGE_PRIMARY_EMAIL', 'RENAME_EMAIL'],
+    name: "UPDATE_PRIMARY_EMAIL",
+    description: "Change an AgentDomain primary email username. The old primary address stops receiving new mail.",
+    similes: ["CHANGE_PRIMARY_EMAIL", "RENAME_EMAIL"],
     examples: [],
-    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY') || runtime.getSetting('AGENTDOMAIN_API_KEY')),
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY") ||
+        runtime.getSetting("AGENTDOMAIN_API_KEY")),
     handler: async (runtime, message) => {
         const { ad } = getClients(runtime);
         const agentId = requireAgentId(message.content.text);
         const username = parseEmailUsername(message.content.text);
         if (!username)
-            throw new Error('New email username is required');
+            throw new Error("New email username is required");
         const result = await ad.updatePrimaryEmail(agentId, username);
         return { text: result.message, data: result };
     },
 };
 export const createEmailAliasAction = {
-    name: 'CREATE_EMAIL_ALIAS',
-    description: 'Create a receive-and-send email alias for an AgentDomain identity. Requires available Pro or Enterprise alias capacity.',
-    similes: ['ADD_EMAIL_ALIAS', 'CREATE_ALIAS'],
+    name: "CREATE_EMAIL_ALIAS",
+    description: "Create a receive-and-send email alias for an AgentDomain identity. Requires available paid-plan alias capacity.",
+    similes: ["ADD_EMAIL_ALIAS", "CREATE_ALIAS"],
     examples: [],
-    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY') || runtime.getSetting('AGENTDOMAIN_API_KEY')),
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY") ||
+        runtime.getSetting("AGENTDOMAIN_API_KEY")),
     handler: async (runtime, message) => {
         const { ad } = getClients(runtime);
         const agentId = requireAgentId(message.content.text);
         const username = parseEmailUsername(message.content.text);
         if (!username)
-            throw new Error('Alias username is required');
+            throw new Error("Alias username is required");
         const result = await ad.createEmailAlias(agentId, username);
-        return { text: `Created email alias ${result.address.emailAddress}.`, data: result };
+        return {
+            text: `Created email alias ${result.address.emailAddress}.`,
+            data: result,
+        };
     },
 };
 export const deleteEmailAliasAction = {
-    name: 'DELETE_EMAIL_ALIAS',
-    description: 'Delete an active AgentDomain email alias.',
-    similes: ['REMOVE_EMAIL_ALIAS', 'DELETE_ALIAS'],
+    name: "DELETE_EMAIL_ALIAS",
+    description: "Delete an active AgentDomain email alias.",
+    similes: ["REMOVE_EMAIL_ALIAS", "DELETE_ALIAS"],
     examples: [],
-    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY') || runtime.getSetting('AGENTDOMAIN_API_KEY')),
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY") ||
+        runtime.getSetting("AGENTDOMAIN_API_KEY")),
     handler: async (runtime, message) => {
         const { ad } = getClients(runtime);
         const agentId = requireAgentId(message.content.text);
         const emailAddress = message.content.text.match(EMAIL_PATTERN)?.[0];
         if (!emailAddress)
-            throw new Error('Full alias email address is required');
+            throw new Error("Full alias email address is required");
         const result = await ad.deleteEmailAlias(agentId, emailAddress);
         return { text: `Deleted email alias ${emailAddress}.`, data: result };
     },
 };
 export const renewalStatusAction = {
-    name: 'GET_RENEWAL_STATUS',
-    description: 'Get RenewalVault balance, shortfall, renewal amount, and auto-renew state.',
-    similes: ['RENEWAL_STATUS', 'CHECK_RENEWAL', 'VAULT_STATUS'],
+    name: "GET_RENEWAL_STATUS",
+    description: "Get RenewalVault balance, shortfall, renewal amount, and auto-renew state.",
+    similes: ["RENEWAL_STATUS", "CHECK_RENEWAL", "VAULT_STATUS"],
     examples: [],
-    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY') || runtime.getSetting('AGENTDOMAIN_API_KEY')),
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY") ||
+        runtime.getSetting("AGENTDOMAIN_API_KEY")),
     handler: async (runtime, message) => {
         const { ad } = getClients(runtime);
         const agentId = requireAgentId(message.content.text);
         const status = await ad.getRenewalStatus(agentId);
         return {
-            text: `Renewal for ${status.domain}: next $${status.nextRenewalAmountUsdc}, balance $${status.vaultBalanceUsdc}, shortfall $${status.shortfallUsdc}, auto-renew ${status.autoRenewEnabled ? 'enabled' : 'off'}.`,
+            text: `Renewal for ${status.domain}: next $${status.nextRenewalAmountUsdc}, balance $${status.vaultBalanceUsdc}, shortfall $${status.shortfallUsdc}, auto-renew ${status.autoRenewEnabled ? "enabled" : "off"}.`,
             data: status,
         };
     },
 };
 export const fundRenewalAction = {
-    name: 'FUND_RENEWAL_VAULT',
-    description: 'Deposit USDC into an AgentID renewal vault.',
-    similes: ['DEPOSIT_RENEWAL', 'FUND_VAULT'],
+    name: "FUND_RENEWAL_VAULT",
+    description: "Deposit USDC into an AgentID renewal vault.",
+    similes: ["DEPOSIT_RENEWAL", "FUND_VAULT"],
     examples: [],
-    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY')),
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY")),
     handler: async (runtime, message) => {
         const { ad } = getClients(runtime, { requireWallet: true });
         const agentId = requireAgentId(message.content.text);
@@ -346,31 +448,35 @@ export const fundRenewalAction = {
     },
 };
 export const enableAutoRenewAction = {
-    name: 'ENABLE_AUTO_RENEW',
-    description: 'Enable on-chain RenewalVault auto-renew for an AgentDomain identity.',
-    similes: ['AUTO_RENEW', 'ENABLE_RENEWAL'],
+    name: "ENABLE_AUTO_RENEW",
+    description: "Enable on-chain RenewalVault auto-renew for an AgentDomain identity.",
+    similes: ["AUTO_RENEW", "ENABLE_RENEWAL"],
     examples: [],
-    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY') && runtime.getSetting('RENEWAL_VAULT_ADDRESS')),
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY") &&
+        runtime.getSetting("RENEWAL_VAULT_ADDRESS")),
     handler: async (runtime, message) => {
         const { ad } = getClients(runtime, { requireWallet: true });
         const agentId = requireAgentId(message.content.text);
         const result = await ad.setAutoRenew(agentId, true, {
-            renewalVaultAddress: runtime.getSetting('RENEWAL_VAULT_ADDRESS'),
+            renewalVaultAddress: runtime.getSetting("RENEWAL_VAULT_ADDRESS"),
         });
-        return { text: `Auto-renew enabled for token #${result.tokenId}.`, data: result };
+        return {
+            text: `Auto-renew enabled for token #${result.tokenId}.`,
+            data: result,
+        };
     },
 };
 export const reconfigureSslAction = {
-    name: 'RECONFIGURE_SSL',
-    description: 'Rebuild the Cloudflare SaaS SSL hostname and sync Spaceship DNS validation records for an AgentDomain identity.',
-    similes: ['FIX_SSL', 'REPAIR_SSL', 'SYNC_SSL'],
+    name: "RECONFIGURE_SSL",
+    description: "Rebuild the Cloudflare SaaS SSL hostname and sync Spaceship DNS validation records for an AgentDomain identity.",
+    similes: ["FIX_SSL", "REPAIR_SSL", "SYNC_SSL"],
     examples: [],
-    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY')),
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY")),
     handler: async (runtime, message) => {
         const { ad } = getClients(runtime);
         const agentId = message.content.text.match(/[0-9a-f-]{36}/i)?.[0];
         if (!agentId)
-            throw new Error('Agent ID UUID is required to reconfigure SSL');
+            throw new Error("Agent ID UUID is required to reconfigure SSL");
         const result = await ad.reconfigureSsl(agentId);
         return {
             text: `SSL reconfigured for ${result.domain}. Status: ${result.sslStatus}.`,
@@ -379,11 +485,12 @@ export const reconfigureSslAction = {
     },
 };
 export const listDnsAction = {
-    name: 'LIST_DNS_RECORDS',
-    description: 'List DNS records for an AgentDomain identity.',
-    similes: ['DNS_RECORDS', 'LIST_DNS'],
+    name: "LIST_DNS_RECORDS",
+    description: "List DNS records for an AgentDomain identity.",
+    similes: ["DNS_RECORDS", "LIST_DNS"],
     examples: [],
-    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY') || runtime.getSetting('AGENTDOMAIN_API_KEY')),
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY") ||
+        runtime.getSetting("AGENTDOMAIN_API_KEY")),
     handler: async (runtime, message) => {
         const { ad } = getClients(runtime);
         const agentId = requireAgentId(message.content.text);
@@ -392,98 +499,113 @@ export const listDnsAction = {
     },
 };
 export const createDnsAction = {
-    name: 'CREATE_DNS_RECORD',
-    description: 'Create a user-managed DNS record. Use text like: agentId type A name @ value 1.2.3.4.',
-    similes: ['ADD_DNS', 'CREATE_DNS'],
+    name: "CREATE_DNS_RECORD",
+    description: "Create a user-managed DNS record. Use text like: agentId type A name @ value 1.2.3.4.",
+    similes: ["ADD_DNS", "CREATE_DNS"],
     examples: [],
-    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY') || runtime.getSetting('AGENTDOMAIN_API_KEY')),
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY") ||
+        runtime.getSetting("AGENTDOMAIN_API_KEY")),
     handler: async (runtime, message) => {
         const { ad } = getClients(runtime);
         const agentId = requireAgentId(message.content.text);
         const record = parseDnsRecord(message.content.text);
         const result = await ad.createDnsRecord(agentId, record);
-        return { text: `Created ${result.type} DNS record ${result.name}.`, data: result };
+        return {
+            text: `Created ${result.type} DNS record ${result.name}.`,
+            data: result,
+        };
     },
 };
 export const updateDnsAction = {
-    name: 'UPDATE_DNS_RECORD',
-    description: 'Update a user-managed DNS record. Include agent UUID and record UUID.',
-    similes: ['EDIT_DNS', 'UPDATE_DNS'],
+    name: "UPDATE_DNS_RECORD",
+    description: "Update a user-managed DNS record. Include agent UUID and record UUID.",
+    similes: ["EDIT_DNS", "UPDATE_DNS"],
     examples: [],
-    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY') || runtime.getSetting('AGENTDOMAIN_API_KEY')),
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY") ||
+        runtime.getSetting("AGENTDOMAIN_API_KEY")),
     handler: async (runtime, message) => {
         const { ad } = getClients(runtime);
-        const ids = message.content.text.match(new RegExp(UUID_PATTERN.source, 'gi')) ?? [];
+        const ids = message.content.text.match(new RegExp(UUID_PATTERN.source, "gi")) ?? [];
         const agentId = ids[0];
         const recordId = ids[1];
         if (!agentId || !recordId)
-            throw new Error('Agent ID and record ID UUIDs are required');
+            throw new Error("Agent ID and record ID UUIDs are required");
         const record = parseDnsRecord(message.content.text);
         const result = await ad.updateDnsRecord(agentId, recordId, record);
-        return { text: `Updated ${result.type} DNS record ${result.name}.`, data: result };
+        return {
+            text: `Updated ${result.type} DNS record ${result.name}.`,
+            data: result,
+        };
     },
 };
 export const deleteDnsAction = {
-    name: 'DELETE_DNS_RECORD',
-    description: 'Delete a user-managed DNS record. Include agent UUID and record UUID.',
-    similes: ['REMOVE_DNS', 'DELETE_DNS'],
+    name: "DELETE_DNS_RECORD",
+    description: "Delete a user-managed DNS record. Include agent UUID and record UUID.",
+    similes: ["REMOVE_DNS", "DELETE_DNS"],
     examples: [],
-    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY') || runtime.getSetting('AGENTDOMAIN_API_KEY')),
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY") ||
+        runtime.getSetting("AGENTDOMAIN_API_KEY")),
     handler: async (runtime, message) => {
         const { ad } = getClients(runtime);
-        const ids = message.content.text.match(new RegExp(UUID_PATTERN.source, 'gi')) ?? [];
+        const ids = message.content.text.match(new RegExp(UUID_PATTERN.source, "gi")) ?? [];
         const agentId = ids[0];
         const recordId = ids[1];
         if (!agentId || !recordId)
-            throw new Error('Agent ID and record ID UUIDs are required');
+            throw new Error("Agent ID and record ID UUIDs are required");
         const result = await ad.deleteDnsRecord(agentId, recordId);
         return { text: `Deleted DNS record ${recordId}.`, data: result };
     },
 };
 export const servicePlanStatusAction = {
-    name: 'GET_SERVICE_PLAN',
-    description: 'Get an agent Premium Plan, limits, current period, and billing state.',
-    similes: ['PLAN_STATUS', 'CHECK_PLAN'],
+    name: "GET_SERVICE_PLAN",
+    description: "Get an agent Premium Plan, limits, current period, and billing state.",
+    similes: ["PLAN_STATUS", "CHECK_PLAN"],
     examples: [],
-    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY') || runtime.getSetting('AGENTDOMAIN_API_KEY')),
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY") ||
+        runtime.getSetting("AGENTDOMAIN_API_KEY")),
     handler: async (runtime, message) => {
         const { ad } = getClients(runtime);
         const agentId = requireAgentId(message.content.text);
         const result = await ad.getServicePlan(agentId);
         return {
-            text: `${result.domain} is on ${result.entitlement.plan}. Email limit ${result.entitlement.limits.emailPerHour}/hour, DNS limit ${result.entitlement.limits.dnsRecords}, registry hidden ${result.registryVisibility.hidden}.`,
+            text: `${result.domain} is on ${result.entitlement.plan}. Email limit ${result.entitlement.limits.monthlyEmails}/month combined, DNS limit ${result.entitlement.limits.dnsRecords}, registry hidden ${result.registryVisibility.hidden}.`,
             data: result,
         };
     },
 };
 export const setRegistryVisibilityAction = {
-    name: 'SET_REGISTRY_VISIBILITY',
-    description: 'Hide or show an agent in the public AgentDomain registry. Hiding requires an active Pro or Enterprise Premium Plan.',
-    similes: ['HIDE_AGENT_REGISTRY', 'SHOW_AGENT_REGISTRY', 'REGISTRY_VISIBILITY'],
+    name: "SET_REGISTRY_VISIBILITY",
+    description: "Hide or show an agent in the public AgentDomain registry. Hiding requires an active paid Premium Plan.",
+    similes: [
+        "HIDE_AGENT_REGISTRY",
+        "SHOW_AGENT_REGISTRY",
+        "REGISTRY_VISIBILITY",
+    ],
     examples: [],
-    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY') || runtime.getSetting('AGENTDOMAIN_API_KEY')),
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY") ||
+        runtime.getSetting("AGENTDOMAIN_API_KEY")),
     handler: async (runtime, message) => {
         const { ad } = getClients(runtime);
         const agentId = requireAgentId(message.content.text);
         const text = message.content.text.toLowerCase();
-        const wantsPublic = text.includes('unhide') ||
-            text.includes('show') ||
-            text.includes('visible') ||
-            text.includes('public');
-        const registryHidden = !wantsPublic && (text.includes('hide') || text.includes('private'));
+        const wantsPublic = text.includes("unhide") ||
+            text.includes("show") ||
+            text.includes("visible") ||
+            text.includes("public");
+        const registryHidden = !wantsPublic && (text.includes("hide") || text.includes("private"));
         const result = await ad.setRegistryVisibility(agentId, registryHidden);
         return {
-            text: `${result.domain} is now ${result.registryVisibility.hidden ? 'hidden from' : 'visible in'} the public registry.`,
+            text: `${result.domain} is now ${result.registryVisibility.hidden ? "hidden from" : "visible in"} the public registry.`,
             data: result,
         };
     },
 };
 export const purchaseServicePlanAction = {
-    name: 'PURCHASE_SERVICE_PLAN',
-    description: 'Upgrade an agent to AgentDomain Pro or Enterprise Premium Plan using x402 USDC.',
-    similes: ['BUY_PLAN', 'UPGRADE_PLAN'],
+    name: "PURCHASE_SERVICE_PLAN",
+    description: "Upgrade an agent to AgentDomain Starter, Pro, or Enterprise using x402 USDC.",
+    similes: ["BUY_PLAN", "UPGRADE_PLAN"],
     examples: [],
-    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY')),
+    validate: async (runtime) => Boolean(runtime.getSetting("AGENT_PRIVATE_KEY")),
     handler: async (runtime, message) => {
         const { ad } = getClients(runtime, { requireWallet: true });
         const agentId = requireAgentId(message.content.text);
@@ -499,13 +621,16 @@ export const purchaseServicePlanAction = {
     },
 };
 export const agentDomainPlugin = {
-    name: 'agentdomain',
-    description: 'Identity infrastructure for AI agents on Base (domain + Basename + DNS + email + SSL).',
+    name: "agentdomain",
+    description: "Identity infrastructure for AI agents on Base (domain + Basename + DNS + email + SSL).",
     actions: [
         quoteRegistrationAction,
         registerIdentityAction,
         searchAgentsAction,
         sendEmailAction,
+        sendEmailBatchAction,
+        emailUsageAction,
+        configureEmailWebhookAction,
         listEmailAction,
         updatePrimaryEmailAction,
         createEmailAliasAction,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentdomain/eliza-plugin",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "ElizaOS plugin for AgentDomain - give your Eliza agent a complete identity stack",
   "license": "Apache-2.0",
   "repository": "https://github.com/0xmdrakib/AgentDomain.git",
@@ -26,8 +26,8 @@
   "dependencies": {
     "viem": "^2.55.2",
     "zod": "^3.24.1",
-    "@agentdomain/sdk": "^0.3.0",
-    "@agentdomain/shared": "^0.3.0"
+    "@agentdomain/sdk": "^0.4.0",
+    "@agentdomain/shared": "^0.4.0"
   },
   "peerDependencies": {
     "@elizaos/core": "^1.0.0"