@agentdomain/agentkit-plugin 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Md. Rakib
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

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

package/dist/index.d.ts

@@ -7,8 +7,9 @@ declare const QuoteSchema: z.ZodObject<{
     registerEns: z.ZodDefault<z.ZodBoolean>;
     ensLabel: z.ZodOptional<z.ZodString>;
     emailEnabled: z.ZodDefault<z.ZodBoolean>;
+    emailUsername: z.ZodOptional<z.ZodString>;
     years: z.ZodDefault<z.ZodNumber>;
-    discountCode: z.ZodOptional<z.ZodString>;
+    premiumPlan: z.ZodDefault<z.ZodEnum<["included", "pro", "enterprise"]>>;
 }, "strip", z.ZodTypeAny, {
     preferredName: string;
     tld: "xyz" | "com" | "ai" | "org" | "io" | "net" | "co" | "app";
@@ -16,9 +17,10 @@ declare const QuoteSchema: z.ZodObject<{
     registerEns: boolean;
     emailEnabled: boolean;
     years: number;
+    premiumPlan: "included" | "pro" | "enterprise";
     basenameLabel?: string | undefined;
     ensLabel?: string | undefined;
-    discountCode?: string | undefined;
+    emailUsername?: string | undefined;
 }, {
     preferredName: string;
     tld?: "xyz" | "com" | "ai" | "org" | "io" | "net" | "co" | "app" | undefined;
@@ -27,8 +29,9 @@ declare const QuoteSchema: z.ZodObject<{
     registerEns?: boolean | undefined;
     ensLabel?: string | undefined;
     emailEnabled?: boolean | undefined;
+    emailUsername?: string | undefined;
     years?: number | undefined;
-    discountCode?: string | undefined;
+    premiumPlan?: "included" | "pro" | "enterprise" | undefined;
 }>;
 declare const SearchSchema: z.ZodObject<{
     q: z.ZodOptional<z.ZodString>;
@@ -86,8 +89,9 @@ export declare class AgentDomainActionProvider {
             registerEns: z.ZodDefault<z.ZodBoolean>;
             ensLabel: z.ZodOptional<z.ZodString>;
             emailEnabled: z.ZodDefault<z.ZodBoolean>;
+            emailUsername: z.ZodOptional<z.ZodString>;
             years: z.ZodDefault<z.ZodNumber>;
-            discountCode: z.ZodOptional<z.ZodString>;
+            premiumPlan: z.ZodDefault<z.ZodEnum<["included", "pro", "enterprise"]>>;
         }, "strip", z.ZodTypeAny, {
             preferredName: string;
             tld: "xyz" | "com" | "ai" | "org" | "io" | "net" | "co" | "app";
@@ -95,9 +99,10 @@ export declare class AgentDomainActionProvider {
             registerEns: boolean;
             emailEnabled: boolean;
             years: number;
+            premiumPlan: "included" | "pro" | "enterprise";
             basenameLabel?: string | undefined;
             ensLabel?: string | undefined;
-            discountCode?: string | undefined;
+            emailUsername?: string | undefined;
         }, {
             preferredName: string;
             tld?: "xyz" | "com" | "ai" | "org" | "io" | "net" | "co" | "app" | undefined;
@@ -106,8 +111,9 @@ export declare class AgentDomainActionProvider {
             registerEns?: boolean | undefined;
             ensLabel?: string | undefined;
             emailEnabled?: boolean | undefined;
+            emailUsername?: string | undefined;
             years?: number | undefined;
-            discountCode?: string | undefined;
+            premiumPlan?: "included" | "pro" | "enterprise" | undefined;
         }>;
         invoke: (walletProvider: WalletProvider, args: z.infer<typeof QuoteSchema>) => Promise<string>;
     } | {
@@ -154,9 +160,13 @@ export declare class AgentDomainActionProvider {
     private withdrawRenewal;
     private getServicePlan;
     private purchaseServicePlan;
+    private setRegistryVisibility;
     private quote;
     private search;
     private sendEmail;
     private listEmail;
+    private updatePrimaryEmail;
+    private createEmailAlias;
+    private deleteEmailAlias;
 }
 export default AgentDomainActionProvider;

package/dist/index.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { AgentDomain } from '@agentdomain/sdk';
-import { AGENTDOMAIN_API_BASE_URL, SUPPORTED_FRAMEWORKS, SUPPORTED_TLDS, } from '@agentdomain/shared/constants';
+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({
@@ -14,11 +14,17 @@ const RegisterSchema = z.object({
         .string()
         .regex(/^0x[a-fA-F0-9]{40}$/)
         .optional(),
-    emailEnabled: z.boolean().default(false),
+    emailEnabled: z.boolean().default(true),
+    emailUsername: z
+        .string()
+        .trim()
+        .toLowerCase()
+        .regex(/^[a-z0-9](?:[a-z0-9._+-]{0,62}[a-z0-9])?$/)
+        .optional(),
     dnsTarget: z.string().url().optional(),
     years: z.number().int().min(1).max(10).default(1),
     autoRenew: z.boolean().default(false),
-    discountCode: z.string().max(50).optional(),
+    premiumPlan: z.enum(SERVICE_PLAN_KEYS).default('included'),
 });
 const QuoteSchema = z.object({
     preferredName: z.string(),
@@ -27,9 +33,15 @@ const QuoteSchema = z.object({
     basenameLabel: z.string().min(3).max(63).optional(),
     registerEns: z.boolean().default(false),
     ensLabel: z.string().min(3).max(63).optional(),
-    emailEnabled: z.boolean().default(false),
+    emailEnabled: z.boolean().default(true),
+    emailUsername: z
+        .string()
+        .trim()
+        .toLowerCase()
+        .regex(/^[a-z0-9](?:[a-z0-9._+-]{0,62}[a-z0-9])?$/)
+        .optional(),
     years: z.number().int().min(1).max(10).default(1),
-    discountCode: z.string().max(50).optional(),
+    premiumPlan: z.enum(SERVICE_PLAN_KEYS).default('included'),
 });
 const SearchSchema = z.object({
     q: z.string().optional(),
@@ -42,6 +54,7 @@ const SendEmailSchema = z.object({
     to: z.union([z.string().email(), z.array(z.string().email()).min(1).max(10)]),
     subject: z.string().min(1).max(200),
     text: z.string().min(1).max(20_000),
+    fromAddress: z.string().email().optional(),
 });
 const ListEmailSchema = z.object({
     agentId: z.string(),
@@ -91,9 +104,23 @@ const ServicePlanStatusSchema = z.object({
 const PurchaseServicePlanSchema = z.object({
     agentId: z.string().min(1),
     plan: z.enum(['pro', 'enterprise']),
-    interval: z.enum(['monthly', 'yearly']),
-    autoRenew: z.boolean().default(false),
-    prepayPeriods: z.number().int().min(1).max(12).default(1),
+});
+const SetRegistryVisibilitySchema = z.object({
+    agentId: z.string().min(1),
+    registryHidden: z.boolean(),
+});
+const UpdatePrimaryEmailSchema = z.object({
+    agentId: z.string().min(1),
+    username: z
+        .string()
+        .trim()
+        .toLowerCase()
+        .regex(/^[a-z0-9](?:[a-z0-9._+-]{0,62}[a-z0-9])?$/),
+});
+const CreateEmailAliasSchema = UpdatePrimaryEmailSchema;
+const DeleteEmailAliasSchema = z.object({
+    agentId: z.string().min(1),
+    emailAddress: z.string().email(),
 });
 export class AgentDomainActionProvider {
     name = 'agentdomain';
@@ -138,13 +165,13 @@ export class AgentDomainActionProvider {
         return [
             {
                 name: 'register_agent_identity',
-                description: 'Register a complete agent identity bundle on AgentDomain. Domain, DNS, SSL certification, and service fee are mandatory. Set registerBasename/registerEns/emailEnabled false to skip those optional costs. Pays in USDC on Base.',
+                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 mandatory SSL certification fee; optional Basename, ENS, and email only charge when enabled.',
+                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),
             },
@@ -156,7 +183,7 @@ export class AgentDomainActionProvider {
             },
             {
                 name: 'send_agent_email',
-                description: 'Send text-only email from an email-enabled agent via AWS SES.',
+                description: 'Send text-only email from an agent primary email or active alias via AWS SES.',
                 schema: SendEmailSchema,
                 invoke: this.sendEmail.bind(this),
             },
@@ -222,21 +249,45 @@ export class AgentDomainActionProvider {
             },
             {
                 name: 'get_service_plan',
-                description: 'Get the current per-agent service plan, limits, and billing state.',
+                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 AgentDomain Pro or Enterprise using x402 USDC payment.',
+                description: 'Upgrade one agent to an AgentDomain 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.',
+                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.',
+                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.',
+                schema: CreateEmailAliasSchema,
+                invoke: this.createEmailAlias.bind(this),
+            },
+            {
+                name: 'delete_email_alias',
+                description: 'Delete one active email alias from an agent.',
+                schema: DeleteEmailAliasSchema,
+                invoke: this.deleteEmailAlias.bind(this),
+            },
         ];
     }
     async register(walletProvider, args) {
         const { ad, wallet } = this.createAgentDomain(walletProvider);
-        const result = await ad.register({ ...args, wallet });
+        const result = await ad.register({ ...args, emailEnabled: true, wallet });
         let autoRenewMsg = '';
         if (args.autoRenew && this.renewalVaultAddress) {
             try {
@@ -364,20 +415,25 @@ export class AgentDomainActionProvider {
     async getServicePlan(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
         const result = await ad.getServicePlan(args.agentId);
-        return `Service 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.`;
+        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}.`;
     }
     async purchaseServicePlan(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
         const result = await ad.purchaseServicePlan(args);
-        return `Purchased ${result.entitlement.plan} ${args.interval} 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.`;
     }
     async quote(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
         const q = await ad.quote(args);
-        const emailPart = Number(q.emailFeeUsdc) > 0 ? ` + email $${q.emailFeeUsdc}` : '';
         const basenamePart = Number(q.basenameCostUsdc) > 0 ? ` + Basename $${q.basenameCostUsdc}` : '';
         const ensPart = Number(q.ensCostUsdc) > 0 ? ` + ENS $${q.ensCostUsdc}` : '';
-        return `Total: $${q.totalUsdc} USDC (domain $${q.domainCostUsdc} + SSL $${q.sslCertificationFeeUsdc} + service $${q.serviceFeeUsdc}${emailPart}${basenamePart}${ensPart})`;
+        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) {
         const { ad } = this.createAgentDomain(walletProvider);
@@ -390,6 +446,7 @@ export class AgentDomainActionProvider {
         const { ad } = this.createAgentDomain(walletProvider);
         const result = await ad.sendEmail(args.agentId, {
             to: args.to,
+            fromAddress: args.fromAddress,
             subject: args.subject,
             text: args.text,
         });
@@ -400,5 +457,20 @@ export class AgentDomainActionProvider {
         const result = await ad.listEmail(args.agentId, { limit: args.limit });
         return JSON.stringify(result, null, 2);
     }
+    async updatePrimaryEmail(walletProvider, args) {
+        const { ad } = this.createAgentDomain(walletProvider);
+        const result = await ad.updatePrimaryEmail(args.agentId, args.username);
+        return result.message;
+    }
+    async createEmailAlias(walletProvider, args) {
+        const { ad } = this.createAgentDomain(walletProvider);
+        const result = await ad.createEmailAlias(args.agentId, args.username);
+        return `Created email alias ${result.address.emailAddress}.`;
+    }
+    async deleteEmailAlias(walletProvider, args) {
+        const { ad } = this.createAgentDomain(walletProvider);
+        await ad.deleteEmailAlias(args.agentId, args.emailAddress);
+        return `Deleted email alias ${args.emailAddress}.`;
+    }
 }
 export default AgentDomainActionProvider;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentdomain/agentkit-plugin",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Coinbase AgentKit action provider for AgentDomain",
   "license": "MIT",
   "type": "module",
@@ -20,22 +20,21 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "pnpm run build",
-    "typecheck": "tsc --noEmit",
-    "lint": "echo \"no lint\""
-  },
   "dependencies": {
-    "@agentdomain/sdk": "workspace:^",
-    "@agentdomain/shared": "workspace:^",
-    "viem": "^2.21.55",
-    "zod": "^3.24.1"
+    "viem": "^2.55.2",
+    "zod": "^3.24.1",
+    "@agentdomain/sdk": "^0.2.0",
+    "@agentdomain/shared": "^0.2.0"
   },
   "peerDependencies": {
     "@coinbase/agentkit": "^0.1.0"
   },
   "devDependencies": {
     "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "echo \"no lint\""
   }
-}
+}