domani 1.0.2 → 1.0.4

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";
+    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 */
@@ -133,6 +152,59 @@ export interface MailRule {
     enabled?: boolean;
     created_at?: string;
 }
+export interface MailboxOperationReceipt {
+    operation_id: string;
+    idempotency_key: string;
+    /** True when this response reused the immutable completed receipt and performed no new mutation. */
+    idempotent_replay: boolean;
+    action: "move" | "mark_read" | "star" | "restore" | "delete_permanently";
+    status: "succeeded" | "partial";
+    results: ({
+        message_id: string;
+        ok: boolean;
+        folder?: "inbox" | "archive" | "sent" | "drafts" | "spam" | "trash";
+        changed?: boolean;
+        error?: {
+            code: string;
+            message: string;
+        };
+    })[];
+    summary: {
+        total: number;
+        succeeded: number;
+        failed: number;
+        changed: number;
+    };
+    created_at: string;
+    completed_at: string | null;
+}
+export interface LegacyMailboxOperationReceipt {
+    operation_id: string;
+    idempotency_key: string;
+    /** True when this response reused the immutable completed receipt and performed no new mutation. */
+    idempotent_replay: boolean;
+    action: "move" | "mark_read" | "star" | "restore" | "delete_permanently";
+    status: "succeeded" | "partial";
+    results: ({
+        message_id: string;
+        ok: boolean;
+        folder?: "inbox" | "archive" | "sent" | "drafts" | "spam" | "trash";
+        changed?: boolean;
+        error?: {
+            code: string;
+            message: string;
+        };
+    })[];
+    summary: {
+        total: number;
+        succeeded: number;
+        failed: number;
+        changed: number;
+    };
+    created_at: string;
+    completed_at: string | null;
+    count: number;
+}
 export interface WorkspaceSummary {
     id: string;
     name: string;
@@ -147,34 +219,36 @@ export interface WorkspaceSummary {
     }[];
     created_at: string;
 }
+export type MailboxEffectiveCapabilities = ("mail.read" | "mail.search" | "mail.auth.read" | "mail.seen.write" | "mail.lifecycle.write" | "mail.delete.permanent" | "draft.create" | "mail.submit" | "conversation.read" | "conversation.assign" | "conversation.note" | "conversation.close" | "mailbox.manage" | "routing.manage" | "delivery.manage" | "mail.client.connect" | "mail.credentials.create_self" | "mail.credentials.revoke_self" | "workspace.members.manage" | "workspace.billing.manage")[];
 export interface WorkspaceDetail {
     id: string;
     name: string;
     role: "owner" | "admin" | "member";
     personal: boolean;
-    members: {
-        id?: string;
-        email?: string;
-        role?: "owner" | "admin" | "member";
-        joined_at?: string;
-        mailbox_grants?: {
+    members: ({
+        id: string;
+        principal_id: string;
+        email: string;
+        role: "owner" | "admin" | "member";
+        joined_at: string;
+        mailbox_grants: ({
             mailbox_id?: string;
             address?: string;
             role?: "viewer" | "responder" | "manager";
-        }[];
-    }[];
+        })[];
+    })[];
     /** Visible only to workspace owners and admins. */
-    invitations: {
+    invitations: ({
         id?: string;
         email?: string;
         role?: "admin" | "member";
         expires_at?: string;
-    }[];
-    mailboxes: {
+    })[];
+    mailboxes: ({
         id?: string;
         address?: string;
         name?: string | null;
-    }[];
+    })[];
     ownership: {
         owner_membership_id: string | null;
         pending_transfer: {
@@ -196,12 +270,91 @@ export interface ConversationState {
         label?: string;
     } | null;
     version: number;
+    /** Generation used by stale-safe guarded replies */
+    reply_version: number;
+    last_reply: {
+        actor: {
+            type: string;
+            id: string;
+            label: string;
+        };
+        at: string;
+    } | null;
     note_count: number;
     assigned_to_me?: boolean;
     last_activity_at: string;
     created_at: string;
     updated_at: string;
 }
+export interface ConversationCoordinationSnapshot {
+    conversation_id: string;
+    mailbox_id: string;
+    thread_key: string;
+    reply_version: number;
+    last_reply: {
+        actor: {
+            type: string;
+            id: string;
+            label: string;
+        };
+        at: string;
+    } | null;
+    presence: ({
+        actor: {
+            type: string;
+            id: string;
+            label: string;
+        };
+        client_id: string;
+        mode: "viewing" | "composing";
+        expires_at: string;
+    })[];
+    compose_lease: {
+        lease_id: string;
+        holder: {
+            type: string;
+            id: string;
+            label: string;
+        };
+        client_id: string;
+        base_reply_version: number;
+        version: number;
+        expires_at: string;
+        held_by_me: boolean;
+    } | null;
+    server_time: string;
+    heartbeat_after_ms: 15000;
+    expires_after_ms: 45000;
+}
+export interface ConversationWorkItem {
+    mailbox_id: string;
+    thread_key: string;
+    thread_aliases: string[];
+    subject: string | null;
+    status: "open" | "waiting" | "closed";
+    assignee: {
+        type: "member" | "token" | "agent";
+        id: string;
+        label: string | null;
+    } | null;
+    assigned_to_me: boolean;
+    persisted: boolean;
+    conversation_id: string | null;
+    version: number | null;
+    note_count: number;
+    scanned_message_count: number;
+    scanned_unread_count: number;
+    first_message_at: string | null;
+    last_activity_at: string;
+    latest_message: {
+        id: string;
+        direction: string;
+        from: string;
+        to: string;
+        preview: string | null;
+        created_at: string;
+    } | null;
+}
 export interface ConversationNote {
     id: string;
     author: {
@@ -225,6 +378,171 @@ export interface MailActivity {
     metadata: Record<string, unknown>;
     created_at: string;
 }
+export interface MailboxChange {
+    /** Monotonic sequence serialized as a string */
+    sequence: string;
+    type: string;
+    resource_type: string;
+    resource_id: string | null;
+    resource_version: number | null;
+    actor: {
+        type: string;
+        id: string;
+        label: string | null;
+    } | null;
+    operation_id: string | null;
+    data: Record<string, unknown>;
+    created_at: string;
+}
+export interface DomainBrief {
+    id: string;
+    domain: string;
+    depth: "instant" | "deep";
+    status: "ready" | "degraded" | "failed";
+    summary: string;
+    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[];
+        dnssec: boolean;
+        mail: {
+            status: "active" | "inactive" | "unknown";
+            provider: string | null;
+            providerKind: "managed" | "self_hosted" | "gateway" | "custom" | "unknown";
+            security: "hardened" | "established" | "basic" | "exposed" | "unknown";
+            businessCriticality: "high" | "medium" | "low" | "unknown";
+            spf: boolean | null;
+            dmarc: "reject" | "quarantine" | "monitor" | "none" | "unknown";
+            mtaSts: boolean | null;
+            tlsReporting: boolean | null;
+            bimi: boolean | null;
+        };
+    };
+    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";
+        channelType: "registration_email" | null;
+        source: string | null;
+        confidence: "high" | "medium" | "low" | null;
+    };
+    acquisitionOutlook: {
+        state: "promising" | "possible" | "difficult" | "unknown";
+        rationale: string;
+    };
+    recommendation: {
+        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: "registry" | "dns" | "website" | "content" | "archive" | "entity" | "market" | "contact";
+        claimKey: string;
+        label: string;
+        value: string;
+        source: string;
+        sourceUrl?: string;
+        confidence: "high" | "medium" | "low";
+        visibility: "public" | "redacted";
+        capturedAt: string;
+    })[];
+    warnings: string[];
+    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;
@@ -302,13 +620,13 @@ export interface Negotiation {
     deal_id?: string | null;
     created_at?: string;
     /** The negotiation thread, oldest first */
-    offers?: {
+    offers?: ({
         from?: "you" | "counterparty";
         kind?: "offer" | "counter" | "accept" | "decline";
         amount?: number | null;
         message?: string | null;
         at?: string;
-    }[];
+    })[];
 }
 export interface DomainDetail {
     domain: string;
@@ -416,6 +734,10 @@ 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;
     /** Whether the user has set WHOIS contact info (required before purchasing domains) */
@@ -434,6 +756,37 @@ export interface AccountInfo {
     token_count: number;
     created_at: string;
 }
+export interface ActivationProjection {
+    version: 2;
+    account_created_at: string;
+    entry: {
+        brand: string;
+        surface: string;
+        intent: string;
+    };
+    milestones: {
+        mailbox_created_at: string | null;
+        first_message_sent_at: string | null;
+        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: ({
+        id: string;
+        label: string;
+        priority: number;
+        surfaces: ("web" | "mobile" | "cli" | "mcp")[];
+        href?: string;
+        operation: string;
+    })[];
+    available_paths: string[];
+    dismissed_version: number;
+    pending_claim: {
+        slug: string;
+    } | null;
+}
 export declare class Domani {
     private apiKey;
     private baseUrl;
@@ -443,6 +796,10 @@ export declare class Domani {
         query?: Record<string, unknown>;
         body?: unknown;
     }): Promise<T>;
+    /** Accept an access or ownership offer (POST /api/workspaces/access/offers/accept) */
+    acceptWorkspaceAccessOffer(body: {
+        token: string;
+    }): Promise<unknown>;
     /** Accept a workspace invitation (POST /api/workspaces/invitations/accept) */
     acceptWorkspaceInvitation(body: {
         token: string;
@@ -589,14 +946,14 @@ export declare class Domani {
         risk: "low" | "medium" | "high" | "blocked";
         score: number;
         authentication_message?: boolean;
-        checks: {
+        checks: ({
             id: string;
             category: "transport_safety" | "credential_safety" | "reputation" | "content_quality" | "reliability";
             status: "pass" | "warning" | "blocked";
             message: string;
             fix?: string;
             evidence?: string[];
-        }[];
+        })[];
         blocked_reasons: string[];
         warnings: string[];
         override_used?: boolean;
@@ -712,6 +1069,14 @@ export declare class Domani {
         hint?: string;
         next_steps?: string[];
     }>;
+    /** Analyze a domain and persist an evidence-backed brief (POST /api/domain-briefs) */
+    createDomainBrief(body: {
+        domain: string;
+        depth?: "instant" | "deep";
+        refresh?: boolean;
+    }): Promise<{
+        brief: DomainBrief;
+    }>;
     /** List a domain for sale (PUT /api/domains/{domain}/for-sale) */
     createListing(domain: string, body: {
         price: number;
@@ -733,10 +1098,23 @@ export declare class Domani {
         slug: string;
         name?: string;
     }): Promise<{
-        id?: string;
-        address?: string;
-        slug?: string;
-        domain?: string;
+        id: string;
+        address: string;
+        name: string | null;
+        slug: string;
+        domain: 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;
+        header_names: string[];
+        forward_to: string | null;
+        signing_secret?: string | null;
+        created_at: string;
+        hint: string;
     }>;
     /** Create a mailbox (POST /api/emails) */
     createMailboxByAddress(body: {
@@ -746,15 +1124,39 @@ export declare class Domani {
         kind?: "api" | "hosted";
         workspace_id?: string;
     }): Promise<{
-        id?: string;
-        address?: string;
+        id: string;
+        address: string;
         name?: string | null;
         domain?: string;
         slug?: string;
-        workspace_id?: string | null;
+        kind: string;
+        workspace_id: 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;
+        signing_secret?: string | null;
+        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) */
     createMailboxCredential(address: string, body?: {
@@ -794,12 +1196,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;
     }>;
@@ -807,6 +1211,14 @@ export declare class Domani {
     createWorkspace(body: {
         name: string;
     }): Promise<unknown>;
+    /** Offer mailbox access or workspace ownership (POST /api/workspaces/{id}/access/offers) */
+    createWorkspaceAccessOffer(id: string, body: {
+        email: string;
+        grants: Record<string, unknown>[];
+        ownership_disposition?: "unchanged" | "claim";
+        creator_disposition?: "stay" | "stay_admin" | "leave";
+        billing_disposition?: "unchanged" | "sponsor" | "transfer";
+    }): Promise<unknown>;
     /** Start Mailzero workspace checkout (POST /api/workspaces/{id}/billing/checkout) */
     createWorkspaceCheckout(id: string, body: {
         plan: "mail_solo" | "mail_team" | "mail_business";
@@ -841,9 +1253,8 @@ export declare class Domani {
     /** Bulk delete messages (POST /api/emails/{address}/messages/delete) */
     deleteMessagesByAddress(address: string, body?: {
         message_ids: string[];
-    }): Promise<{
-        count?: number;
-    }>;
+        idempotency_key?: string;
+    }): Promise<LegacyMailboxOperationReceipt>;
     /** Delete webhook (DELETE /api/webhooks/{id}) */
     deleteWebhook(id: string): Promise<{
         success?: boolean;
@@ -879,6 +1290,8 @@ export declare class Domani {
     }>;
     /** Get current account details (GET /api/me) */
     getAccount(): Promise<AccountInfo>;
+    /** Get truthful activation state and recommended next actions (GET /api/me/activation) */
+    getActivation(): Promise<ActivationProjection>;
     /** Get EPP auth code (GET /api/domains/{domain}/auth-code) */
     getAuthCode(domain: string): Promise<{
         domain: string;
@@ -911,6 +1324,11 @@ export declare class Domani {
         has_contact?: boolean;
         contact?: RegistrantContact;
     }>;
+    /** Get active viewers, composers, and the compose lease (GET /api/email/collaboration/coordination) */
+    getConversationCoordination(query?: {
+        mailbox_id: string;
+        thread_key: string;
+    }): Promise<ConversationCoordinationSnapshot>;
     /** Get deal detail with timeline (GET /api/deals/{id}) */
     getDeal(id: string): Promise<{
         deal?: {
@@ -927,11 +1345,11 @@ export declare class Domani {
             transfer_deadline?: string | null;
             completed_at?: string | null;
             created_at?: string;
-            events?: {
+            events?: ({
                 status?: string;
                 detail?: string | null;
                 created_at?: string;
-            }[];
+            })[];
         };
         hint?: string;
     }>;
@@ -951,12 +1369,21 @@ export declare class Domani {
         enabled?: boolean;
         records?: DsRecord[];
     }>;
+    /** Get a previously generated domain brief (GET /api/domain-briefs/{id}) */
+    getDomainBrief(id: string): Promise<{
+        brief: DomainBrief;
+    }>;
     /** 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>;
@@ -1022,18 +1449,18 @@ export declare class Domani {
         placement: {
             available?: boolean;
             last_checked_at?: string | null;
-            providers?: {
+            providers?: ({
                 provider?: "gmail" | "outlook" | "yahoo";
-                status?: "inbox" | "spam" | "missing" | "not_tested";
-            }[];
+                status?: "inbox" | "spam" | "missing" | "error" | "not_tested";
+            })[];
             note?: string;
         };
-        actions: {
+        actions: ({
             id?: string;
             severity?: "info" | "warning" | "critical";
             title?: string;
             detail?: string;
-        }[];
+        })[];
         caveats?: string[];
     }>;
     /** Get mailbox avatar info (GET /api/emails/{address}/avatar) */
@@ -1053,6 +1480,7 @@ export declare class Domani {
         kind?: string;
         workspace_id?: string | null;
         access_role?: "viewer" | "responder" | "manager";
+        effective_capabilities?: MailboxEffectiveCapabilities;
         webhook_url?: string | null;
         forward_to?: string | null;
         signing_secret?: string | null;
@@ -1084,14 +1512,18 @@ 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}) */
     getMessageByAddress(address: string, id: string): Promise<{
         id?: string;
+        thread_key?: string;
+        thread_aliases?: string[];
         message_id?: string | null;
         direction?: "in" | "out";
         from?: string;
+        avatar_url?: string | null;
         to?: string;
         cc?: string | null;
         reply_to?: string | null;
@@ -1100,20 +1532,20 @@ export declare class Domani {
         html?: string | null;
         in_reply_to?: string | null;
         references?: string | null;
-        attachments?: {
+        attachments?: ({
             filename?: string;
             content_type?: string;
             size?: number;
             url?: string | null;
-        }[];
+        })[];
         status?: string;
         is_read?: boolean;
         read_at?: string | null;
-        events?: {
+        events?: ({
             status?: string;
             detail?: Record<string, unknown> | null;
             created_at?: string;
-        }[];
+        })[];
         created_at?: string;
     }>;
     /** Get nameservers for a domain (GET /api/domains/{domain}/nameservers) */
@@ -1129,13 +1561,13 @@ export declare class Domani {
     }>;
     /** Get notification preferences (GET /api/notifications/preferences) */
     getNotificationPreferences(): Promise<{
-        preferences?: {
+        preferences?: ({
             category?: "domains" | "transfers" | "marketplace" | "email" | "inquiries";
             label?: string;
             description?: string;
             channel?: "in_app" | "email";
             enabled?: boolean;
-        }[];
+        })[];
         expiry_alert_days?: number[];
     }>;
     /** Get parking analytics (GET /api/domains/{domain}/analytics) */
@@ -1149,11 +1581,11 @@ export declare class Domani {
             date?: string;
             views?: number;
         }[];
-        recent_inquiries?: {
+        recent_inquiries?: ({
             email?: string;
             offer?: number | null;
             date?: string;
-        }[];
+        })[];
         hint?: string;
     }>;
     /** Get marketplace payout status (GET /api/billing/connect) */
@@ -1163,6 +1595,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;
@@ -1202,19 +1638,31 @@ export declare class Domani {
     getWebhookDeliveries(id: string, query?: {
         limit?: number;
     }): Promise<{
-        deliveries?: {
+        deliveries?: ({
             id?: string;
+            replay_of_id?: string | null;
             event_type?: string;
             status?: "pending" | "delivered" | "failed";
             http_status?: number | null;
             attempts?: number;
             last_error?: string | null;
             created_at?: string;
-        }[];
+        })[];
         hint?: string;
     }>;
     /** Get workspace members and mailboxes (GET /api/workspaces/{id}) */
     getWorkspace(id: string): Promise<WorkspaceDetail>;
+    /** Get the canonical workspace access graph (GET /api/workspaces/{id}/access) */
+    getWorkspaceAccess(id: string): Promise<unknown>;
+    /** Heartbeat viewing or composing presence (PUT /api/email/collaboration/coordination) */
+    heartbeatConversationPresence(body: {
+        mailbox_id: string;
+        thread_key: string;
+        client_id: string;
+        subject?: string | null;
+        mode: "viewing" | "composing";
+        acquire_lease?: boolean;
+    }): Promise<ConversationCoordinationSnapshot>;
     /** Import an external domain (POST /api/domains/import) */
     importDomain(body: {
         domain: string;
@@ -1244,7 +1692,7 @@ export declare class Domani {
         cursor?: string;
         type?: string;
     }): Promise<{
-        events?: {
+        events?: ({
             id?: string;
             tokenId?: string | null;
             type?: string;
@@ -1252,7 +1700,7 @@ export declare class Domani {
             targetId?: string | null;
             metadata?: Record<string, unknown>;
             createdAt?: string;
-        }[];
+        })[];
         next_cursor?: string | null;
         hint?: string;
     }>;
@@ -1284,7 +1732,7 @@ export declare class Domani {
     listConversationNotes(id: string): Promise<{
         notes: ConversationNote[];
     }>;
-    /** List shared inbox conversation state (GET /api/email/collaboration) */
+    /** List persisted shared inbox state (GET /api/email/collaboration) */
     listConversationStates(query?: {
         mailbox_ids: string;
         status?: "open" | "waiting" | "closed";
@@ -1300,7 +1748,7 @@ export declare class Domani {
         limit?: number;
         cursor?: string;
     }): Promise<{
-        deals?: {
+        deals?: ({
             id?: string;
             domain?: string;
             price?: number;
@@ -1311,7 +1759,7 @@ export declare class Domani {
             epp_deadline?: string | null;
             transfer_deadline?: string | null;
             created_at?: string;
-        }[];
+        })[];
         has_more?: boolean;
         next_cursor?: string | null;
     }>;
@@ -1321,16 +1769,16 @@ export declare class Domani {
     }>;
     /** List email folders and counts (GET /api/emails/{address}/folders) */
     listEmailFoldersByAddress(address: string): Promise<{
-        folders?: {
+        folders?: ({
             id?: "inbox" | "archive" | "sent" | "drafts" | "spam" | "trash";
             total?: number;
             unread?: number;
-        }[];
-        views?: {
+        })[];
+        views?: ({
             id?: "starred" | "all";
             total?: number;
             unread?: number;
-        }[];
+        })[];
         capabilities?: Record<string, unknown>;
     }>;
     /** List emails (GET /api/emails/{address}/messages) */
@@ -1349,8 +1797,10 @@ export declare class Domani {
         attachments?: boolean;
         spam?: boolean;
     }): Promise<{
-        messages?: {
+        messages?: ({
             id?: string;
+            thread_key?: string;
+            thread_aliases?: string[];
             message_id?: string | null;
             direction?: "in" | "out";
             folder?: "inbox" | "archive" | "sent" | "spam" | "trash";
@@ -1361,6 +1811,7 @@ export declare class Domani {
             spam_detected?: boolean;
             trashed_at?: string | null;
             from?: string;
+            avatar_url?: string | null;
             to?: string;
             cc?: string | null;
             reply_to?: string | null;
@@ -1371,7 +1822,7 @@ export declare class Domani {
             status?: string;
             events?: Record<string, unknown>[];
             created_at?: string;
-        }[];
+        })[];
         next_cursor?: string | null;
     }>;
     /** List your agent identities (GET /api/agents/identity) */
@@ -1382,7 +1833,7 @@ export declare class Domani {
     listInvoices(query?: {
         limit?: number;
     }): Promise<{
-        invoices?: {
+        invoices?: ({
             id?: string;
             number?: string | null;
             status?: string;
@@ -1393,7 +1844,7 @@ export declare class Domani {
             created?: string;
             hosted_invoice_url?: string | null;
             invoice_pdf?: string | null;
-        }[];
+        })[];
         has_more?: boolean;
         hint?: string;
     }>;
@@ -1406,10 +1857,22 @@ export declare class Domani {
         }[];
         hint?: string;
     }>;
+    /** Incrementally synchronize one mailbox (GET /api/email/changes) */
+    listMailboxChanges(query?: {
+        mailbox_id: string;
+        cursor?: string;
+        limit?: number;
+    }): Promise<{
+        changes: MailboxChange[];
+        next_cursor: string;
+        has_more: boolean;
+        requires_full_sync: boolean;
+        reason?: "cursor_required" | "cursor_expired";
+    }>;
     /** List app passwords (hosted) (GET /api/emails/{address}/credentials) */
     listMailboxCredentials(address: string): Promise<{
         mailbox?: string;
-        credentials?: {
+        credentials?: ({
             id?: string;
             label?: string;
             created_at?: string;
@@ -1419,44 +1882,47 @@ export declare class Domani {
                 id?: string;
                 label?: string;
             } | null;
-        }[];
+        })[];
         hint?: string;
     }>;
     /** List all mailboxes (GET /api/email) */
     listMailboxes(query?: {
         domain?: string;
     }): Promise<{
-        mailboxes?: {
+        mailboxes?: ({
             id?: string;
             address?: string;
             slug?: string;
             domain?: string;
             message_count?: number;
             access_role?: "viewer" | "responder" | "manager";
+            effective_capabilities?: MailboxEffectiveCapabilities;
             storage_quota_bytes?: number | null;
             storage_used_bytes?: number | null;
             storage_measured_at?: string | null;
-        }[];
+        })[];
     }>;
     /** List all mailboxes (GET /api/emails) */
     listMailboxesByAddress(query?: {
         domain?: string;
     }): Promise<{
-        mailboxes?: {
+        mailboxes?: ({
             id?: string;
             address?: string;
             slug?: string;
             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";
+            effective_capabilities?: MailboxEffectiveCapabilities;
             collaboration_enabled?: boolean;
             storage_quota_bytes?: number | null;
             storage_used_bytes?: number | null;
             storage_measured_at?: string | null;
-        }[];
+        })[];
     }>;
     /** List inbound mail rules (GET /api/emails/{address}/rules) */
     listMailRules(address: string): Promise<{
@@ -1464,6 +1930,20 @@ export declare class Domani {
         rules?: MailRule[];
         hint?: string;
     }>;
+    /** List actionable mailbox conversations (GET /api/email/work-queue) */
+    listMailWorkQueue(query?: {
+        mailbox_ids: string;
+        status?: "open" | "waiting" | "closed";
+        assigned?: "mine" | "unassigned" | "all";
+        limit?: number;
+        scan_limit?: number;
+    }): Promise<{
+        items: ConversationWorkItem[];
+        returned: number;
+        scanned_messages: number;
+        partial: boolean;
+        scan_limit_per_mailbox: number;
+    }>;
     /** List your negotiations (GET /api/negotiations) */
     listNegotiations(query?: {
         role?: "buyer" | "seller";
@@ -1476,7 +1956,7 @@ export declare class Domani {
         limit?: number;
         cursor?: string;
     }): Promise<{
-        notifications?: {
+        notifications?: ({
             id?: string;
             type?: string;
             title?: string;
@@ -1484,7 +1964,7 @@ export declare class Domani {
             action_url?: string | null;
             read?: boolean;
             created_at?: string;
-        }[];
+        })[];
         has_more?: boolean;
         next_cursor?: string | null;
     }>;
@@ -1493,12 +1973,12 @@ export declare class Domani {
         cursor?: string;
         limit?: number;
     }): Promise<{
-        suppressions?: {
+        suppressions?: ({
             address?: string;
             reason?: "hard_bounce" | "complaint" | "manual";
             source?: "resend" | "api";
             created_at?: string;
-        }[];
+        })[];
         next_cursor?: string | null;
         hint?: string;
     }>;
@@ -1545,6 +2025,7 @@ export declare class Domani {
             id?: string;
             url?: string;
             events?: string[];
+            header_names?: string[];
             active?: boolean;
             created_at?: string;
         }[];
@@ -1578,9 +2059,8 @@ export declare class Domani {
     markMessagesReadByAddress(address: string, body?: {
         message_ids: string[];
         read: boolean;
-    }): Promise<{
-        count?: number;
-    }>;
+        idempotency_key?: string;
+    }): Promise<LegacyMailboxOperationReceipt>;
     /** Mark notification as read (PATCH /api/notifications/{id}) */
     markNotificationRead(id: string, body: {
         read: boolean;
@@ -1650,12 +2130,20 @@ 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;
+    }>;
     /** Create a new account (POST /api/auth/register) */
     registerUser(body: {
         email: string;
@@ -1669,6 +2157,13 @@ export declare class Domani {
             email?: string;
         };
     }>;
+    /** Release this client's presence and compose lease (DELETE /api/email/collaboration/coordination) */
+    releaseConversationPresence(body: {
+        mailbox_id: string;
+        thread_key: string;
+        client_id: string;
+        lease_id?: string;
+    }): Promise<ConversationCoordinationSnapshot>;
     /** Release an agent identity (DELETE /api/agents/identity/{slug}) */
     releaseIdentity(slug: string): Promise<{
         success?: boolean;
@@ -1697,6 +2192,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}) */
@@ -1729,23 +2225,52 @@ export declare class Domani {
         payment_method: string;
         payment_tx?: string;
     }>;
+    /** Replay a webhook delivery (POST /api/webhooks/{id}/deliveries/{deliveryId}/replay) */
+    replayWebhookDelivery(id: string, deliveryId: string, body: {
+        idempotency_key: string;
+    }): Promise<{
+        delivery_id: string;
+        original_delivery_id: string;
+        event_type: string;
+        status: "pending" | "delivered" | "failed";
+        http_status?: number | null;
+        attempts: number;
+        idempotency_key: string;
+        idempotent_replay: boolean;
+        created_at: string;
+        hint?: string;
+    }>;
     /** Reply to a message (POST /api/emails/{address}/messages/{id}/reply) */
     replyToMessageByAddress(address: string, id: string, body?: {
         text?: string;
         html?: string;
         cc?: string | string[];
         all?: boolean;
+        idempotency_key?: string;
+        coordination?: {
+            thread_key?: string;
+            client_id: string;
+            lease_id: string;
+            expected_reply_version: number;
+        };
     }): Promise<{
         id?: string;
         message_id?: string;
         from?: string;
         to?: string;
         status?: string;
+        reply_version?: number;
     }>;
     /** Request a workspace ownership transfer (POST /api/workspaces/{id}/ownership-transfer) */
     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;
@@ -1803,6 +2328,10 @@ export declare class Domani {
     revokeToken(id: string): Promise<{
         success?: boolean;
     }>;
+    /** Revoke an access grant and its credentials (DELETE /api/workspaces/{id}/access/grants/{grantId}) */
+    revokeWorkspaceAccess(id: string, grantId: string, body?: {
+        expected_version?: number;
+    }): Promise<unknown>;
     /** Revoke a pending invitation (DELETE /api/workspaces/{id}/invitations/{invitationId}) */
     revokeWorkspaceInvitation(id: string, invitationId: string): Promise<unknown>;
     /** Revoke a pending ownership transfer (DELETE /api/workspaces/{id}/ownership-transfer/{transferId}) */
@@ -1858,6 +2387,12 @@ export declare class Domani {
         in_reply_to?: string;
         references?: string;
         idempotency_key?: string;
+        coordination?: {
+            thread_key: string;
+            client_id: string;
+            lease_id: string;
+            expected_reply_version: number;
+        };
         allow_risky_content?: boolean;
         attachments?: {
             content: string;
@@ -1912,11 +2447,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) */
@@ -1943,9 +2480,27 @@ 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;
     }>;
+    /** Plan or apply one access grant (PUT /api/workspaces/{id}/access) */
+    setWorkspaceAccess(id: string, body: {
+        mode: "plan" | "apply";
+        subject: Record<string, unknown>;
+        resource: Record<string, unknown>;
+        profile: "viewer" | "responder" | "manager" | "draft_only" | "mail_client";
+        policy?: {
+            expires_at?: string | null;
+            recipient_domains?: string[];
+            max_recipients_per_message?: number;
+            require_approval_for?: string[];
+        };
+        expected_version?: number;
+        reason?: string;
+    }): Promise<unknown>;
     /** Capture a DNS snapshot (POST /api/domains/{domain}/dns/snapshot) */
     snapshotDns(domain: string, body?: {
         extra_subdomains?: string[];
@@ -1977,6 +2532,24 @@ export declare class Domani {
         checked: number;
         iterations: number;
     }>;
+    /** Create or replace a flat access group (PUT /api/workspaces/{id}/access/groups) */
+    syncAccessGroup(id: string, body: {
+        id?: string;
+        name: string;
+        description?: string | null;
+        principals: ({
+            type: "human" | "agent" | "service" | "token";
+            id: string;
+            label: string;
+        })[];
+    }): Promise<unknown>;
+    /** Create or replace an explicit mailbox collection (PUT /api/workspaces/{id}/access/collections) */
+    syncMailboxCollection(id: string, body: {
+        id?: string;
+        name: string;
+        description?: string | null;
+        mailbox_ids: string[];
+    }): Promise<unknown>;
     /** Test mailbox webhook (POST /api/emails/{address}/webhook/test) */
     testMailboxWebhook(address: string): Promise<{
         address?: string;
@@ -2001,10 +2574,18 @@ export declare class Domani {
         preferred_payment_method?: string | null;
         hint?: string;
     }>;
+    /** Dismiss or restore first-run guidance (PUT /api/me/activation) */
+    updateActivationPreference(body: {
+        dismissed_version: number;
+    }): Promise<{
+        dismissed_version: number;
+        hint: string;
+    }>;
     /** Assign or update a shared inbox conversation (PATCH /api/email/collaboration) */
     updateConversationState(body: {
         mailbox_id: string;
         thread_key: string;
+        thread_aliases?: string[];
         subject?: string | null;
         status?: "open" | "waiting" | "closed";
         assignee?: {
@@ -2032,7 +2613,8 @@ export declare class Domani {
         destination?: "inbox" | "archive" | "sent" | "spam" | "trash";
         read?: boolean;
         starred?: boolean;
-    }): Promise<unknown>;
+        idempotency_key?: string;
+    }): Promise<MailboxOperationReceipt>;
     /** Update an agent identity (PATCH /api/agents/identity/{slug}) */
     updateIdentity(slug: string, body: {
         name?: string;
@@ -2078,11 +2660,11 @@ export declare class Domani {
     }>;
     /** Update notification preferences (PUT /api/notifications/preferences) */
     updateNotificationPreferences(body: {
-        preferences?: {
+        preferences?: ({
             category: "domains" | "transfers" | "marketplace" | "email" | "inquiries";
             channel: "in_app" | "email";
             enabled: boolean;
-        }[];
+        })[];
         expiry_alert_days?: number[];
     }): Promise<{
         ok?: boolean;
@@ -2102,11 +2684,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}) */