@agentdomain/eliza-plugin 0.1.0

package/README.md

@@ -0,0 +1,19 @@
+# @agentdomain/eliza-plugin
+
+ElizaOS plugin for AgentDomain.
+
+```bash
+npm install @agentdomain/eliza-plugin
+```
+
+The plugin gives Eliza agents a complete AgentDomain lifecycle surface:
+
+- Registration quote and x402 registration
+- Registry discovery
+- Agent email send/list
+- DNS management
+- SSL repair/reconfiguration
+- RenewalVault status, funding, and auto-renew
+- Per-agent service-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

@@ -0,0 +1,340 @@
+interface IAgentRuntime {
+    getSetting(key: string): string | undefined;
+    character?: {
+        settings?: {
+            secrets?: Record<string, string>;
+        };
+    };
+}
+interface Memory {
+    content: {
+        text: string;
+    };
+}
+export declare const quoteRegistrationAction: {
+    name: string;
+    description: string;
+    similes: string[];
+    examples: never[];
+    validate: () => Promise<boolean>;
+    handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+        text: string;
+        data: import("@agentdomain/sdk").QuoteResult;
+    }>;
+};
+export declare const registerIdentityAction: {
+    name: string;
+    description: string;
+    similes: string[];
+    examples: ({
+        user: string;
+        content: {
+            text: string;
+            action?: undefined;
+        };
+    } | {
+        user: string;
+        content: {
+            text: string;
+            action: string;
+        };
+    })[][];
+    validate: (runtime: IAgentRuntime, _message?: Memory) => Promise<boolean>;
+    handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+        text: string;
+        data: import("@agentdomain/shared").RegistrationResult;
+    }>;
+};
+export declare const searchAgentsAction: {
+    name: string;
+    description: string;
+    similes: string[];
+    examples: never[];
+    validate: () => Promise<boolean>;
+    handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+        text: string;
+        data: {
+            items: import("@agentdomain/sdk").AgentRow[];
+            total: number;
+        };
+    }>;
+};
+export declare const listEmailAction: {
+    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").EmailListResult;
+    }>;
+};
+export declare const sendEmailAction: {
+    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").EmailResult;
+    }>;
+};
+export declare const renewalStatusAction: {
+    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").RenewalStatus;
+    }>;
+};
+export declare const fundRenewalAction: {
+    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").VaultFundResult;
+    }>;
+};
+export declare const enableAutoRenewAction: {
+    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").AutoRenewResult;
+    }>;
+};
+export declare const reconfigureSslAction: {
+    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").SslReconfigureResult;
+    }>;
+};
+export declare const listDnsAction: {
+    name: string;
+    description: string;
+    similes: string[];
+    examples: never[];
+    validate: (runtime: IAgentRuntime) => Promise<boolean>;
+    handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+        text: string;
+        data: import("@agentdomain/shared").DnsRecord[];
+    }>;
+};
+export declare const createDnsAction: {
+    name: string;
+    description: string;
+    similes: string[];
+    examples: never[];
+    validate: (runtime: IAgentRuntime) => Promise<boolean>;
+    handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+        text: string;
+        data: import("@agentdomain/shared").DnsRecord;
+    }>;
+};
+export declare const updateDnsAction: {
+    name: string;
+    description: string;
+    similes: string[];
+    examples: never[];
+    validate: (runtime: IAgentRuntime) => Promise<boolean>;
+    handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+        text: string;
+        data: import("@agentdomain/shared").DnsRecord;
+    }>;
+};
+export declare const deleteDnsAction: {
+    name: string;
+    description: string;
+    similes: string[];
+    examples: never[];
+    validate: (runtime: IAgentRuntime) => Promise<boolean>;
+    handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+        text: string;
+        data: {
+            success: boolean;
+        };
+    }>;
+};
+export declare const servicePlanStatusAction: {
+    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").ServicePlanStatusResult;
+    }>;
+};
+export declare const purchaseServicePlanAction: {
+    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").ServicePlanPurchaseResult;
+    }>;
+};
+export declare const agentDomainPlugin: {
+    name: string;
+    description: string;
+    actions: ({
+        name: string;
+        description: string;
+        similes: string[];
+        examples: never[];
+        validate: () => Promise<boolean>;
+        handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+            text: string;
+            data: import("@agentdomain/sdk").QuoteResult;
+        }>;
+    } | {
+        name: string;
+        description: string;
+        similes: string[];
+        examples: ({
+            user: string;
+            content: {
+                text: string;
+                action?: undefined;
+            };
+        } | {
+            user: string;
+            content: {
+                text: string;
+                action: string;
+            };
+        })[][];
+        validate: (runtime: IAgentRuntime, _message?: Memory) => Promise<boolean>;
+        handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+            text: string;
+            data: import("@agentdomain/shared").RegistrationResult;
+        }>;
+    } | {
+        name: string;
+        description: string;
+        similes: string[];
+        examples: never[];
+        validate: () => Promise<boolean>;
+        handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+            text: string;
+            data: {
+                items: import("@agentdomain/sdk").AgentRow[];
+                total: number;
+            };
+        }>;
+    } | {
+        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").EmailListResult;
+        }>;
+    } | {
+        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").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").RenewalStatus;
+        }>;
+    } | {
+        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").AutoRenewResult;
+        }>;
+    } | {
+        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").SslReconfigureResult;
+        }>;
+    } | {
+        name: string;
+        description: string;
+        similes: string[];
+        examples: never[];
+        validate: (runtime: IAgentRuntime) => Promise<boolean>;
+        handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+            text: string;
+            data: import("@agentdomain/shared").DnsRecord[];
+        }>;
+    } | {
+        name: string;
+        description: string;
+        similes: string[];
+        examples: never[];
+        validate: (runtime: IAgentRuntime) => Promise<boolean>;
+        handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+            text: string;
+            data: import("@agentdomain/shared").DnsRecord;
+        }>;
+    } | {
+        name: string;
+        description: string;
+        similes: string[];
+        examples: never[];
+        validate: (runtime: IAgentRuntime) => Promise<boolean>;
+        handler: (runtime: IAgentRuntime, message: Memory) => Promise<{
+            text: string;
+            data: {
+                success: boolean;
+            };
+        }>;
+    } | {
+        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").ServicePlanStatusResult;
+        }>;
+    })[];
+    evaluators: never[];
+    providers: never[];
+};
+export default agentDomainPlugin;

package/dist/index.js

@@ -0,0 +1,437 @@
+import { AgentDomain } from '@agentdomain/sdk';
+import { AGENTDOMAIN_API_BASE_URL, SUPPORTED_TLDS } from '@agentdomain/shared/constants';
+import { createPublicClient, createWalletClient, http, } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+import { base, baseSepolia } from 'viem/chains';
+import { z } from 'zod';
+function getClients(runtime, opts = {}) {
+    const apiUrl = runtime.getSetting('AGENTDOMAIN_API_URL') ?? AGENTDOMAIN_API_BASE_URL;
+    const apiKey = runtime.getSetting('AGENTDOMAIN_API_KEY');
+    const pk = runtime.getSetting('AGENT_PRIVATE_KEY');
+    const rpc = runtime.getSetting('BASE_RPC_URL') ?? 'https://mainnet.base.org';
+    const network = runtime.getSetting('AGENTDOMAIN_NETWORK') ?? 'base';
+    const chain = network === 'base-sepolia' ? baseSepolia : base;
+    if (!pk) {
+        if (opts.requireWallet)
+            throw new Error('AGENT_PRIVATE_KEY not set');
+        const ad = new AgentDomain({ apiUrl, apiKey, network });
+        return { ad, account: null, walletClient: null, publicClient: null, network, chain, rpc };
+    }
+    const account = privateKeyToAccount(pk);
+    const walletClient = createWalletClient({ account, chain, transport: http(rpc) });
+    const publicClient = createPublicClient({ chain, transport: http(rpc) });
+    const ad = new AgentDomain({
+        apiUrl,
+        apiKey,
+        network,
+        walletClient: walletClient,
+        publicClient: publicClient,
+    });
+    return { ad, account, walletClient, publicClient, network, chain, rpc };
+}
+const TLD_PATTERN = new RegExp(String.raw `([a-z0-9-]{3,63})\.([a-z]{2,20})\b`, 'i');
+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 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),
+    years: z.number().int().min(1).max(10).default(1),
+    autoRenew: z.boolean().default(false),
+});
+const dnsRecordSchema = z.object({
+    type: z.enum(['A', 'AAAA', 'ALIAS', 'CNAME', 'MX', 'TXT', 'NS', 'SRV']),
+    name: z.string(),
+    value: z.string(),
+    ttl: z.number().int().min(60).max(3600).default(3600),
+    priority: z.number().int().min(0).optional(),
+});
+function parseParamsFromText(text) {
+    const m = text.match(TLD_PATTERN);
+    const lower = text.toLowerCase();
+    const yearsMatch = lower.match(/([1-9]|10)\s*years?/);
+    const noBasename = lower.includes('no basename') ||
+        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,
+        years: yearsMatch ? parseInt(yearsMatch[1], 10) : 1,
+        autoRenew: lower.includes('auto renew') || lower.includes('auto-renew') || lower.includes('autorenew'),
+    };
+}
+function requireAgentId(text) {
+    const agentId = text.match(UUID_PATTERN)?.[0];
+    if (!agentId)
+        throw new Error('Agent ID UUID is required');
+    return agentId;
+}
+function parseAmountUsdc(text) {
+    const amount = text.match(AMOUNT_PATTERN)?.[1];
+    if (!amount)
+        throw new Error('USDC amount is required');
+    return amount;
+}
+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;
+}
+function parseDnsRecord(text) {
+    const lower = text.toLowerCase();
+    const typeMatch = text.match(/\b(A|AAAA|ALIAS|CNAME|MX|TXT|NS|SRV)\b/i);
+    const nameMatch = text.match(/\bname[:=]\s*([^\s]+)/i);
+    const valueMatch = text.match(/\bvalue[:=]\s*([^\s]+)/i);
+    const ttlMatch = text.match(/\bttl[:=]\s*(\d+)/i);
+    const priorityMatch = text.match(/\bpriority[:=]\s*(\d+)/i);
+    const parsed = dnsRecordSchema.parse({
+        type: typeMatch?.[1]?.toUpperCase() ?? (lower.includes('txt') ? 'TXT' : 'A'),
+        name: nameMatch?.[1] ?? '@',
+        value: valueMatch?.[1] ?? text.match(/\b(?:\d{1,3}\.){3}\d{1,3}\b/)?.[0] ?? '',
+        ttl: ttlMatch ? Number(ttlMatch[1]) : 3600,
+        priority: priorityMatch ? Number(priorityMatch[1]) : undefined,
+    });
+    return parsed;
+}
+function parseEmailRequest(text) {
+    const to = text.match(EMAIL_PATTERN)?.[0];
+    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.' };
+}
+export const quoteRegistrationAction = {
+    name: 'QUOTE_AGENT_REGISTRATION',
+    description: 'Quote an AgentDomain registration before paying.',
+    similes: ['PRICE_DOMAIN', 'REGISTRATION_QUOTE', 'QUOTE_IDENTITY'],
+    examples: [],
+    validate: async () => true,
+    handler: async (runtime, message) => {
+        const params = parseParamsFromText(message.content.text);
+        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}.`,
+            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.',
+    similes: ['CLAIM_DOMAIN', 'CREATE_IDENTITY', 'GET_DOMAIN'],
+    examples: [
+        [
+            { user: 'user1', content: { text: 'Register me as helpful-bot.ai with email' } },
+            {
+                user: 'agent',
+                content: {
+                    text: "I'll register helpful-bot.ai with email infrastructure now.",
+                    action: 'REGISTER_IDENTITY',
+                },
+            },
+        ],
+    ],
+    validate: async (runtime, _message) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY')),
+    handler: async (runtime, message) => {
+        const params = parseParamsFromText(message.content.text);
+        const validated = registerSchema.parse(params);
+        const { ad, account, walletClient, chain } = getClients(runtime, { requireWallet: true });
+        if (!account || !walletClient)
+            throw new Error('AGENT_PRIVATE_KEY not set');
+        const result = await ad.register({
+            ...validated,
+            wallet: account.address,
+        });
+        let autoRenewMsg = '';
+        if (validated.autoRenew) {
+            const vaultAddress = runtime.getSetting('RENEWAL_VAULT_ADDRESS');
+            if (vaultAddress) {
+                try {
+                    const txHash = await walletClient.writeContract({
+                        address: vaultAddress,
+                        abi: [
+                            {
+                                type: 'function',
+                                name: 'setAutoRenew',
+                                inputs: [
+                                    { name: 'tokenId', type: 'uint256' },
+                                    { name: 'enabled', type: 'bool' },
+                                ],
+                            },
+                        ],
+                        functionName: 'setAutoRenew',
+                        args: [BigInt(result.nftTokenId), true],
+                        chain,
+                        account,
+                    });
+                    autoRenewMsg = ` Auto-renew enabled via tx ${txHash}.`;
+                }
+                catch (e) {
+                    autoRenewMsg = ` Failed to enable auto-renew automatically: ${String(e)}`;
+                }
+            }
+            else {
+                autoRenewMsg = ' (Requires RENEWAL_VAULT_ADDRESS env var to enable auto-renew on-chain).';
+            }
+        }
+        return {
+            text: `Registered ${result.domain}${result.basename ? ` and ${result.basename}` : ''}. Token #${result.nftTokenId}.${autoRenewMsg}`,
+            data: result,
+        };
+    },
+};
+export const searchAgentsAction = {
+    name: 'SEARCH_AGENTS',
+    description: 'Search the public AgentDomain registry by name, capability, or framework.',
+    similes: ['FIND_AGENT', 'DISCOVER_AGENT'],
+    examples: [],
+    validate: async () => true,
+    handler: async (runtime, message) => {
+        const { ad } = getClients(runtime);
+        const q = message.content.text;
+        const result = await ad.search({ q, limit: 10 });
+        return {
+            text: `Found ${result.items.length} agents.`,
+            data: result,
+        };
+    },
+};
+export const listEmailAction = {
+    name: 'LIST_AGENT_EMAIL',
+    description: 'List text-only email messages and extracted verification codes for an AgentDomain identity.',
+    similes: ['CHECK_EMAIL', 'READ_INBOX'],
+    examples: [],
+    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY')),
+    handler: async (runtime, message) => {
+        const { ad } = getClients(runtime);
+        const agentId = message.content.text.match(/[0-9a-f-]{36}/i)?.[0];
+        if (!agentId)
+            throw new Error('Agent ID UUID is required to list email');
+        const result = await ad.listEmail(agentId, { limit: 20 });
+        return { text: `Found ${result.messages.length} messages.`, data: result };
+    },
+};
+export const sendEmailAction = {
+    name: 'SEND_AGENT_EMAIL',
+    description: 'Send text-only email from an AgentDomain identity.',
+    similes: ['SEND_EMAIL', 'EMAIL_FROM_AGENT'],
+    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 payload = parseEmailRequest(message.content.text);
+        const result = await ad.sendEmail(agentId, payload);
+        return { text: `Email sent: ${result.id}.`, data: result };
+    },
+};
+export const renewalStatusAction = {
+    name: 'GET_RENEWAL_STATUS',
+    description: 'Get RenewalVault balance, shortfall, renewal amount, and auto-renew state.',
+    similes: ['RENEWAL_STATUS', 'CHECK_RENEWAL', 'VAULT_STATUS'],
+    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 status = await ad.getRenewalStatus(agentId);
+        return {
+            text: `Renewal for ${status.domain}: next $${status.nextRenewalAmountUsdc}, balance $${status.vaultBalanceUsdc}, shortfall $${status.shortfallUsdc}, auto-renew ${status.autoRenewEnabled ? 'enabled' : 'off'}.`,
+            data: status,
+        };
+    },
+};
+export const fundRenewalAction = {
+    name: 'FUND_RENEWAL_VAULT',
+    description: 'Deposit USDC into an AgentID renewal vault.',
+    similes: ['DEPOSIT_RENEWAL', 'FUND_VAULT'],
+    examples: [],
+    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY')),
+    handler: async (runtime, message) => {
+        const { ad } = getClients(runtime, { requireWallet: true });
+        const agentId = requireAgentId(message.content.text);
+        const amountUsdc = parseAmountUsdc(message.content.text);
+        const result = await ad.fundRenewalVault(agentId, amountUsdc);
+        return {
+            text: `Deposited $${amountUsdc} USDC into renewal vault for ${result.domain}.`,
+            data: result,
+        };
+    },
+};
+export const enableAutoRenewAction = {
+    name: 'ENABLE_AUTO_RENEW',
+    description: 'Enable on-chain RenewalVault auto-renew for an AgentDomain identity.',
+    similes: ['AUTO_RENEW', 'ENABLE_RENEWAL'],
+    examples: [],
+    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY') && runtime.getSetting('RENEWAL_VAULT_ADDRESS')),
+    handler: async (runtime, message) => {
+        const { ad } = getClients(runtime, { requireWallet: true });
+        const agentId = requireAgentId(message.content.text);
+        const result = await ad.setAutoRenew(agentId, true, {
+            renewalVaultAddress: runtime.getSetting('RENEWAL_VAULT_ADDRESS'),
+        });
+        return { text: `Auto-renew enabled for token #${result.tokenId}.`, data: result };
+    },
+};
+export const reconfigureSslAction = {
+    name: 'RECONFIGURE_SSL',
+    description: 'Rebuild the Cloudflare SaaS SSL hostname and sync Spaceship DNS validation records for an AgentDomain identity.',
+    similes: ['FIX_SSL', 'REPAIR_SSL', 'SYNC_SSL'],
+    examples: [],
+    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY')),
+    handler: async (runtime, message) => {
+        const { ad } = getClients(runtime);
+        const agentId = message.content.text.match(/[0-9a-f-]{36}/i)?.[0];
+        if (!agentId)
+            throw new Error('Agent ID UUID is required to reconfigure SSL');
+        const result = await ad.reconfigureSsl(agentId);
+        return {
+            text: `SSL reconfigured for ${result.domain}. Status: ${result.sslStatus}.`,
+            data: result,
+        };
+    },
+};
+export const listDnsAction = {
+    name: 'LIST_DNS_RECORDS',
+    description: 'List DNS records for an AgentDomain identity.',
+    similes: ['DNS_RECORDS', 'LIST_DNS'],
+    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 records = await ad.listDnsRecords(agentId);
+        return { text: `Found ${records.length} DNS records.`, data: records };
+    },
+};
+export const createDnsAction = {
+    name: 'CREATE_DNS_RECORD',
+    description: 'Create a user-managed DNS record. Use text like: agentId type A name @ value 1.2.3.4.',
+    similes: ['ADD_DNS', 'CREATE_DNS'],
+    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 record = parseDnsRecord(message.content.text);
+        const result = await ad.createDnsRecord(agentId, record);
+        return { text: `Created ${result.type} DNS record ${result.name}.`, data: result };
+    },
+};
+export const updateDnsAction = {
+    name: 'UPDATE_DNS_RECORD',
+    description: 'Update a user-managed DNS record. Include agent UUID and record UUID.',
+    similes: ['EDIT_DNS', 'UPDATE_DNS'],
+    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')) ?? [];
+        const agentId = ids[0];
+        const recordId = ids[1];
+        if (!agentId || !recordId)
+            throw new Error('Agent ID and record ID UUIDs are required');
+        const record = parseDnsRecord(message.content.text);
+        const result = await ad.updateDnsRecord(agentId, recordId, record);
+        return { text: `Updated ${result.type} DNS record ${result.name}.`, data: result };
+    },
+};
+export const deleteDnsAction = {
+    name: 'DELETE_DNS_RECORD',
+    description: 'Delete a user-managed DNS record. Include agent UUID and record UUID.',
+    similes: ['REMOVE_DNS', 'DELETE_DNS'],
+    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')) ?? [];
+        const agentId = ids[0];
+        const recordId = ids[1];
+        if (!agentId || !recordId)
+            throw new Error('Agent ID and record ID UUIDs are required');
+        const result = await ad.deleteDnsRecord(agentId, recordId);
+        return { text: `Deleted DNS record ${recordId}.`, data: result };
+    },
+};
+export const servicePlanStatusAction = {
+    name: 'GET_SERVICE_PLAN',
+    description: 'Get an agent service 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')),
+    handler: async (runtime, message) => {
+        const { ad } = getClients(runtime);
+        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}.`,
+            data: result,
+        };
+    },
+};
+export const purchaseServicePlanAction = {
+    name: 'PURCHASE_SERVICE_PLAN',
+    description: 'Upgrade an agent to AgentDomain Pro or Enterprise using x402 USDC.',
+    similes: ['BUY_PLAN', 'UPGRADE_PLAN'],
+    examples: [],
+    validate: async (runtime) => Boolean(runtime.getSetting('AGENT_PRIVATE_KEY')),
+    handler: async (runtime, message) => {
+        const { ad } = getClients(runtime, { requireWallet: true });
+        const agentId = requireAgentId(message.content.text);
+        const plan = parsePlan(message.content.text);
+        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}.`,
+            data: result,
+        };
+    },
+};
+export const agentDomainPlugin = {
+    name: 'agentdomain',
+    description: 'Identity infrastructure for AI agents on Base (domain + Basename + DNS + email + SSL).',
+    actions: [
+        quoteRegistrationAction,
+        registerIdentityAction,
+        searchAgentsAction,
+        sendEmailAction,
+        listEmailAction,
+        renewalStatusAction,
+        fundRenewalAction,
+        enableAutoRenewAction,
+        reconfigureSslAction,
+        listDnsAction,
+        createDnsAction,
+        updateDnsAction,
+        deleteDnsAction,
+        servicePlanStatusAction,
+        purchaseServicePlanAction,
+    ],
+    evaluators: [],
+    providers: [],
+};
+export default agentDomainPlugin;

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@agentdomain/eliza-plugin",
+  "version": "0.1.0",
+  "description": "ElizaOS plugin for AgentDomain - give your Eliza agent a complete identity stack",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "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"
+  },
+  "peerDependencies": {
+    "@elizaos/core": "^1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  }
+}