@agentdomain/agentkit-plugin 0.5.0 → 0.6.0

package/README.md

@@ -10,10 +10,12 @@ The provider exposes actions for:
 
 - Agent identity registration and quote
 - Registry search
-- Email send/list/delete/batch, monthly usage, signed inbound webhooks, primary address updates, and Starter/Pro/Enterprise aliases
-- DNS list/create/update/delete
+- Email send/list/batch, monthly usage, signed inbound webhooks, primary address updates, and Starter/Pro/Enterprise aliases
+- Typed DNS list/create/update/delete for all 13 Spaceship-supported types, plus capabilities, batch preview/apply, and BIND import/export
 - SSL reconfiguration
 - RenewalVault status, funding, auto-renew, and withdrawal
-- Per-agent Starter, Pro, and exact Enterprise-tier Premium Plan purchase and renewal selection
+- Per-agent Starter, Pro, and Enterprise Premium Plans
 
 Default API base: `https://agentdomain.app/api/v1`.
+
+Request the base URL directly to retrieve AgentDomain's machine-readable API discovery metadata.

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z } from "zod";
 declare const QuoteSchema: z.ZodObject<{
     preferredName: z.ZodString;
     tld: z.ZodDefault<z.ZodEnum<["xyz", "com", "ai", "org", "io", "net", "co", "app"]>>;
@@ -56,6 +56,47 @@ declare const EmailUsageSchema: z.ZodObject<{
 }, {
     agentId: string;
 }>;
+declare const CreateDnsSchema: z.ZodEffects<z.ZodObject<{
+    agentId: z.ZodString;
+    type: z.ZodEnum<["A", "AAAA", "ALIAS", "CAA", "CNAME", "HTTPS", "MX", "NS", "PTR", "SRV", "SVCB", "TLSA", "TXT"]>;
+    name: z.ZodString;
+    value: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    ttl: z.ZodDefault<z.ZodNumber>;
+    priority: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "A" | "AAAA" | "ALIAS" | "CAA" | "CNAME" | "HTTPS" | "MX" | "NS" | "PTR" | "SRV" | "SVCB" | "TLSA" | "TXT";
+    agentId: string;
+    name: string;
+    ttl: number;
+    value?: string | undefined;
+    data?: Record<string, unknown> | undefined;
+    priority?: number | undefined;
+}, {
+    type: "A" | "AAAA" | "ALIAS" | "CAA" | "CNAME" | "HTTPS" | "MX" | "NS" | "PTR" | "SRV" | "SVCB" | "TLSA" | "TXT";
+    agentId: string;
+    name: string;
+    value?: string | undefined;
+    data?: Record<string, unknown> | undefined;
+    ttl?: number | undefined;
+    priority?: number | undefined;
+}>, {
+    type: "A" | "AAAA" | "ALIAS" | "CAA" | "CNAME" | "HTTPS" | "MX" | "NS" | "PTR" | "SRV" | "SVCB" | "TLSA" | "TXT";
+    agentId: string;
+    name: string;
+    ttl: number;
+    value?: string | undefined;
+    data?: Record<string, unknown> | undefined;
+    priority?: number | undefined;
+}, {
+    type: "A" | "AAAA" | "ALIAS" | "CAA" | "CNAME" | "HTTPS" | "MX" | "NS" | "PTR" | "SRV" | "SVCB" | "TLSA" | "TXT";
+    agentId: string;
+    name: string;
+    value?: string | undefined;
+    data?: Record<string, unknown> | undefined;
+    ttl?: number | undefined;
+    priority?: number | undefined;
+}>;
 interface WalletProvider {
     getAddress(): string;
     signTypedData?: (data: unknown) => Promise<string>;
@@ -67,7 +108,7 @@ export interface AgentDomainActionProviderOptions {
     apiKey?: string;
     baseRpcUrl?: string;
     renewalVaultAddress?: string;
-    network?: 'base' | 'base-sepolia';
+    network?: "base" | "base-sepolia";
 }
 export declare class AgentDomainActionProvider {
     readonly name = "agentdomain";
@@ -147,6 +188,51 @@ export declare class AgentDomainActionProvider {
             agentId: string;
         }>;
         invoke: (walletProvider: WalletProvider, args: z.infer<typeof EmailUsageSchema>) => Promise<string>;
+    } | {
+        name: string;
+        description: string;
+        schema: z.ZodEffects<z.ZodObject<{
+            agentId: z.ZodString;
+            type: z.ZodEnum<["A", "AAAA", "ALIAS", "CAA", "CNAME", "HTTPS", "MX", "NS", "PTR", "SRV", "SVCB", "TLSA", "TXT"]>;
+            name: z.ZodString;
+            value: z.ZodOptional<z.ZodString>;
+            data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            ttl: z.ZodDefault<z.ZodNumber>;
+            priority: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            type: "A" | "AAAA" | "ALIAS" | "CAA" | "CNAME" | "HTTPS" | "MX" | "NS" | "PTR" | "SRV" | "SVCB" | "TLSA" | "TXT";
+            agentId: string;
+            name: string;
+            ttl: number;
+            value?: string | undefined;
+            data?: Record<string, unknown> | undefined;
+            priority?: number | undefined;
+        }, {
+            type: "A" | "AAAA" | "ALIAS" | "CAA" | "CNAME" | "HTTPS" | "MX" | "NS" | "PTR" | "SRV" | "SVCB" | "TLSA" | "TXT";
+            agentId: string;
+            name: string;
+            value?: string | undefined;
+            data?: Record<string, unknown> | undefined;
+            ttl?: number | undefined;
+            priority?: number | undefined;
+        }>, {
+            type: "A" | "AAAA" | "ALIAS" | "CAA" | "CNAME" | "HTTPS" | "MX" | "NS" | "PTR" | "SRV" | "SVCB" | "TLSA" | "TXT";
+            agentId: string;
+            name: string;
+            ttl: number;
+            value?: string | undefined;
+            data?: Record<string, unknown> | undefined;
+            priority?: number | undefined;
+        }, {
+            type: "A" | "AAAA" | "ALIAS" | "CAA" | "CNAME" | "HTTPS" | "MX" | "NS" | "PTR" | "SRV" | "SVCB" | "TLSA" | "TXT";
+            agentId: string;
+            name: string;
+            value?: string | undefined;
+            data?: Record<string, unknown> | undefined;
+            ttl?: number | undefined;
+            priority?: number | undefined;
+        }>;
+        invoke: (walletProvider: WalletProvider, args: z.infer<typeof CreateDnsSchema>) => Promise<string>;
     })[];
     private register;
     private renewalStatus;
@@ -154,9 +240,13 @@ export declare class AgentDomainActionProvider {
     private enableAutoRenew;
     private reconfigureSsl;
     private listDns;
+    private getDnsCapabilities;
     private createDns;
     private updateDns;
     private deleteDns;
+    private changeDns;
+    private importDns;
+    private exportDns;
     private withdrawRenewal;
     private getServicePlan;
     private purchaseServicePlan;

package/dist/index.js

@@ -1,11 +1,12 @@
-import { z } from 'zod';
-import { AgentDomain } from '@agentdomain/sdk';
-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';
+import { z } from "zod";
+import { AgentDomain } from "@agentdomain/sdk";
+import { DNS_RECORD_TYPES, dnsRecordSchema, } from "@agentdomain/shared";
+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({
     preferredName: z.string().min(3).max(63),
-    tld: z.enum(SUPPORTED_TLDS).default('xyz'),
+    tld: z.enum(SUPPORTED_TLDS).default("xyz"),
     registerBasename: z.boolean().default(true),
     basenameLabel: z.string().min(3).max(63).optional(),
     registerEns: z.boolean().default(false),
@@ -24,11 +25,11 @@ const RegisterSchema = z.object({
     dnsTarget: z.string().url().optional(),
     years: z.number().int().min(1).max(10).default(1),
     autoRenew: z.boolean().default(false),
-    premiumPlan: z.enum(SERVICE_PLAN_KEYS).default('included'),
+    premiumPlan: z.enum(SERVICE_PLAN_KEYS).default("included"),
 });
 const QuoteSchema = z.object({
     preferredName: z.string(),
-    tld: z.enum(SUPPORTED_TLDS).default('xyz'),
+    tld: z.enum(SUPPORTED_TLDS).default("xyz"),
     registerBasename: z.boolean().default(true),
     basenameLabel: z.string().min(3).max(63).optional(),
     registerEns: z.boolean().default(false),
@@ -41,7 +42,7 @@ const QuoteSchema = z.object({
         .regex(/^[a-z0-9](?:[a-z0-9._+-]{0,62}[a-z0-9])?$/)
         .optional(),
     years: z.number().int().min(1).max(10).default(1),
-    premiumPlan: z.enum(SERVICE_PLAN_KEYS).default('included'),
+    premiumPlan: z.enum(SERVICE_PLAN_KEYS).default("included"),
 });
 const SearchSchema = z.object({
     q: z.string().optional(),
@@ -73,7 +74,7 @@ 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'),
+    payloadMode: z.enum(["metadata", "inline_text"]).default("metadata"),
     enabled: z.boolean().default(true),
 });
 const RenewalStatusSchema = z.object({
@@ -81,7 +82,9 @@ const RenewalStatusSchema = z.object({
 });
 const FundRenewalSchema = z.object({
     agentId: z.string().min(1),
-    amountUsdc: z.string().regex(/^\d+(\.\d{1,6})?$/, 'Use a USDC amount with up to 6 decimals'),
+    amountUsdc: z
+        .string()
+        .regex(/^\d+(\.\d{1,6})?$/, "Use a USDC amount with up to 6 decimals"),
     enableAutoRenew: z.boolean().default(false),
 });
 const EnableAutoRenewSchema = z.object({
@@ -90,36 +93,68 @@ const EnableAutoRenewSchema = z.object({
 const SslReconfigureSchema = z.object({
     agentId: z.string().min(1),
 });
-const DnsRecordTypeSchema = z.enum(['A', 'AAAA', 'ALIAS', 'CNAME', 'MX', 'TXT', 'NS', 'SRV']);
+const DnsRecordTypeSchema = z.enum(DNS_RECORD_TYPES);
 const ListDnsSchema = z.object({
     agentId: z.string().min(1),
 });
-const CreateDnsSchema = z.object({
+const CreateDnsSchema = z
+    .object({
     agentId: z.string().min(1),
     type: DnsRecordTypeSchema,
     name: z.string().min(1).max(253),
-    value: z.string().min(1).max(4096),
+    value: z.string().min(1).max(65_535).optional(),
+    data: z.record(z.unknown()).optional(),
     ttl: z.number().int().min(60).max(3600).default(3600),
-    priority: z.number().int().min(0).optional(),
+    priority: z.number().int().min(0).max(65_535).optional(),
+})
+    .refine((record) => record.value !== undefined || record.data !== undefined, {
+    message: "Provide structured data or the legacy value field",
+    path: ["data"],
 });
-const UpdateDnsSchema = CreateDnsSchema.partial().extend({
+const UpdateDnsSchema = z.object({
     agentId: z.string().min(1),
     recordId: z.string().min(1),
+    type: DnsRecordTypeSchema.optional(),
+    name: z.string().min(1).max(253).optional(),
+    value: z.string().min(1).max(65_535).optional(),
+    data: z.record(z.unknown()).optional(),
+    ttl: z.number().int().min(60).max(3600).optional(),
+    priority: z.number().int().min(0).max(65_535).optional(),
 });
 const DeleteDnsSchema = z.object({
     agentId: z.string().min(1),
     recordId: z.string().min(1),
 });
+const ChangeDnsSchema = z.object({
+    agentId: z.string().min(1),
+    records: z.array(dnsRecordSchema).min(1).max(200),
+    mode: z.enum(["merge", "replace"]).default("merge"),
+    dryRun: z.boolean().default(true),
+    baseRevision: z.string().length(64).optional(),
+});
+const ImportDnsSchema = z.object({
+    agentId: z.string().min(1),
+    zoneFile: z.string().min(1).max(262_144),
+    mode: z.enum(["merge", "replace"]).default("merge"),
+    dryRun: z.boolean().default(true),
+    baseRevision: z.string().length(64).optional(),
+});
+const ExportDnsSchema = z.object({
+    agentId: z.string().min(1),
+    scope: z.enum(["user", "all"]).default("user"),
+});
 const WithdrawRenewalSchema = z.object({
     agentId: z.string().min(1),
-    amountUsdc: z.string().regex(/^\d+(\.\d{1,6})?$/, 'Use a USDC amount with up to 6 decimals'),
+    amountUsdc: z
+        .string()
+        .regex(/^\d+(\.\d{1,6})?$/, "Use a USDC amount with up to 6 decimals"),
 });
 const ServicePlanStatusSchema = z.object({
     agentId: z.string().min(1),
 });
 const PurchaseServicePlanSchema = z.object({
     agentId: z.string().min(1),
-    plan: z.enum(['starter', 'pro', 'enterprise']),
+    plan: z.enum(["starter", "pro", "enterprise"]),
     planSku: z.custom().optional(),
 });
 const SetRegistryVisibilitySchema = z.object({
@@ -128,7 +163,7 @@ const SetRegistryVisibilitySchema = z.object({
 });
 const ScheduleServicePlanRenewalSchema = z.object({
     agentId: z.string().uuid(),
-    plan: z.enum(['included', 'starter', 'pro', 'enterprise']),
+    plan: z.enum(["included", "starter", "pro", "enterprise"]),
     planSku: z.custom(),
 });
 const UpdatePrimaryEmailSchema = z.object({
@@ -145,7 +180,7 @@ const DeleteEmailAliasSchema = z.object({
     emailAddress: z.string().email(),
 });
 export class AgentDomainActionProvider {
-    name = 'agentdomain';
+    name = "agentdomain";
     apiUrl;
     apiKey;
     baseRpcUrl;
@@ -154,14 +189,17 @@ export class AgentDomainActionProvider {
     constructor(opts = {}) {
         this.apiUrl = opts.apiUrl ?? AGENTDOMAIN_API_BASE_URL;
         this.apiKey = opts.apiKey;
-        this.baseRpcUrl = opts.baseRpcUrl ?? 'https://mainnet.base.org';
+        this.baseRpcUrl = opts.baseRpcUrl ?? "https://mainnet.base.org";
         this.renewalVaultAddress = opts.renewalVaultAddress;
-        this.network = opts.network ?? 'base';
+        this.network = opts.network ?? "base";
     }
     createAgentDomain(walletProvider) {
         const wallet = walletProvider.getAddress();
-        const chain = this.network === 'base-sepolia' ? baseSepolia : base;
-        const publicClient = createPublicClient({ chain, transport: http(this.baseRpcUrl) });
+        const chain = this.network === "base-sepolia" ? baseSepolia : base;
+        const publicClient = createPublicClient({
+            chain,
+            transport: http(this.baseRpcUrl),
+        });
         const walletClient = createWalletClient({
             chain,
             transport: http(this.baseRpcUrl),
@@ -186,152 +224,176 @@ export class AgentDomainActionProvider {
     getActions() {
         return [
             {
-                name: 'register_agent_identity',
-                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.',
+                name: "register_agent_identity",
+                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 the annual platform fee with email setup, SSL certification, and AgentID NFT orchestration; Basename and ENS only charge when enabled.',
+                name: "quote_agent_registration",
+                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),
             },
             {
-                name: 'search_agents',
-                description: 'Search the public AgentDomain registry.',
+                name: "search_agents",
+                description: "Search the public AgentDomain registry.",
                 schema: SearchSchema,
                 invoke: this.search.bind(this),
             },
             {
-                name: 'send_agent_email',
-                description: 'Send text-only email from an agent primary email or active alias via AWS SES.',
+                name: "send_agent_email",
+                description: "Send text-only email from an agent primary email or active alias via AWS SES.",
                 schema: SendEmailSchema,
                 invoke: this.sendEmail.bind(this),
             },
             {
-                name: 'list_agent_email',
-                description: 'Query text-only agent email and extracted verification codes.',
+                name: "list_agent_email",
+                description: "Query text-only agent email and extracted verification codes.",
                 schema: ListEmailSchema,
                 invoke: this.listEmail.bind(this),
             },
             {
-                name: 'delete_agent_email',
-                description: 'Permanently delete one email message from an agent inbox.',
+                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.',
+                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.',
+                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.',
+                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.',
+                name: "get_renewal_status",
+                description: "Get exact next renewal amount, shortfall, vault balance, expiry date, and auto-renew state for an AgentDomain identity.",
                 schema: RenewalStatusSchema,
                 invoke: this.renewalStatus.bind(this),
             },
             {
-                name: 'fund_renewal_vault',
-                description: 'Deposit USDC from the connected wallet into one AgentID renewal vault. Anyone can fund; only the AgentID owner can withdraw or enable auto-renew. Call get_renewal_status first and usually deposit the returned shortfall.',
+                name: "fund_renewal_vault",
+                description: "Deposit USDC from the connected wallet into one AgentID renewal vault. Anyone can fund; only the AgentID owner can withdraw or enable auto-renew. Call get_renewal_status first and usually deposit the returned shortfall.",
                 schema: FundRenewalSchema,
                 invoke: this.fundRenewal.bind(this),
             },
             {
-                name: 'enable_auto_renew',
-                description: 'Enable RenewalVault auto-renew. Requires the wallet provider to be the AgentID NFT owner and support sendTransaction.',
+                name: "enable_auto_renew",
+                description: "Enable RenewalVault auto-renew. Requires the wallet provider to be the AgentID NFT owner and support sendTransaction.",
                 schema: EnableAutoRenewSchema,
                 invoke: this.enableAutoRenew.bind(this),
             },
             {
-                name: 'reconfigure_ssl',
-                description: 'Rebuild the Cloudflare SaaS SSL hostname and sync the required Spaceship DNS validation records for an existing agent.',
+                name: "reconfigure_ssl",
+                description: "Rebuild the Cloudflare SaaS SSL hostname and sync the required Spaceship DNS validation records for an existing agent.",
                 schema: SslReconfigureSchema,
                 invoke: this.reconfigureSsl.bind(this),
             },
             {
-                name: 'list_dns_records',
-                description: 'List DNS records for an AgentDomain identity.',
+                name: "get_dns_capabilities",
+                description: "Get machine-readable DNS types, fields, limits, and provider constraints.",
+                schema: ListDnsSchema,
+                invoke: this.getDnsCapabilities.bind(this),
+            },
+            {
+                name: "list_dns_records",
+                description: "List DNS records for an AgentDomain identity.",
                 schema: ListDnsSchema,
                 invoke: this.listDns.bind(this),
             },
             {
-                name: 'create_dns_record',
-                description: 'Create a user-managed DNS record and sync it to the domain provider.',
+                name: "create_dns_record",
+                description: "Create a user-managed DNS record and sync it to the domain provider.",
                 schema: CreateDnsSchema,
                 invoke: this.createDns.bind(this),
             },
             {
-                name: 'update_dns_record',
-                description: 'Update a user-managed DNS record and sync it to the domain provider.',
+                name: "update_dns_record",
+                description: "Update a user-managed DNS record and sync it to the domain provider.",
                 schema: UpdateDnsSchema,
                 invoke: this.updateDns.bind(this),
             },
             {
-                name: 'delete_dns_record',
-                description: 'Delete a user-managed DNS record and sync the domain provider state.',
+                name: "delete_dns_record",
+                description: "Delete a user-managed DNS record and sync the domain provider state.",
                 schema: DeleteDnsSchema,
                 invoke: this.deleteDns.bind(this),
             },
             {
-                name: 'withdraw_renewal_vault',
-                description: 'Withdraw unused USDC from an AgentID renewal vault. Requires the AgentID NFT owner wallet.',
+                name: "change_dns_records",
+                description: "Preview or apply a revision-protected DNS batch in merge or replace mode.",
+                schema: ChangeDnsSchema,
+                invoke: this.changeDns.bind(this),
+            },
+            {
+                name: "import_dns_zone",
+                description: "Preview or apply a validated BIND zone import without deleting system-managed records.",
+                schema: ImportDnsSchema,
+                invoke: this.importDns.bind(this),
+            },
+            {
+                name: "export_dns_zone",
+                description: "Export user or permitted complete DNS state as a BIND zone file.",
+                schema: ExportDnsSchema,
+                invoke: this.exportDns.bind(this),
+            },
+            {
+                name: "withdraw_renewal_vault",
+                description: "Withdraw unused USDC from an AgentID renewal vault. Requires the AgentID NFT owner wallet.",
                 schema: WithdrawRenewalSchema,
                 invoke: this.withdrawRenewal.bind(this),
             },
             {
-                name: 'get_service_plan',
-                description: 'Get the current per-agent Premium Plan, limits, and billing state.',
+                name: "get_service_plan",
+                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 an AgentDomain Starter, Pro, or Enterprise Premium Plan using x402 USDC payment.',
+                name: "purchase_service_plan",
+                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 paid Premium Plan.',
+                name: "set_registry_visibility",
+                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.',
+                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.',
+                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 paid-plan alias capacity.',
+                name: "create_email_alias",
+                description: "Create an extra receive-and-send alias for one agent. Requires available paid-plan alias capacity.",
                 schema: CreateEmailAliasSchema,
                 invoke: this.createEmailAlias.bind(this),
             },
             {
-                name: 'delete_email_alias',
-                description: 'Delete one active email alias from an agent.',
+                name: "delete_email_alias",
+                description: "Delete one active email alias from an agent.",
                 schema: DeleteEmailAliasSchema,
                 invoke: this.deleteEmailAlias.bind(this),
             },
@@ -339,23 +401,27 @@ export class AgentDomainActionProvider {
     }
     async register(walletProvider, args) {
         const { ad, wallet } = this.createAgentDomain(walletProvider);
-        const result = await ad.register({ ...args, emailEnabled: true, wallet });
-        let autoRenewMsg = '';
+        const result = await ad.register({
+            ...args,
+            emailEnabled: true,
+            wallet,
+        });
+        let autoRenewMsg = "";
         if (args.autoRenew && this.renewalVaultAddress) {
             try {
                 if (walletProvider.sendTransaction) {
                     const data = encodeFunctionData({
                         abi: [
                             {
-                                type: 'function',
-                                name: 'setAutoRenew',
+                                type: "function",
+                                name: "setAutoRenew",
                                 inputs: [
-                                    { name: 'tokenId', type: 'uint256' },
-                                    { name: 'enabled', type: 'bool' },
+                                    { name: "tokenId", type: "uint256" },
+                                    { name: "enabled", type: "bool" },
                                 ],
                             },
                         ],
-                        functionName: 'setAutoRenew',
+                        functionName: "setAutoRenew",
                         args: [BigInt(result.nftTokenId), true],
                     });
                     const txHash = await walletProvider.sendTransaction({
@@ -366,7 +432,7 @@ export class AgentDomainActionProvider {
                 }
                 else {
                     autoRenewMsg =
-                        ' (Cannot enable auto-renew because walletProvider lacks sendTransaction).';
+                        " (Cannot enable auto-renew because walletProvider lacks sendTransaction).";
                 }
             }
             catch (e) {
@@ -378,7 +444,7 @@ export class AgentDomainActionProvider {
     async renewalStatus(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
         const status = await ad.getRenewalStatus(args.agentId);
-        return `Renewal status for ${status.domain}: next renewal $${status.nextRenewalAmountUsdc}, vault balance $${status.vaultBalanceUsdc}, shortfall $${status.shortfallUsdc}, expires ${status.expiresAt ?? 'unknown'}, renewable from ${status.renewableFrom ?? 'unknown'}, auto-renew ${status.autoRenewEnabled ? 'enabled' : 'off'}.`;
+        return `Renewal status for ${status.domain}: next renewal $${status.nextRenewalAmountUsdc}, vault balance $${status.vaultBalanceUsdc}, shortfall $${status.shortfallUsdc}, expires ${status.expiresAt ?? "unknown"}, renewable from ${status.renewableFrom ?? "unknown"}, auto-renew ${status.autoRenewEnabled ? "enabled" : "off"}.`;
     }
     async fundRenewal(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
@@ -391,30 +457,31 @@ export class AgentDomainActionProvider {
     }
     async enableAutoRenew(walletProvider, args) {
         if (!this.renewalVaultAddress) {
-            throw new Error('renewalVaultAddress is required to enable auto-renew.');
+            throw new Error("renewalVaultAddress is required to enable auto-renew.");
         }
         if (!walletProvider.sendTransaction) {
-            throw new Error('walletProvider.sendTransaction is required to enable auto-renew.');
+            throw new Error("walletProvider.sendTransaction is required to enable auto-renew.");
         }
         const { ad, wallet } = this.createAgentDomain(walletProvider);
         const status = await ad.getRenewalStatus(args.agentId);
         if (!status.tokenId)
-            throw new Error('AgentID NFT is not minted yet.');
-        if (status.ownerAddress && status.ownerAddress.toLowerCase() !== wallet.toLowerCase()) {
+            throw new Error("AgentID NFT is not minted yet.");
+        if (status.ownerAddress &&
+            status.ownerAddress.toLowerCase() !== wallet.toLowerCase()) {
             throw new Error(`Only the AgentID NFT owner (${status.ownerAddress}) can enable auto-renew.`);
         }
         const data = encodeFunctionData({
             abi: [
                 {
-                    type: 'function',
-                    name: 'setAutoRenew',
+                    type: "function",
+                    name: "setAutoRenew",
                     inputs: [
-                        { name: 'tokenId', type: 'uint256' },
-                        { name: 'enabled', type: 'bool' },
+                        { name: "tokenId", type: "uint256" },
+                        { name: "enabled", type: "bool" },
                     ],
                 },
             ],
-            functionName: 'setAutoRenew',
+            functionName: "setAutoRenew",
             args: [BigInt(status.tokenId), true],
         });
         const txHash = await walletProvider.sendTransaction({
@@ -433,6 +500,10 @@ export class AgentDomainActionProvider {
         const records = await ad.listDnsRecords(args.agentId);
         return JSON.stringify(records, null, 2);
     }
+    async getDnsCapabilities(walletProvider, args) {
+        const { ad } = this.createAgentDomain(walletProvider);
+        return JSON.stringify(await ad.getDnsCapabilities(args.agentId), null, 2);
+    }
     async createDns(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
         const { agentId, ...record } = args;
@@ -450,9 +521,27 @@ export class AgentDomainActionProvider {
         await ad.deleteDnsRecord(args.agentId, args.recordId);
         return `Deleted DNS record ${args.recordId}.`;
     }
+    async changeDns(walletProvider, args) {
+        const { ad } = this.createAgentDomain(walletProvider);
+        const result = args.dryRun
+            ? await ad.previewDnsBatch(args.agentId, args.records, args.mode)
+            : await ad.applyDnsBatch(args.agentId, args.records, requireDnsRevision(args.baseRevision), args.mode);
+        return JSON.stringify(result, null, 2);
+    }
+    async importDns(walletProvider, args) {
+        const { ad } = this.createAgentDomain(walletProvider);
+        const result = args.dryRun
+            ? await ad.previewDnsImport(args.agentId, args.zoneFile, args.mode)
+            : await ad.applyDnsImport(args.agentId, args.zoneFile, requireDnsRevision(args.baseRevision), args.mode);
+        return JSON.stringify(result, null, 2);
+    }
+    async exportDns(walletProvider, args) {
+        const { ad } = this.createAgentDomain(walletProvider);
+        return ad.exportDnsZone(args.agentId, args.scope);
+    }
     async withdrawRenewal(walletProvider, args) {
         if (!walletProvider.sendTransaction) {
-            throw new Error('walletProvider.sendTransaction is required to withdraw vault funds.');
+            throw new Error("walletProvider.sendTransaction is required to withdraw vault funds.");
         }
         const { ad } = this.createAgentDomain(walletProvider);
         const tx = await ad.withdrawFromVault(args.agentId, args.amountUsdc);
@@ -472,12 +561,12 @@ export class AgentDomainActionProvider {
     async purchaseServicePlan(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
         const result = await ad.purchaseServicePlan(args);
-        return `Purchased ${result.entitlement.plan} Premium Plan 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.`;
+        return `${result.domain} is now ${result.registryVisibility.hidden ? "hidden from" : "visible in"} the public registry.`;
     }
     async scheduleServicePlanRenewal(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
@@ -487,11 +576,13 @@ export class AgentDomainActionProvider {
     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 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}`
-            : '';
+            : "";
         return `Total: $${q.totalUsdc} USDC (domain $${q.domainCostUsdc} + platform $${q.platformFeeUsdc ?? q.serviceFeeUsdc}, email and SSL included${basenamePart}${ensPart}${planPart})`;
     }
     async search(walletProvider, args) {
@@ -499,7 +590,7 @@ export class AgentDomainActionProvider {
         const result = await ad.search(args);
         return `Found ${result.total} agents. First ${result.items.length}: ${result.items
             .map((a) => a.domain)
-            .join(', ')}`;
+            .join(", ")}`;
     }
     async sendEmail(walletProvider, args) {
         const { ad } = this.createAgentDomain(walletProvider);
@@ -552,4 +643,9 @@ export class AgentDomainActionProvider {
         return `Deleted email alias ${args.emailAddress}.`;
     }
 }
+function requireDnsRevision(value) {
+    if (!value)
+        throw new Error("Apply requires baseRevision from a fresh DNS dry-run preview.");
+    return value;
+}
 export default AgentDomainActionProvider;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentdomain/agentkit-plugin",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "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/shared": "^0.5.0",
-    "@agentdomain/sdk": "^0.5.0"
+    "@agentdomain/sdk": "^0.6.0",
+    "@agentdomain/shared": "^0.6.0"
   },
   "peerDependencies": {
     "@coinbase/agentkit": "^0.1.0"