@agentdomain/agentkit-plugin 0.3.0 → 0.4.0

package/README.md

@@ -10,10 +10,10 @@ The provider exposes actions for:
 
 - Agent identity registration and quote
 - Registry search
-- Email send/list, primary address update, and Pro/Enterprise aliases
+- Email send/list/batch, monthly usage, signed inbound webhooks, primary address updates, and Starter/Pro/Enterprise aliases
 - DNS list/create/update/delete
 - SSL reconfiguration
 - RenewalVault status, funding, auto-renew, and withdrawal
-- Per-agent Pro and Enterprise Premium Plans
+- Per-agent Starter, Pro, and Enterprise Premium Plans
 
 Default API base: `https://agentdomain.app/api/v1`.

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z } from "zod";
 declare const QuoteSchema: z.ZodObject<{
     preferredName: z.ZodString;
     tld: z.ZodDefault<z.ZodEnum<["xyz", "com", "ai", "org", "io", "net", "co", "app"]>>;
@@ -9,7 +9,7 @@ declare const QuoteSchema: z.ZodObject<{
     emailEnabled: z.ZodDefault<z.ZodBoolean>;
     emailUsername: z.ZodOptional<z.ZodString>;
     years: z.ZodDefault<z.ZodNumber>;
-    premiumPlan: z.ZodDefault<z.ZodEnum<["included", "pro", "enterprise"]>>;
+    premiumPlan: z.ZodDefault<z.ZodEnum<["included", "starter", "pro", "enterprise"]>>;
 }, "strip", z.ZodTypeAny, {
     preferredName: string;
     tld: "xyz" | "com" | "ai" | "org" | "io" | "net" | "co" | "app";
@@ -17,7 +17,7 @@ declare const QuoteSchema: z.ZodObject<{
     registerEns: boolean;
     emailEnabled: boolean;
     years: number;
-    premiumPlan: "included" | "pro" | "enterprise";
+    premiumPlan: "included" | "starter" | "pro" | "enterprise";
     basenameLabel?: string | undefined;
     ensLabel?: string | undefined;
     emailUsername?: string | undefined;
@@ -31,7 +31,7 @@ declare const QuoteSchema: z.ZodObject<{
     emailEnabled?: boolean | undefined;
     emailUsername?: string | undefined;
     years?: number | undefined;
-    premiumPlan?: "included" | "pro" | "enterprise" | undefined;
+    premiumPlan?: "included" | "starter" | "pro" | "enterprise" | undefined;
 }>;
 declare const SearchSchema: z.ZodObject<{
     q: z.ZodOptional<z.ZodString>;
@@ -49,7 +49,7 @@ declare const SearchSchema: z.ZodObject<{
     capability?: string | undefined;
     limit?: number | undefined;
 }>;
-declare const RenewalStatusSchema: z.ZodObject<{
+declare const EmailUsageSchema: z.ZodObject<{
     agentId: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     agentId: string;
@@ -67,7 +67,7 @@ export interface AgentDomainActionProviderOptions {
     apiKey?: string;
     baseRpcUrl?: string;
     renewalVaultAddress?: string;
-    network?: 'base' | 'base-sepolia';
+    network?: "base" | "base-sepolia";
 }
 export declare class AgentDomainActionProvider {
     readonly name = "agentdomain";
@@ -91,7 +91,7 @@ export declare class AgentDomainActionProvider {
             emailEnabled: z.ZodDefault<z.ZodBoolean>;
             emailUsername: z.ZodOptional<z.ZodString>;
             years: z.ZodDefault<z.ZodNumber>;
-            premiumPlan: z.ZodDefault<z.ZodEnum<["included", "pro", "enterprise"]>>;
+            premiumPlan: z.ZodDefault<z.ZodEnum<["included", "starter", "pro", "enterprise"]>>;
         }, "strip", z.ZodTypeAny, {
             preferredName: string;
             tld: "xyz" | "com" | "ai" | "org" | "io" | "net" | "co" | "app";
@@ -99,7 +99,7 @@ export declare class AgentDomainActionProvider {
             registerEns: boolean;
             emailEnabled: boolean;
             years: number;
-            premiumPlan: "included" | "pro" | "enterprise";
+            premiumPlan: "included" | "starter" | "pro" | "enterprise";
             basenameLabel?: string | undefined;
             ensLabel?: string | undefined;
             emailUsername?: string | undefined;
@@ -113,7 +113,7 @@ export declare class AgentDomainActionProvider {
             emailEnabled?: boolean | undefined;
             emailUsername?: string | undefined;
             years?: number | undefined;
-            premiumPlan?: "included" | "pro" | "enterprise" | undefined;
+            premiumPlan?: "included" | "starter" | "pro" | "enterprise" | undefined;
         }>;
         invoke: (walletProvider: WalletProvider, args: z.infer<typeof QuoteSchema>) => Promise<string>;
     } | {
@@ -146,7 +146,7 @@ export declare class AgentDomainActionProvider {
         }, {
             agentId: string;
         }>;
-        invoke: (walletProvider: WalletProvider, args: z.infer<typeof RenewalStatusSchema>) => Promise<string>;
+        invoke: (walletProvider: WalletProvider, args: z.infer<typeof EmailUsageSchema>) => Promise<string>;
     })[];
     private register;
     private renewalStatus;
@@ -165,6 +165,9 @@ export declare class AgentDomainActionProvider {
     private search;
     private sendEmail;
     private listEmail;
+    private sendEmailBatch;
+    private emailUsage;
+    private configureEmailWebhook;
     private updatePrimaryEmail;
     private createEmailAlias;
     private deleteEmailAlias;

package/dist/index.js

@@ -1,11 +1,11 @@
-import { z } from 'zod';
-import { AgentDomain } from '@agentdomain/sdk';
-import { AGENTDOMAIN_API_BASE_URL, SERVICE_PLAN_KEYS, SUPPORTED_FRAMEWORKS, SUPPORTED_TLDS, } from '@agentdomain/shared/constants';
-import { createPublicClient, createWalletClient, http, encodeFunctionData, } from 'viem';
-import { base, baseSepolia } from 'viem/chains';
+import { z } from "zod";
+import { AgentDomain } from "@agentdomain/sdk";
+import { AGENTDOMAIN_API_BASE_URL, SERVICE_PLAN_KEYS, SUPPORTED_FRAMEWORKS, SUPPORTED_TLDS, } from "@agentdomain/shared/constants";
+import { createPublicClient, createWalletClient, http, encodeFunctionData, } from "viem";
+import { base, baseSepolia } from "viem/chains";
 const RegisterSchema = z.object({
     preferredName: z.string().min(3).max(63),
-    tld: z.enum(SUPPORTED_TLDS).default('xyz'),
+    tld: z.enum(SUPPORTED_TLDS).default("xyz"),
     registerBasename: z.boolean().default(true),
     basenameLabel: z.string().min(3).max(63).optional(),
     registerEns: z.boolean().default(false),
@@ -24,11 +24,11 @@ const RegisterSchema = z.object({
     dnsTarget: z.string().url().optional(),
     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 QuoteSchema = z.object({
     preferredName: z.string(),
-    tld: z.enum(SUPPORTED_TLDS).default('xyz'),
+    tld: z.enum(SUPPORTED_TLDS).default("xyz"),
     registerBasename: z.boolean().default(true),
     basenameLabel: z.string().min(3).max(63).optional(),
     registerEns: z.boolean().default(false),
@@ -41,7 +41,7 @@ const QuoteSchema = z.object({
         .regex(/^[a-z0-9](?:[a-z0-9._+-]{0,62}[a-z0-9])?$/)
         .optional(),
     years: z.number().int().min(1).max(10).default(1),
-    premiumPlan: z.enum(SERVICE_PLAN_KEYS).default('included'),
+    premiumPlan: z.enum(SERVICE_PLAN_KEYS).default("included"),
 });
 const SearchSchema = z.object({
     q: z.string().optional(),
@@ -60,12 +60,26 @@ const ListEmailSchema = z.object({
     agentId: z.string(),
     limit: z.number().int().min(1).max(100).default(20),
 });
+const BatchEmailSchema = z.object({
+    agentId: z.string(),
+    messages: z.array(SendEmailSchema.omit({ agentId: true })).max(100),
+    idempotencyKey: z.string().max(256).optional(),
+});
+const EmailUsageSchema = z.object({ agentId: z.string() });
+const EmailWebhookSchema = z.object({
+    agentId: z.string(),
+    url: z.string().url(),
+    payloadMode: z.enum(["metadata", "inline_text"]).default("metadata"),
+    enabled: z.boolean().default(true),
+});
 const RenewalStatusSchema = z.object({
     agentId: z.string().min(1),
 });
 const FundRenewalSchema = z.object({
     agentId: z.string().min(1),
-    amountUsdc: z.string().regex(/^\d+(\.\d{1,6})?$/, 'Use a USDC amount with up to 6 decimals'),
+    amountUsdc: z
+        .string()
+        .regex(/^\d+(\.\d{1,6})?$/, "Use a USDC amount with up to 6 decimals"),
     enableAutoRenew: z.boolean().default(false),
 });
 const EnableAutoRenewSchema = z.object({
@@ -74,7 +88,16 @@ const EnableAutoRenewSchema = z.object({
 const SslReconfigureSchema = z.object({
     agentId: z.string().min(1),
 });
-const DnsRecordTypeSchema = z.enum(['A', 'AAAA', 'ALIAS', 'CNAME', 'MX', 'TXT', 'NS', 'SRV']);
+const DnsRecordTypeSchema = z.enum([
+    "A",
+    "AAAA",
+    "ALIAS",
+    "CNAME",
+    "MX",
+    "TXT",
+    "NS",
+    "SRV",
+]);
 const ListDnsSchema = z.object({
     agentId: z.string().min(1),
 });
@@ -96,14 +119,17 @@ const DeleteDnsSchema = z.object({
 });
 const WithdrawRenewalSchema = z.object({
     agentId: z.string().min(1),
-    amountUsdc: z.string().regex(/^\d+(\.\d{1,6})?$/, 'Use a USDC amount with up to 6 decimals'),
+    amountUsdc: z
+        .string()
+        .regex(/^\d+(\.\d{1,6})?$/, "Use a USDC amount with up to 6 decimals"),
 });
 const ServicePlanStatusSchema = z.object({
     agentId: z.string().min(1),
 });
 const PurchaseServicePlanSchema = z.object({
     agentId: z.string().min(1),
-    plan: z.enum(['pro', 'enterprise']),
+    plan: z.enum(["starter", "pro", "enterprise"]),
+    planSku: z.custom().optional(),
 });
 const SetRegistryVisibilitySchema = z.object({
     agentId: z.string().min(1),
@@ -123,7 +149,7 @@ const DeleteEmailAliasSchema = z.object({
     emailAddress: z.string().email(),
 });
 export class AgentDomainActionProvider {
-    name = 'agentdomain';
+    name = "agentdomain";
     apiUrl;
     apiKey;
     baseRpcUrl;
@@ -132,14 +158,17 @@ export class AgentDomainActionProvider {
     constructor(opts = {}) {
         this.apiUrl = opts.apiUrl ?? AGENTDOMAIN_API_BASE_URL;
         this.apiKey = opts.apiKey;
-        this.baseRpcUrl = opts.baseRpcUrl ?? 'https://mainnet.base.org';
+        this.baseRpcUrl = opts.baseRpcUrl ?? "https://mainnet.base.org";
         this.renewalVaultAddress = opts.renewalVaultAddress;
-        this.network = opts.network ?? 'base';
+        this.network = opts.network ?? "base";
     }
     createAgentDomain(walletProvider) {
         const wallet = walletProvider.getAddress();
-        const chain = this.network === 'base-sepolia' ? baseSepolia : base;
-        const publicClient = createPublicClient({ chain, transport: http(this.baseRpcUrl) });
+        const chain = this.network === "base-sepolia" ? baseSepolia : base;
+        const publicClient = createPublicClient({
+            chain,
+            transport: http(this.baseRpcUrl),
+        });
         const walletClient = createWalletClient({
             chain,
             transport: http(this.baseRpcUrl),
@@ -164,122 +193,140 @@ export class AgentDomainActionProvider {
     getActions() {
         return [
             {
-                name: 'register_agent_identity',
-                description: 'Register a complete agent identity bundle on AgentDomain. Domain, DNS, included email setup, SSL certification, AgentID NFT orchestration, and platform fee are included by default. Basename and ENS are optional paid add-ons. Pays in USDC on Base.',
+                name: "register_agent_identity",
+                description: "Register a complete agent identity bundle on AgentDomain. Domain, DNS, included email setup, SSL certification, AgentID NFT orchestration, and platform fee are included by default. Basename and ENS are optional paid add-ons. Pays in USDC on Base.",
                 schema: RegisterSchema,
                 invoke: this.register.bind(this),
             },
             {
-                name: 'quote_agent_registration',
-                description: 'Price an agent identity registration before committing. Quote includes the annual platform fee with email setup, SSL certification, and AgentID NFT orchestration; Basename and ENS only charge when enabled.',
+                name: "quote_agent_registration",
+                description: "Price an agent identity registration before committing. Quote includes the annual platform fee with email setup, SSL certification, and AgentID NFT orchestration; Basename and ENS only charge when enabled.",
                 schema: QuoteSchema,
                 invoke: this.quote.bind(this),
             },
             {
-                name: 'search_agents',
-                description: 'Search the public AgentDomain registry.',
+                name: "search_agents",
+                description: "Search the public AgentDomain registry.",
                 schema: SearchSchema,
                 invoke: this.search.bind(this),
             },
             {
-                name: 'send_agent_email',
-                description: 'Send text-only email from an agent primary email or active alias via AWS SES.',
+                name: "send_agent_email",
+                description: "Send text-only email from an agent primary email or active alias via AWS SES.",
                 schema: SendEmailSchema,
                 invoke: this.sendEmail.bind(this),
             },
             {
-                name: 'list_agent_email',
-                description: 'Query text-only agent email and extracted verification codes.',
+                name: "list_agent_email",
+                description: "Query text-only agent email and extracted verification codes.",
                 schema: ListEmailSchema,
                 invoke: this.listEmail.bind(this),
             },
             {
-                name: 'get_renewal_status',
-                description: 'Get exact next renewal amount, shortfall, vault balance, expiry date, and auto-renew state for an AgentDomain identity.',
+                name: "send_agent_email_batch",
+                description: "Queue up to 100 emails in one API request.",
+                schema: BatchEmailSchema,
+                invoke: this.sendEmailBatch.bind(this),
+            },
+            {
+                name: "get_agent_email_usage",
+                description: "Get combined monthly sent and received email usage.",
+                schema: EmailUsageSchema,
+                invoke: this.emailUsage.bind(this),
+            },
+            {
+                name: "configure_email_webhook",
+                description: "Configure signed inbound email events for this agent.",
+                schema: EmailWebhookSchema,
+                invoke: this.configureEmailWebhook.bind(this),
+            },
+            {
+                name: "get_renewal_status",
+                description: "Get exact next renewal amount, shortfall, vault balance, expiry date, and auto-renew state for an AgentDomain identity.",
                 schema: RenewalStatusSchema,
                 invoke: this.renewalStatus.bind(this),
             },
             {
-                name: 'fund_renewal_vault',
-                description: 'Deposit USDC from the connected wallet into one AgentID renewal vault. Anyone can fund; only the AgentID owner can withdraw or enable auto-renew. Call get_renewal_status first and usually deposit the returned shortfall.',
+                name: "fund_renewal_vault",
+                description: "Deposit USDC from the connected wallet into one AgentID renewal vault. Anyone can fund; only the AgentID owner can withdraw or enable auto-renew. Call get_renewal_status first and usually deposit the returned shortfall.",
                 schema: FundRenewalSchema,
                 invoke: this.fundRenewal.bind(this),
             },
             {
-                name: 'enable_auto_renew',
-                description: 'Enable RenewalVault auto-renew. Requires the wallet provider to be the AgentID NFT owner and support sendTransaction.',
+                name: "enable_auto_renew",
+                description: "Enable RenewalVault auto-renew. Requires the wallet provider to be the AgentID NFT owner and support sendTransaction.",
                 schema: EnableAutoRenewSchema,
                 invoke: this.enableAutoRenew.bind(this),
             },
             {
-                name: 'reconfigure_ssl',
-                description: 'Rebuild the Cloudflare SaaS SSL hostname and sync the required Spaceship DNS validation records for an existing agent.',
+                name: "reconfigure_ssl",
+                description: "Rebuild the Cloudflare SaaS SSL hostname and sync the required Spaceship DNS validation records for an existing agent.",
                 schema: SslReconfigureSchema,
                 invoke: this.reconfigureSsl.bind(this),
             },
             {
-                name: 'list_dns_records',
-                description: 'List DNS records for an AgentDomain identity.',
+                name: "list_dns_records",
+                description: "List DNS records for an AgentDomain identity.",
                 schema: ListDnsSchema,
                 invoke: this.listDns.bind(this),
             },
             {
-                name: 'create_dns_record',
-                description: 'Create a user-managed DNS record and sync it to the domain provider.',
+                name: "create_dns_record",
+                description: "Create a user-managed DNS record and sync it to the domain provider.",
                 schema: CreateDnsSchema,
                 invoke: this.createDns.bind(this),
             },
             {
-                name: 'update_dns_record',
-                description: 'Update a user-managed DNS record and sync it to the domain provider.',
+                name: "update_dns_record",
+                description: "Update a user-managed DNS record and sync it to the domain provider.",
                 schema: UpdateDnsSchema,
                 invoke: this.updateDns.bind(this),
             },
             {
-                name: 'delete_dns_record',
-                description: 'Delete a user-managed DNS record and sync the domain provider state.',
+                name: "delete_dns_record",
+                description: "Delete a user-managed DNS record and sync the domain provider state.",
                 schema: DeleteDnsSchema,
                 invoke: this.deleteDns.bind(this),
             },
             {
-                name: 'withdraw_renewal_vault',
-                description: 'Withdraw unused USDC from an AgentID renewal vault. Requires the AgentID NFT owner wallet.',
+                name: "withdraw_renewal_vault",
+                description: "Withdraw unused USDC from an AgentID renewal vault. Requires the AgentID NFT owner wallet.",
                 schema: WithdrawRenewalSchema,
                 invoke: this.withdrawRenewal.bind(this),
             },
             {
-                name: 'get_service_plan',
-                description: 'Get the current per-agent Premium Plan, limits, and billing state.',
+                name: "get_service_plan",
+                description: "Get the current per-agent Premium Plan, limits, and billing state.",
                 schema: ServicePlanStatusSchema,
                 invoke: this.getServicePlan.bind(this),
             },
             {
-                name: 'purchase_service_plan',
-                description: 'Upgrade one agent to an AgentDomain Pro or Enterprise Premium Plan using x402 USDC payment.',
+                name: "purchase_service_plan",
+                description: "Upgrade one agent to an AgentDomain Starter, Pro, or Enterprise Premium Plan using x402 USDC payment.",
                 schema: PurchaseServicePlanSchema,
                 invoke: this.purchaseServicePlan.bind(this),
             },
             {
-                name: 'set_registry_visibility',
-                description: 'Hide or show one agent in the public AgentDomain registry. Hiding requires an active Pro or Enterprise Premium Plan.',
+                name: "set_registry_visibility",
+                description: "Hide or show one agent in the public AgentDomain registry. Hiding requires an active paid Premium Plan.",
                 schema: SetRegistryVisibilitySchema,
                 invoke: this.setRegistryVisibility.bind(this),
             },
             {
-                name: 'update_primary_email',
-                description: 'Change one agent primary email username. The old primary address stops receiving new mail.',
+                name: "update_primary_email",
+                description: "Change one agent primary email username. The old primary address stops receiving new mail.",
                 schema: UpdatePrimaryEmailSchema,
                 invoke: this.updatePrimaryEmail.bind(this),
             },
             {
-                name: 'create_email_alias',
-                description: 'Create an extra receive-and-send alias for one agent. Requires available Pro or Enterprise alias capacity.',
+                name: "create_email_alias",
+                description: "Create an extra receive-and-send alias for one agent. Requires available paid-plan alias capacity.",
                 schema: CreateEmailAliasSchema,
                 invoke: this.createEmailAlias.bind(this),
             },
             {
-                name: 'delete_email_alias',
-                description: 'Delete one active email alias from an agent.',
+                name: "delete_email_alias",
+                description: "Delete one active email alias from an agent.",
                 schema: DeleteEmailAliasSchema,
                 invoke: this.deleteEmailAlias.bind(this),
             },
@@ -287,23 +334,27 @@ export class AgentDomainActionProvider {
     }
     async register(walletProvider, args) {
         const { ad, wallet } = this.createAgentDomain(walletProvider);
-        const result = await ad.register({ ...args, emailEnabled: true, wallet });
-        let autoRenewMsg = '';
+        const result = await ad.register({
+            ...args,
+            emailEnabled: true,
+            wallet,
+        });
+        let autoRenewMsg = "";
         if (args.autoRenew && this.renewalVaultAddress) {
             try {
                 if (walletProvider.sendTransaction) {
                     const data = encodeFunctionData({
                         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],
                     });
                     const txHash = await walletProvider.sendTransaction({
@@ -314,7 +365,7 @@ export class AgentDomainActionProvider {
                 }
                 else {
                     autoRenewMsg =
-                        ' (Cannot enable auto-renew because walletProvider lacks sendTransaction).';
+                        " (Cannot enable auto-renew because walletProvider lacks sendTransaction).";
                 }
             }
             catch (e) {
@@ -326,7 +377,7 @@ export class AgentDomainActionProvider {
     async renewalStatus(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
         const status = await ad.getRenewalStatus(args.agentId);
-        return `Renewal status for ${status.domain}: next renewal $${status.nextRenewalAmountUsdc}, vault balance $${status.vaultBalanceUsdc}, shortfall $${status.shortfallUsdc}, expires ${status.expiresAt ?? 'unknown'}, renewable from ${status.renewableFrom ?? 'unknown'}, auto-renew ${status.autoRenewEnabled ? 'enabled' : 'off'}.`;
+        return `Renewal status for ${status.domain}: next renewal $${status.nextRenewalAmountUsdc}, vault balance $${status.vaultBalanceUsdc}, shortfall $${status.shortfallUsdc}, expires ${status.expiresAt ?? "unknown"}, renewable from ${status.renewableFrom ?? "unknown"}, auto-renew ${status.autoRenewEnabled ? "enabled" : "off"}.`;
     }
     async fundRenewal(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
@@ -339,30 +390,31 @@ export class AgentDomainActionProvider {
     }
     async enableAutoRenew(walletProvider, args) {
         if (!this.renewalVaultAddress) {
-            throw new Error('renewalVaultAddress is required to enable auto-renew.');
+            throw new Error("renewalVaultAddress is required to enable auto-renew.");
         }
         if (!walletProvider.sendTransaction) {
-            throw new Error('walletProvider.sendTransaction is required to enable auto-renew.');
+            throw new Error("walletProvider.sendTransaction is required to enable auto-renew.");
         }
         const { ad, wallet } = this.createAgentDomain(walletProvider);
         const status = await ad.getRenewalStatus(args.agentId);
         if (!status.tokenId)
-            throw new Error('AgentID NFT is not minted yet.');
-        if (status.ownerAddress && status.ownerAddress.toLowerCase() !== wallet.toLowerCase()) {
+            throw new Error("AgentID NFT is not minted yet.");
+        if (status.ownerAddress &&
+            status.ownerAddress.toLowerCase() !== wallet.toLowerCase()) {
             throw new Error(`Only the AgentID NFT owner (${status.ownerAddress}) can enable auto-renew.`);
         }
         const data = encodeFunctionData({
             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(status.tokenId), true],
         });
         const txHash = await walletProvider.sendTransaction({
@@ -400,7 +452,7 @@ export class AgentDomainActionProvider {
     }
     async withdrawRenewal(walletProvider, args) {
         if (!walletProvider.sendTransaction) {
-            throw new Error('walletProvider.sendTransaction is required to withdraw vault funds.');
+            throw new Error("walletProvider.sendTransaction is required to withdraw vault funds.");
         }
         const { ad } = this.createAgentDomain(walletProvider);
         const tx = await ad.withdrawFromVault(args.agentId, args.amountUsdc);
@@ -415,24 +467,28 @@ export class AgentDomainActionProvider {
     async getServicePlan(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
         const result = await ad.getServicePlan(args.agentId);
-        return `Premium Plan for ${result.domain}: ${result.entitlement.plan} (${result.entitlement.status}), email ${result.entitlement.limits.emailPerHour}/hour and ${result.entitlement.limits.emailPerDay}/day, ${result.entitlement.limits.apiKeys} API key(s), ${result.entitlement.limits.dnsRecords} DNS records, registry hidden ${result.registryVisibility.hidden}.`;
+        return `Premium Plan for ${result.domain}: ${result.entitlement.plan} (${result.entitlement.status}), ${result.entitlement.limits.monthlyEmails} combined emails/month, ${result.entitlement.limits.apiKeys} API key(s), ${result.entitlement.limits.dnsRecords} DNS records, registry hidden ${result.registryVisibility.hidden}.`;
     }
     async purchaseServicePlan(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
         const result = await ad.purchaseServicePlan(args);
-        return `Purchased ${result.entitlement.plan} Premium Plan for ${result.domain}. Current period ends ${result.entitlement.currentPeriodEnd ?? 'unknown'}.`;
+        return `Purchased ${result.entitlement.plan} Premium Plan for ${result.domain}. Current period ends ${result.entitlement.currentPeriodEnd ?? "unknown"}.`;
     }
     async setRegistryVisibility(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
         const result = await ad.setRegistryVisibility(args.agentId, args.registryHidden);
-        return `${result.domain} is now ${result.registryVisibility.hidden ? 'hidden from' : 'visible in'} the public registry.`;
+        return `${result.domain} is now ${result.registryVisibility.hidden ? "hidden from" : "visible in"} the public registry.`;
     }
     async quote(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
         const q = await ad.quote(args);
-        const basenamePart = Number(q.basenameCostUsdc) > 0 ? ` + Basename $${q.basenameCostUsdc}` : '';
-        const ensPart = Number(q.ensCostUsdc) > 0 ? ` + ENS $${q.ensCostUsdc}` : '';
-        const planPart = Number(q.premiumPlanFeeUsdc ?? 0) > 0 ? ` + ${q.premiumPlanLabel} $${q.premiumPlanFeeUsdc}` : '';
+        const basenamePart = Number(q.basenameCostUsdc) > 0
+            ? ` + Basename $${q.basenameCostUsdc}`
+            : "";
+        const ensPart = Number(q.ensCostUsdc) > 0 ? ` + ENS $${q.ensCostUsdc}` : "";
+        const planPart = Number(q.premiumPlanFeeUsdc ?? 0) > 0
+            ? ` + ${q.premiumPlanLabel} $${q.premiumPlanFeeUsdc}`
+            : "";
         return `Total: $${q.totalUsdc} USDC (domain $${q.domainCostUsdc} + platform $${q.platformFeeUsdc ?? q.serviceFeeUsdc}, email and SSL included${basenamePart}${ensPart}${planPart})`;
     }
     async search(walletProvider, args) {
@@ -440,7 +496,7 @@ export class AgentDomainActionProvider {
         const result = await ad.search(args);
         return `Found ${result.total} agents. First ${result.items.length}: ${result.items
             .map((a) => a.domain)
-            .join(', ')}`;
+            .join(", ")}`;
     }
     async sendEmail(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
@@ -450,13 +506,28 @@ export class AgentDomainActionProvider {
             subject: args.subject,
             text: args.text,
         });
-        return `Email sent via SES: ${result.id}`;
+        return `Email queued: ${result.id}`;
     }
     async listEmail(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
         const result = await ad.listEmail(args.agentId, { limit: args.limit });
         return JSON.stringify(result, null, 2);
     }
+    async sendEmailBatch(walletProvider, args) {
+        const { ad } = this.createAgentDomain(walletProvider);
+        return JSON.stringify(await ad.sendEmailBatch(args.agentId, {
+            messages: args.messages,
+            idempotencyKey: args.idempotencyKey,
+        }), null, 2);
+    }
+    async emailUsage(walletProvider, args) {
+        const { ad } = this.createAgentDomain(walletProvider);
+        return JSON.stringify(await ad.getEmailUsage(args.agentId), null, 2);
+    }
+    async configureEmailWebhook(walletProvider, args) {
+        const { ad } = this.createAgentDomain(walletProvider);
+        return JSON.stringify(await ad.setEmailWebhook(args.agentId, args), null, 2);
+    }
     async updatePrimaryEmail(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
         const result = await ad.updatePrimaryEmail(args.agentId, args.username);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentdomain/agentkit-plugin",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Coinbase AgentKit action provider for AgentDomain",
   "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": {
     "@coinbase/agentkit": "^0.1.0"