@agentdomain/eliza-plugin 0.3.0 → 0.4.1

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, primary address update, and Pro/Enterprise aliases
+- Agent email send/list/delete/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
-- Per-agent Premium Plan status and upgrades
+- Per-agent Premium Plan status, upgrades, and exact next-renewal tier selection
 
 Configure `AGENTDOMAIN_API_URL` only if you need a custom endpoint. The default is `https://agentdomain.app/api/v1`.

package/dist/index.d.ts

@@ -70,6 +70,20 @@ export declare const listEmailAction: {
         data: import("@agentdomain/sdk").EmailListResult;
     }>;
 };
+export declare const deleteEmailMessageAction: {
+    name: string;
+    description: string;
+    similes: string[];
+    examples: never[];
+    validate: (runtime: IAgentRuntime) => Promise<boolean>;
+    handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+        text: string;
+        data: {
+            deleted: true;
+            messageId: string;
+        };
+    }>;
+};
 export declare const sendEmailAction: {
     name: string;
     description: string;
@@ -81,6 +95,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;
@@ -236,6 +291,17 @@ export declare const setRegistryVisibilityAction: {
         data: import("@agentdomain/sdk").RegistryVisibilityResult;
     }>;
 };
+export declare const scheduleServicePlanRenewalAction: {
+    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").ServicePlanRenewalResult;
+    }>;
+};
 export declare const purchaseServicePlanAction: {
     name: string;
     description: string;
@@ -305,6 +371,19 @@ export declare const agentDomainPlugin: {
             text: string;
             data: import("@agentdomain/sdk").EmailListResult;
         }>;
+    } | {
+        name: string;
+        description: string;
+        similes: string[];
+        examples: never[];
+        validate: (runtime: IAgentRuntime) => Promise<boolean>;
+        handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+            text: string;
+            data: {
+                deleted: true;
+                messageId: string;
+            };
+        }>;
     } | {
         name: string;
         description: string;
@@ -315,6 +394,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

@@ -41,12 +41,7 @@ const registerSchema = z.object({
     registerBasename: z.boolean().default(true),
     registerEns: z.boolean().default(false),
     emailEnabled: z.boolean().default(true),
-    emailUsername: z
-        .string()
-        .trim()
-        .toLowerCase()
-        .regex(EMAIL_USERNAME_PATTERN)
-        .default('agent'),
+    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'),
@@ -96,12 +91,23 @@ function parseRegistrationPlan(lower) {
         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();
@@ -120,8 +126,7 @@ 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 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;
 }
@@ -250,6 +255,21 @@ export const listEmailAction = {
         return { text: `Found ${result.messages.length} messages.`, data: result };
     },
 };
+export const deleteEmailMessageAction = {
+    name: 'DELETE_AGENT_EMAIL',
+    description: 'Permanently delete one AgentDomain email message.',
+    similes: ['DELETE_EMAIL_MESSAGE', 'REMOVE_EMAIL_MESSAGE'],
+    examples: [],
+    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')) ?? [];
+        if (!ids[0] || !ids[1])
+            throw new Error('Agent ID and message ID UUIDs are required');
+        const result = await ad.deleteEmailMessage(ids[0], ids[1]);
+        return { text: `Deleted email message ${ids[1]}.`, data: result };
+    },
+};
 export const sendEmailAction = {
     name: 'SEND_AGENT_EMAIL',
     description: 'Send text-only email from an AgentDomain primary address or active alias.',
@@ -261,7 +281,57 @@ export const sendEmailAction = {
         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 = {
@@ -282,7 +352,7 @@ export const updatePrimaryEmailAction = {
 };
 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.',
+    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')),
@@ -451,14 +521,14 @@ 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}, 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.',
+    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')),
@@ -478,9 +548,28 @@ export const setRegistryVisibilityAction = {
         };
     },
 };
+export const scheduleServicePlanRenewalAction = {
+    name: 'SCHEDULE_SERVICE_PLAN_RENEWAL',
+    description: 'Choose the exact AgentDomain Premium Plan SKU for the next identity renewal.',
+    similes: ['CHANGE_RENEWAL_PLAN', 'SET_NEXT_RENEWAL_PLAN'],
+    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 lower = message.content.text.toLowerCase();
+        const plan = parseRegistrationPlan(lower);
+        const parsed = plan === 'enterprise' ? parsePlan(lower) : { plan, planSku: plan };
+        const result = await ad.scheduleServicePlanRenewal(agentId, parsed);
+        return {
+            text: `Scheduled ${result.renewalPlanSku} for the next identity renewal.`,
+            data: result,
+        };
+    },
+};
 export const purchaseServicePlanAction = {
     name: 'PURCHASE_SERVICE_PLAN',
-    description: 'Upgrade an agent to AgentDomain Pro or Enterprise Premium Plan using x402 USDC.',
+    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')),
@@ -506,7 +595,11 @@ export const agentDomainPlugin = {
         registerIdentityAction,
         searchAgentsAction,
         sendEmailAction,
+        sendEmailBatchAction,
+        emailUsageAction,
+        configureEmailWebhookAction,
         listEmailAction,
+        deleteEmailMessageAction,
         updatePrimaryEmailAction,
         createEmailAliasAction,
         deleteEmailAliasAction,
@@ -520,6 +613,7 @@ export const agentDomainPlugin = {
         deleteDnsAction,
         servicePlanStatusAction,
         setRegistryVisibilityAction,
+        scheduleServicePlanRenewalAction,
         purchaseServicePlanAction,
     ],
     evaluators: [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentdomain/eliza-plugin",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "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.1",
+    "@agentdomain/shared": "^0.4.0"
   },
   "peerDependencies": {
     "@elizaos/core": "^1.0.0"