@agentdomain/eliza-plugin 0.1.1 → 0.2.0

package/README.md

@@ -10,10 +10,10 @@ The plugin gives Eliza agents a complete AgentDomain lifecycle surface:
 
 - Registration quote and x402 registration
 - Registry discovery
-- Agent email send/list
+- Agent email send/list, primary address update, and Pro/Enterprise aliases
 - DNS management
 - SSL repair/reconfiguration
 - RenewalVault status, funding, and auto-renew
-- Per-agent service-plan status and upgrades
+- Per-agent Premium Plan status and upgrades
 
 Configure `AGENTDOMAIN_API_URL` only if you need a custom endpoint. The default is `https://agentdomain.app/api/v1`.

package/dist/index.d.ts

@@ -81,6 +81,49 @@ export declare const sendEmailAction: {
         data: import("@agentdomain/sdk").EmailResult;
     }>;
 };
+export declare const updatePrimaryEmailAction: {
+    name: string;
+    description: string;
+    similes: string[];
+    examples: never[];
+    validate: (runtime: IAgentRuntime) => Promise<boolean>;
+    handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+        text: string;
+        data: {
+            inbox: unknown;
+            addresses: import("@agentdomain/sdk").EmailAddressSummary[];
+            message: string;
+        };
+    }>;
+};
+export declare const createEmailAliasAction: {
+    name: string;
+    description: string;
+    similes: string[];
+    examples: never[];
+    validate: (runtime: IAgentRuntime) => Promise<boolean>;
+    handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+        text: string;
+        data: {
+            address: import("@agentdomain/sdk").EmailAddressSummary;
+            addresses: import("@agentdomain/sdk").EmailAddressSummary[];
+        };
+    }>;
+};
+export declare const deleteEmailAliasAction: {
+    name: string;
+    description: string;
+    similes: string[];
+    examples: never[];
+    validate: (runtime: IAgentRuntime) => Promise<boolean>;
+    handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+        text: string;
+        data: {
+            deleted: true;
+            addresses: import("@agentdomain/sdk").EmailAddressSummary[];
+        };
+    }>;
+};
 export declare const renewalStatusAction: {
     name: string;
     description: string;
@@ -182,6 +225,17 @@ export declare const servicePlanStatusAction: {
         data: import("@agentdomain/sdk").ServicePlanStatusResult;
     }>;
 };
+export declare const setRegistryVisibilityAction: {
+    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").RegistryVisibilityResult;
+    }>;
+};
 export declare const purchaseServicePlanAction: {
     name: string;
     description: string;
@@ -261,6 +315,46 @@ 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: {
+                inbox: unknown;
+                addresses: import("@agentdomain/sdk").EmailAddressSummary[];
+                message: string;
+            };
+        }>;
+    } | {
+        name: string;
+        description: string;
+        similes: string[];
+        examples: never[];
+        validate: (runtime: IAgentRuntime) => Promise<boolean>;
+        handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+            text: string;
+            data: {
+                address: import("@agentdomain/sdk").EmailAddressSummary;
+                addresses: import("@agentdomain/sdk").EmailAddressSummary[];
+            };
+        }>;
+    } | {
+        name: string;
+        description: string;
+        similes: string[];
+        examples: never[];
+        validate: (runtime: IAgentRuntime) => Promise<boolean>;
+        handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+            text: string;
+            data: {
+                deleted: true;
+                addresses: import("@agentdomain/sdk").EmailAddressSummary[];
+            };
+        }>;
     } | {
         name: string;
         description: string;

package/dist/index.js

@@ -1,5 +1,5 @@
 import { AgentDomain } from '@agentdomain/sdk';
-import { AGENTDOMAIN_API_BASE_URL, SUPPORTED_TLDS } from '@agentdomain/shared/constants';
+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';
@@ -33,14 +33,23 @@ const TLD_PATTERN = new RegExp(String.raw `([a-z0-9-]{3,63})\.([a-z]{2,20})\b`,
 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;
+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'),
     registerBasename: z.boolean().default(true),
     registerEns: z.boolean().default(false),
-    emailEnabled: z.boolean().default(false),
+    emailEnabled: z.boolean().default(true),
+    emailUsername: z
+        .string()
+        .trim()
+        .toLowerCase()
+        .regex(EMAIL_USERNAME_PATTERN)
+        .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'),
 });
 const dnsRecordSchema = z.object({
     type: z.enum(['A', 'AAAA', 'ALIAS', 'CNAME', 'MX', 'TXT', 'NS', 'SRV']),
@@ -57,19 +66,17 @@ function parseParamsFromText(text) {
         lower.includes('without basename') ||
         lower.includes('skip basename');
     const noEns = lower.includes('no ens') || lower.includes('without ens') || lower.includes('skip ens');
-    const noEmail = lower.includes('no email') ||
-        lower.includes('without email') ||
-        lower.includes('skip email') ||
-        lower.includes('no inbox');
     const wantsEns = /\bens\b/.test(lower);
     return {
         preferredName: m?.[1]?.toLowerCase() ?? 'agent',
         tld: m?.[2]?.toLowerCase() ?? 'xyz',
         registerBasename: !noBasename,
         registerEns: wantsEns && !noEns,
-        emailEnabled: (lower.includes('email') || lower.includes('inbox')) && !noEmail,
+        emailEnabled: true,
+        emailUsername: parseEmailUsername(text) ?? 'agent',
         years: yearsMatch ? parseInt(yearsMatch[1], 10) : 1,
         autoRenew: lower.includes('auto renew') || lower.includes('auto-renew') || lower.includes('autorenew'),
+        premiumPlan: parseRegistrationPlan(lower),
     };
 }
 function requireAgentId(text) {
@@ -84,15 +91,17 @@ function parseAmountUsdc(text) {
         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';
+}
 function parsePlan(text) {
     const lower = text.toLowerCase();
     const plan = lower.includes('enterprise') ? 'enterprise' : 'pro';
-    const interval = lower.includes('year') || lower.includes('annual') ? 'yearly' : 'monthly';
-    return { plan, interval };
-}
-function parsePrepayPeriods(text) {
-    const match = text.match(/\bprepay\s+([1-9]|1[0-2])\s*(?:periods?|months?|years?)?/i);
-    return match ? Number(match[1]) : 1;
+    return { plan };
 }
 function parseDnsRecord(text) {
     const lower = text.toLowerCase();
@@ -110,14 +119,23 @@ function parseDnsRecord(text) {
     });
     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 username = explicit?.trim().toLowerCase();
+    return username && EMAIL_USERNAME_PATTERN.test(username) ? username : null;
+}
 function parseEmailRequest(text) {
-    const to = text.match(EMAIL_PATTERN)?.[0];
+    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());
     if (!to)
         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, subject, text: body || 'Hello from AgentDomain.' };
+    return { to, fromAddress, subject, text: body || 'Hello from AgentDomain.' };
 }
 export const quoteRegistrationAction = {
     name: 'QUOTE_AGENT_REGISTRATION',
@@ -130,22 +148,22 @@ export const quoteRegistrationAction = {
         const { ad } = getClients(runtime);
         const quote = await ad.quote(params);
         return {
-            text: `Total: $${quote.totalUsdc} USDC for ${quote.domain}. Domain $${quote.domainCostUsdc}, SSL $${quote.sslCertificationFeeUsdc}, service $${quote.serviceFeeUsdc}.`,
+            text: `Total: $${quote.totalUsdc} USDC for ${quote.domain}. Domain $${quote.domainCostUsdc}, platform $${quote.platformFeeUsdc ?? quote.serviceFeeUsdc}; email and SSL are included.`,
             data: quote,
         };
     },
 };
 export const registerIdentityAction = {
     name: 'REGISTER_IDENTITY',
-    description: 'Register a complete agent identity bundle on AgentDomain. Domain, DNS, SSL certification, and service fee are mandatory. Users can say "no basename" to skip Basename, "with ENS" to add ENS, and "with email" to add email.',
+    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'],
     examples: [
         [
-            { user: 'user1', content: { text: 'Register me as helpful-bot.ai with email' } },
+            { user: 'user1', content: { text: 'Register me as helpful-bot.ai email username support' } },
             {
                 user: 'agent',
                 content: {
-                    text: "I'll register helpful-bot.ai with email infrastructure now.",
+                    text: "I'll register helpful-bot.ai with included email and SSL infrastructure now.",
                     action: 'REGISTER_IDENTITY',
                 },
             },
@@ -160,6 +178,7 @@ export const registerIdentityAction = {
             throw new Error('AGENT_PRIVATE_KEY not set');
         const result = await ad.register({
             ...validated,
+            emailEnabled: true,
             wallet: account.address,
         });
         let autoRenewMsg = '';
@@ -233,7 +252,7 @@ export const listEmailAction = {
 };
 export const sendEmailAction = {
     name: 'SEND_AGENT_EMAIL',
-    description: 'Send text-only email from an AgentDomain identity.',
+    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')),
@@ -245,6 +264,54 @@ export const sendEmailAction = {
         return { text: `Email sent: ${result.id}.`, 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'],
+    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 username = parseEmailUsername(message.content.text);
+        if (!username)
+            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'],
+    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 username = parseEmailUsername(message.content.text);
+        if (!username)
+            throw new Error('Alias username is required');
+        const result = await ad.createEmailAlias(agentId, username);
+        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'],
+    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 emailAddress = message.content.text.match(EMAIL_PATTERN)?.[0];
+        if (!emailAddress)
+            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.',
@@ -375,7 +442,7 @@ export const deleteDnsAction = {
 };
 export const servicePlanStatusAction = {
     name: 'GET_SERVICE_PLAN',
-    description: 'Get an agent service plan, limits, current period, and billing state.',
+    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')),
@@ -384,14 +451,36 @@ export const servicePlanStatusAction = {
         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}.`,
+            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}.`,
+            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'],
+    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 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 result = await ad.setRegistryVisibility(agentId, registryHidden);
+        return {
+            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 using x402 USDC.',
+    description: 'Upgrade an agent to AgentDomain Pro or Enterprise Premium Plan using x402 USDC.',
     similes: ['BUY_PLAN', 'UPGRADE_PLAN'],
     examples: [],
     validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY')),
@@ -402,11 +491,9 @@ export const purchaseServicePlanAction = {
         const result = await ad.purchaseServicePlan({
             agentId,
             ...plan,
-            autoRenew: message.content.text.toLowerCase().includes('auto'),
-            prepayPeriods: parsePrepayPeriods(message.content.text),
         });
         return {
-            text: `Purchased ${result.entitlement.plan} ${plan.interval} for ${result.domain}.`,
+            text: `Purchased ${result.entitlement.plan} Premium Plan for ${result.domain}.`,
             data: result,
         };
     },
@@ -420,6 +507,9 @@ export const agentDomainPlugin = {
         searchAgentsAction,
         sendEmailAction,
         listEmailAction,
+        updatePrimaryEmailAction,
+        createEmailAliasAction,
+        deleteEmailAliasAction,
         renewalStatusAction,
         fundRenewalAction,
         enableAutoRenewAction,
@@ -429,6 +519,7 @@ export const agentDomainPlugin = {
         updateDnsAction,
         deleteDnsAction,
         servicePlanStatusAction,
+        setRegistryVisibilityAction,
         purchaseServicePlanAction,
     ],
     evaluators: [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentdomain/eliza-plugin",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "ElizaOS plugin for AgentDomain - give your Eliza agent a complete identity stack",
   "license": "MIT",
   "type": "module",
@@ -21,10 +21,10 @@
     "access": "public"
   },
   "dependencies": {
-    "viem": "^2.21.55",
+    "viem": "^2.55.2",
     "zod": "^3.24.1",
-    "@agentdomain/sdk": "^0.1.1",
-    "@agentdomain/shared": "^0.1.1"
+    "@agentdomain/sdk": "^0.2.0",
+    "@agentdomain/shared": "^0.2.0"
   },
   "peerDependencies": {
     "@elizaos/core": "^1.0.0"