domani 1.0.3 → 1.0.5

package/dist/index.d.ts

@@ -18,7 +18,7 @@ export interface Error {
     /** Human-readable error message */
     error: string;
     /** Machine-readable error code */
-    code: "MISSING_API_KEY" | "INVALID_API_KEY" | "EXPIRED_API_KEY" | "MISSING_PARAMETER" | "INVALID_DOMAIN" | "PAYMENT_REQUIRED" | "DOMAIN_UNAVAILABLE" | "RATE_LIMIT_EXCEEDED" | "USER_EXISTS" | "NOT_FOUND" | "UNKNOWN_PROVIDER" | "UNKNOWN_METHOD" | "TARGET_REQUIRED" | "INVALID_PARAMETER" | "CONTACT_REQUIRED" | "INVALID_CONTACT" | "INSUFFICIENT_SCOPE" | "SCOPE_ESCALATION" | "DOMAIN_EXISTS" | "DOMAIN_NOT_ACTIVE" | "UNSUPPORTED_TLD" | "NOT_AVAILABLE" | "ALREADY_REGISTERED" | "TRANSFER_NOT_ELIGIBLE" | "ALREADY_LISTED" | "LISTING_SOLD" | "SELF_PURCHASE" | "DESCRIPTION_TOO_LONG" | "DEAL_NOT_FOUND" | "INVALID_DEAL_STATE" | "EPP_ATTEMPTS_EXCEEDED" | "ACTIVE_DEAL_EXISTS" | "AGENT_IDENTITY_NOT_FOUND" | "AGENT_IDENTITY_ESCALATION" | "CREDENTIAL_REVOKE_FAILED" | "INVALID_IDEMPOTENCY_KEY" | "IDEMPOTENCY_KEY_MISMATCH" | "IDEMPOTENCY_KEY_REUSED" | "OPERATION_IN_PROGRESS" | "OPERATION_SUPERSEDED" | "INVALID_OPERATION_RECEIPT" | "WORKSPACE_ADMIN_REQUIRED" | "PRINCIPAL_NOT_IN_WORKSPACE" | "MAILBOX_NOT_IN_WORKSPACE" | "GROUP_NOT_IN_WORKSPACE" | "COLLECTION_NOT_IN_WORKSPACE" | "ACCESS_VERSION_CONFLICT" | "ACCESS_OFFER_INVALID" | "ACCESS_OFFER_EMAIL_MISMATCH";
+    code: "MISSING_API_KEY" | "INVALID_API_KEY" | "EXPIRED_API_KEY" | "MISSING_PARAMETER" | "INVALID_DOMAIN" | "PAYMENT_REQUIRED" | "DOMAIN_UNAVAILABLE" | "RATE_LIMIT_EXCEEDED" | "USER_EXISTS" | "NOT_FOUND" | "UNKNOWN_PROVIDER" | "UNKNOWN_METHOD" | "TARGET_REQUIRED" | "INVALID_PARAMETER" | "CONTACT_REQUIRED" | "INVALID_CONTACT" | "INSUFFICIENT_SCOPE" | "SCOPE_ESCALATION" | "DOMAIN_EXISTS" | "DOMAIN_NOT_ACTIVE" | "UNSUPPORTED_TLD" | "NOT_AVAILABLE" | "ALREADY_REGISTERED" | "TRANSFER_NOT_ELIGIBLE" | "ALREADY_LISTED" | "LISTING_SOLD" | "SELF_PURCHASE" | "DESCRIPTION_TOO_LONG" | "DEAL_NOT_FOUND" | "INVALID_DEAL_STATE" | "EPP_ATTEMPTS_EXCEEDED" | "ACTIVE_DEAL_EXISTS" | "AGENT_IDENTITY_NOT_FOUND" | "AGENT_IDENTITY_ESCALATION" | "CREDENTIAL_REVOKE_FAILED" | "INVALID_IDEMPOTENCY_KEY" | "IDEMPOTENCY_KEY_MISMATCH" | "IDEMPOTENCY_KEY_REUSED" | "OPERATION_IN_PROGRESS" | "OPERATION_SUPERSEDED" | "INVALID_OPERATION_RECEIPT" | "WORKSPACE_ADMIN_REQUIRED" | "PRINCIPAL_NOT_IN_WORKSPACE" | "MAILBOX_NOT_IN_WORKSPACE" | "GROUP_NOT_IN_WORKSPACE" | "COLLECTION_NOT_IN_WORKSPACE" | "ACCESS_VERSION_CONFLICT" | "ACCESS_OFFER_INVALID" | "ACCESS_OFFER_EMAIL_MISMATCH" | "MAIL_DOMAIN_CAPACITY_EXHAUSTED" | "MAIL_PROVIDER_ERROR";
     /** Actionable recovery guidance for the caller */
     hint?: string;
     /** CLI command to resolve the error (e.g. 'domani login', 'domani billing'). Present in CLI --json output. */
@@ -31,6 +31,8 @@ export interface Error {
     fix_url?: string;
     /** Seconds until retry is allowed (present on 429 responses) */
     retry_after?: number;
+    /** Whether retrying after the external condition changes is safe */
+    retryable?: boolean;
 }
 export interface SearchResult {
     /** Whether the domain is available for registration */
@@ -121,6 +123,23 @@ export interface DomainRecord {
     /** Number of mailboxes configured for this domain */
     mailboxCount: number;
 }
+export interface ProvisionAgentResult {
+    domain: string;
+    domain_status: "registered" | "owned";
+    mailbox: {
+        address: string;
+        status: "created" | "existing";
+    } | null;
+    webhook: {
+        id: string;
+        url: string;
+        secret?: string;
+        header_names: string[];
+    } | null;
+    warnings: string[];
+    hint: string;
+    next_steps: string[];
+}
 export interface MailRule {
     id?: string;
     /** Lower runs first */
@@ -381,8 +400,67 @@ export interface DomainBrief {
     depth: "instant" | "deep";
     status: "ready" | "degraded" | "failed";
     summary: string;
-    registration: Record<string, unknown>;
-    website: Record<string, unknown>;
+    registration: {
+        state: "available" | "registered" | "reserved" | "unknown";
+        registrar: string | null;
+        createdAt: string | null;
+        expiresAt: string | null;
+        daysUntilExpiry: number | null;
+    };
+    website: {
+        state: "active_business" | "active_noncommercial" | "parked_for_sale" | "parked" | "redirected" | "dormant" | "holding_page" | "protected" | "unreachable" | "unknown";
+        title: string | null;
+        description: string | null;
+        finalUrl: string | null;
+        favicon: string | null;
+        canonicalUrl: string | null;
+    };
+    /** Public identity inferred from the current site. Associated operators do not imply registration ownership. */
+    identity: {
+        name: string | null;
+        legalName: string | null;
+        pitch: string | null;
+        category: string | null;
+        audience: string | null;
+        language: string | null;
+        logo: string | null;
+        entities: ({
+            name: string;
+            legalName: string | null;
+            type: "company" | "brand" | "organization" | "public_person" | "unknown";
+            relationship: "presented_brand" | "current_operator" | "redirect_destination" | "historical_operator" | "registrant";
+            confidence: "high" | "medium" | "low";
+            website: string | null;
+            sameAs: string[];
+            evidenceIds: string[];
+        })[];
+    };
+    activity: {
+        state: "active" | "operational" | "dormant" | "inactive" | "unknown";
+        rationale: string;
+        observedAt: string;
+        evidenceIds: string[];
+    };
+    history: {
+        registeredAt: string | null;
+        registrationUpdatedAt: string | null;
+        firstArchiveAt: string | null;
+        latestArchiveAt: string | null;
+        currentIdentityFirstSeenAt: string | null;
+        snapshots: ({
+            capturedAt: string;
+            url: string;
+            title: string | null;
+            description: string | null;
+            evidenceIds: string[];
+        })[];
+        changes: ({
+            detectedAt: string;
+            type: "identity" | "content" | "redirect" | "registration";
+            summary: string;
+            evidenceIds: string[];
+        })[];
+    };
     infrastructure: {
         nameservers: string[];
         mailProviders: string[];
@@ -400,7 +478,12 @@ export interface DomainBrief {
             bimi: boolean | null;
         };
     };
-    market: Record<string, unknown>;
+    market: {
+        listed: boolean;
+        marketplace: string | null;
+        listingUrl: string | null;
+        askingPriceUsd: number | null;
+    };
     /** Redacted contact-channel metadata. Raw addresses are never returned. */
     contactability: {
         state: "direct" | "indirect" | "none_found" | "unknown";
@@ -416,13 +499,28 @@ export interface DomainBrief {
         action: "register" | "buy_now" | "negotiate_listing" | "private_broker" | "backorder" | "watch" | "choose_alternative";
         rationale: string;
     };
+    /** Legacy aggregate. Use coverage instead. */
     completeness: number;
+    /** Evidence coverage, separate from confidence and freshness. */
+    coverage: {
+        score: number;
+        sections: {
+            registration: "complete" | "partial" | "missing";
+            currentUse: "complete" | "partial" | "missing";
+            identity: "complete" | "partial" | "missing";
+            infrastructure: "complete" | "partial" | "missing";
+            history: "complete" | "partial" | "missing";
+            market: "complete" | "partial" | "missing";
+        };
+        missing: string[];
+    };
     analyzedAt: string;
     staleAt: string;
     analysisVersion: string;
     evidence: ({
         id: string;
-        kind: string;
+        kind: "registry" | "dns" | "website" | "content" | "archive" | "entity" | "market" | "contact";
+        claimKey: string;
         label: string;
         value: string;
         source: string;
@@ -435,6 +533,16 @@ export interface DomainBrief {
     createdAt: string;
     updatedAt: string;
 }
+export interface PublicDomainProfile {
+    domain: string;
+    canonicalPath: string;
+    brief: DomainBrief;
+    freshness: "fresh" | "stale";
+    qualityScore: number;
+    /** True only for fresh, deep, substantive profiles with sufficient public evidence. */
+    indexable: boolean;
+    indexabilityReasons: ("needs_deep_analysis" | "analysis_not_ready" | "stale_analysis" | "insufficient_coverage" | "insufficient_public_evidence" | "thin_domain_identity")[];
+}
 export interface Backorder {
     id?: string;
     domain?: string;
@@ -626,8 +734,15 @@ export interface RegistrantContact {
 export interface AccountInfo {
     id: string;
     email: string;
+    /** Active personal Domani plan key */
+    plan: string;
+    /** Distinct active Mailzero plan keys on workspaces the user can access */
+    workspace_plans: string[];
     /** Whether the user has a card on file (required before buying domains) */
     has_payment_method: boolean;
+    preferred_payment_method: "card" | "usdc" | null;
+    /** Locale used by Domani interfaces and transactional communications */
+    preferred_locale: "en" | "fr" | "es" | "pt-BR" | "ja" | "zh-Hans" | "it";
     /** Whether the user has set WHOIS contact info (required before purchasing domains) */
     has_contact: boolean;
     /** Registrant contact info (null if not set) */
@@ -645,7 +760,7 @@ export interface AccountInfo {
     created_at: string;
 }
 export interface ActivationProjection {
-    version: 1;
+    version: 2;
     account_created_at: string;
     entry: {
         brand: string;
@@ -658,6 +773,7 @@ export interface ActivationProjection {
         first_message_received_at: string | null;
         custom_domain_activated_at: string | null;
         programmatic_action_completed_at: string | null;
+        first_webhook_delivery_succeeded_at: string | null;
     };
     status: "first_run" | "setup_active" | "mail_active" | "mail_loop_complete" | "domain_active" | "programmatic_active" | "multi_surface_active";
     recommended_actions: ({
@@ -997,6 +1113,7 @@ export declare class Domani {
         collaboration_enabled: boolean;
         message_count: number;
         webhook_url: string | null;
+        header_names: string[];
         forward_to: string | null;
         signing_secret?: string | null;
         created_at: string;
@@ -1012,19 +1129,36 @@ export declare class Domani {
     }): Promise<{
         id: string;
         address: string;
-        name: string | null;
-        domain: string;
-        slug: string;
+        name?: string | null;
+        domain?: string;
+        slug?: string;
         kind: string;
         workspace_id: string | null;
-        access_role: "viewer" | "responder" | "manager";
-        effective_capabilities: MailboxEffectiveCapabilities;
-        collaboration_enabled: boolean;
-        message_count: number;
-        webhook_url: string | null;
-        forward_to: string | null;
+        access_role?: "viewer" | "responder" | "manager";
+        effective_capabilities?: MailboxEffectiveCapabilities;
+        collaboration_enabled?: boolean;
+        message_count?: number;
+        webhook_url?: string | null;
+        header_names?: string[];
+        forward_to?: string | null;
         signing_secret?: string | null;
-        created_at: string;
+        host_id?: string;
+        dns_records?: DnsRecord[];
+        dns_status?: "published" | "manual";
+        receiving_status?: "pending";
+        sending_status?: "pending" | "unavailable";
+        sending_error?: {
+            code?: "MAIL_DOMAIN_CAPACITY_EXHAUSTED" | "MAIL_PROVIDER_ERROR";
+            retryable?: boolean;
+        };
+        client_settings?: Record<string, unknown>;
+        credential?: {
+            id?: string;
+            label?: string;
+            password?: string;
+        };
+        storage_quota_bytes?: number;
+        created_at?: string;
         hint: string;
     }>;
     /** Create an app password (hosted) (POST /api/emails/{address}/credentials) */
@@ -1065,12 +1199,14 @@ export declare class Domani {
     createWebhook(body: {
         url: string;
         events: string[];
+        headers?: Record<string, unknown>;
     }): Promise<{
         id?: string;
         url?: string;
         events?: string[];
         secret?: string;
         active?: boolean;
+        header_names?: string[];
         created_at?: string;
         hint?: string;
     }>;
@@ -1243,9 +1379,14 @@ export declare class Domani {
     /** Check email DNS status (GET /api/domains/{domain}/email/status) */
     getDomainEmailStatus(domain: string): Promise<{
         domain?: string;
+        enabled?: boolean;
         verified?: boolean;
+        receiving_verified?: boolean;
+        sending_configured?: boolean;
+        sending_verified?: boolean;
         records?: DnsRecord[];
         mailbox_count?: number;
+        hint?: string;
     }>;
     /** Get detailed information about a domain you own (GET /api/domains/{domain}) */
     getDomainInfo(domain: string): Promise<DomainDetail>;
@@ -1374,6 +1515,7 @@ export declare class Domani {
         webhook_url?: string | null;
         signing_secret?: string | null;
         has_webhook?: boolean;
+        header_names?: string[];
         hint?: string;
     }>;
     /** Get a message (GET /api/emails/{address}/messages/{id}) */
@@ -1456,6 +1598,10 @@ export declare class Domani {
         details_submitted?: boolean;
         balance_cents?: number;
     }>;
+    /** Get a public domain profile (GET /api/domains/{domain}/profile) */
+    getPublicDomainProfile(domain: string): Promise<{
+        profile: PublicDomainProfile;
+    }>;
     /** Get referral earnings and history (GET /api/referrals) */
     getReferrals(): Promise<{
         referral_code?: string;
@@ -1770,6 +1916,7 @@ export declare class Domani {
             domain?: string;
             message_count?: number;
             webhook_url?: string | null;
+            header_names?: string[];
             forward_to?: string | null;
             workspace_id?: string | null;
             access_role?: "viewer" | "responder" | "manager";
@@ -1881,6 +2028,7 @@ export declare class Domani {
             id?: string;
             url?: string;
             events?: string[];
+            header_names?: string[];
             active?: boolean;
             created_at?: string;
         }[];
@@ -1985,12 +2133,16 @@ export declare class Domani {
         slug?: string;
         name?: string;
         webhook_url?: string;
+        webhook_headers?: {
+            Authorization?: string;
+            "X-API-Key"?: string;
+        };
         webhook_events?: string[];
         payment_method?: "card" | "usdc" | "balance";
         payment_tx?: string;
         payment_chain?: "base" | "ethereum";
         years?: number;
-    }): Promise<unknown>;
+    }): Promise<ProvisionAgentResult>;
     /** Refresh a domain brief from live sources (POST /api/domain-briefs/{id}/refresh) */
     refreshDomainBrief(id: string): Promise<{
         brief: DomainBrief;
@@ -2043,6 +2195,7 @@ export declare class Domani {
         webhook_url?: string | null;
         signing_secret?: string | null;
         has_webhook?: boolean;
+        header_names?: string[];
         hint?: string;
     }>;
     /** Remove an inbound mail rule (DELETE /api/emails/{address}/rules/{ruleId}) */
@@ -2115,6 +2268,12 @@ export declare class Domani {
     requestWorkspaceOwnershipTransfer(id: string, body: {
         membership_id: string;
     }): Promise<unknown>;
+    /** Research or refresh a public domain profile (POST /api/domains/{domain}/profile) */
+    researchPublicDomainProfile(domain: string, query?: {
+        depth?: "instant" | "deep";
+    }): Promise<{
+        profile: PublicDomainProfile;
+    }>;
     /** Resend contact email verification (POST /api/me/resend-verification) */
     resendEmailVerification(body?: {
         email?: string;
@@ -2291,11 +2450,13 @@ export declare class Domani {
     /** Set mailbox webhook (PUT /api/emails/{address}/webhook) */
     setMailboxWebhook(address: string, body: {
         url: string;
+        headers?: Record<string, unknown>;
     }): Promise<{
         address?: string;
         webhook_url?: string;
         signing_secret?: string;
         has_webhook?: boolean;
+        header_names?: string[];
         hint?: string;
     }>;
     /** Set nameservers for a domain (PUT /api/domains/{domain}/nameservers) */
@@ -2322,6 +2483,9 @@ export declare class Domani {
         domain?: string;
         status?: "configured" | "already_configured";
         verified_at?: string | null;
+        receiving_verified?: boolean;
+        sending_configured?: boolean;
+        sending_verified?: boolean;
         records?: DnsRecord[];
         hint?: string;
     }>;
@@ -2408,9 +2572,11 @@ export declare class Domani {
     }): Promise<unknown>;
     /** Update account preferences (PUT /api/me) */
     updateAccount(body: {
-        preferred_payment_method: "card" | "usdc" | null;
+        preferred_payment_method?: "card" | "usdc" | null;
+        preferred_locale?: "en" | "fr" | "es" | "pt-BR" | "ja" | "zh-Hans" | "it";
     }): Promise<{
         preferred_payment_method?: string | null;
+        preferred_locale?: "en" | "fr" | "es" | "pt-BR" | "ja" | "zh-Hans" | "it";
         hint?: string;
     }>;
     /** Dismiss or restore first-run guidance (PUT /api/me/activation) */
@@ -2523,11 +2689,13 @@ export declare class Domani {
         url?: string;
         events?: string[];
         active?: boolean;
+        headers?: Record<string, unknown>;
     }): Promise<{
         id?: string;
         url?: string;
         events?: string[];
         active?: boolean;
+        header_names?: string[];
         hint?: string;
     }>;
     /** Rename a workspace (PATCH /api/workspaces/{id}) */

package/dist/index.js

@@ -372,6 +372,10 @@ class Domani {
     getPayoutStatus() {
         return this.request("GET", `/api/billing/connect`, undefined);
     }
+    /** Get a public domain profile (GET /api/domains/{domain}/profile) */
+    getPublicDomainProfile(domain) {
+        return this.request("GET", `/api/domains/${enc(domain)}/profile`, undefined);
+    }
     /** Get referral earnings and history (GET /api/referrals) */
     getReferrals() {
         return this.request("GET", `/api/referrals`, undefined);
@@ -628,6 +632,10 @@ class Domani {
     requestWorkspaceOwnershipTransfer(id, body) {
         return this.request("POST", `/api/workspaces/${enc(id)}/ownership-transfer`, { body });
     }
+    /** Research or refresh a public domain profile (POST /api/domains/{domain}/profile) */
+    researchPublicDomainProfile(domain, query) {
+        return this.request("POST", `/api/domains/${enc(domain)}/profile`, { query });
+    }
     /** Resend contact email verification (POST /api/me/resend-verification) */
     resendEmailVerification(body) {
         return this.request("POST", `/api/me/resend-verification`, { body });

package/package.json

@@ -1,23 +1,13 @@
 {
   "name": "domani",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Official TypeScript SDK for the domani API - domains, email, and identity for AI agents.",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./src/index.ts",
-      "default": "./src/index.ts"
-    }
-  },
-  "publishConfig": {
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "exports": {
-      ".": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      }
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     }
   },
   "files": [
@@ -26,7 +16,9 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "check": "tsc --noEmit",
+    "prepare": "npm run build",
     "test": "vitest run",
+    "test:package": "npm run build && node scripts/package-smoke.mjs",
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {