@agentdomain/agentkit-plugin 0.3.0 → 0.4.1

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/delete/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 exact Enterprise-tier Premium Plan purchase and renewal selection
 
 Default API base: `https://agentdomain.app/api/v1`.

package/dist/index.d.ts

@@ -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;
@@ -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;
@@ -161,10 +161,15 @@ export declare class AgentDomainActionProvider {
     private getServicePlan;
     private purchaseServicePlan;
     private setRegistryVisibility;
+    private scheduleServicePlanRenewal;
     private quote;
     private search;
     private sendEmail;
     private listEmail;
+    private deleteEmailMessage;
+    private sendEmailBatch;
+    private emailUsage;
+    private configureEmailWebhook;
     private updatePrimaryEmail;
     private createEmailAlias;
     private deleteEmailAlias;

package/dist/index.js

@@ -60,6 +60,22 @@ const ListEmailSchema = z.object({
     agentId: z.string(),
     limit: z.number().int().min(1).max(100).default(20),
 });
+const DeleteEmailMessageSchema = z.object({
+    agentId: z.string().uuid(),
+    messageId: z.string().uuid(),
+});
+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),
 });
@@ -103,12 +119,18 @@ const ServicePlanStatusSchema = z.object({
 });
 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),
     registryHidden: z.boolean(),
 });
+const ScheduleServicePlanRenewalSchema = z.object({
+    agentId: z.string().uuid(),
+    plan: z.enum(['included', 'starter', 'pro', 'enterprise']),
+    planSku: z.custom(),
+});
 const UpdatePrimaryEmailSchema = z.object({
     agentId: z.string().min(1),
     username: z
@@ -193,6 +215,30 @@ export class AgentDomainActionProvider {
                 schema: ListEmailSchema,
                 invoke: this.listEmail.bind(this),
             },
+            {
+                name: 'delete_agent_email',
+                description: 'Permanently delete one email message from an agent inbox.',
+                schema: DeleteEmailMessageSchema,
+                invoke: this.deleteEmailMessage.bind(this),
+            },
+            {
+                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.',
@@ -255,16 +301,22 @@ export class AgentDomainActionProvider {
             },
             {
                 name: 'purchase_service_plan',
-                description: 'Upgrade one agent to an AgentDomain Pro or Enterprise Premium Plan using x402 USDC payment.',
+                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.',
+                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: 'schedule_service_plan_renewal',
+                description: 'Choose the exact Premium Plan SKU for the next identity renewal, including Enterprise tiers.',
+                schema: ScheduleServicePlanRenewalSchema,
+                invoke: this.scheduleServicePlanRenewal.bind(this),
+            },
             {
                 name: 'update_primary_email',
                 description: 'Change one agent primary email username. The old primary address stops receiving new mail.',
@@ -273,7 +325,7 @@ export class AgentDomainActionProvider {
             },
             {
                 name: 'create_email_alias',
-                description: 'Create an extra receive-and-send alias for one agent. Requires available Pro or Enterprise alias capacity.',
+                description: 'Create an extra receive-and-send alias for one agent. Requires available paid-plan alias capacity.',
                 schema: CreateEmailAliasSchema,
                 invoke: this.createEmailAlias.bind(this),
             },
@@ -415,7 +467,7 @@ 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);
@@ -427,12 +479,19 @@ export class AgentDomainActionProvider {
         const result = await ad.setRegistryVisibility(args.agentId, args.registryHidden);
         return `${result.domain} is now ${result.registryVisibility.hidden ? 'hidden from' : 'visible in'} the public registry.`;
     }
+    async scheduleServicePlanRenewal(walletProvider, args) {
+        const { ad } = this.createAgentDomain(walletProvider);
+        const result = await ad.scheduleServicePlanRenewal(args.agentId, args);
+        return `Scheduled ${result.renewalPlanSku} for the next identity renewal.`;
+    }
     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 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) {
@@ -450,13 +509,33 @@ 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 deleteEmailMessage(walletProvider, args) {
+        const { ad } = this.createAgentDomain(walletProvider);
+        await ad.deleteEmailMessage(args.agentId, args.messageId);
+        return `Deleted email message ${args.messageId}.`;
+    }
+    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.1",
   "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.1",
+    "@agentdomain/shared": "^0.4.0"
   },
   "peerDependencies": {
     "@coinbase/agentkit": "^0.1.0"