domani 1.0.2 → 1.0.3

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";
     /** 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. */
@@ -133,6 +133,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 +200,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 +251,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 +359,82 @@ 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: Record<string, unknown>;
+    website: Record<string, unknown>;
+    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: Record<string, unknown>;
+    /** 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;
+    };
+    completeness: number;
+    analyzedAt: string;
+    staleAt: string;
+    analysisVersion: string;
+    evidence: ({
+        id: string;
+        kind: 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 Backorder {
     id?: string;
     domain?: string;
@@ -302,13 +512,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;
@@ -434,6 +644,36 @@ export interface AccountInfo {
     token_count: number;
     created_at: string;
 }
+export interface ActivationProjection {
+    version: 1;
+    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;
+    };
+    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 +683,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 +833,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 +956,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 +985,22 @@ 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;
+        forward_to: string | null;
+        signing_secret?: string | null;
+        created_at: string;
+        hint: string;
     }>;
     /** Create a mailbox (POST /api/emails) */
     createMailboxByAddress(body: {
@@ -746,15 +1010,22 @@ export declare class Domani {
         kind?: "api" | "hosted";
         workspace_id?: string;
     }): Promise<{
-        id?: string;
-        address?: string;
-        name?: string | null;
-        domain?: string;
-        slug?: string;
-        workspace_id?: string | null;
-        webhook_url?: string | null;
-        forward_to?: string | null;
-        signing_secret?: string;
+        id: string;
+        address: 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;
+        signing_secret?: string | null;
+        created_at: string;
+        hint: string;
     }>;
     /** Create an app password (hosted) (POST /api/emails/{address}/credentials) */
     createMailboxCredential(address: string, body?: {
@@ -807,6 +1078,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 +1120,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 +1157,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 +1191,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 +1212,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,6 +1236,10 @@ 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;
@@ -1022,18 +1311,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 +1342,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;
@@ -1089,9 +1379,12 @@ export declare class Domani {
     /** 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 +1393,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 +1422,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 +1442,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) */
@@ -1202,19 +1495,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 +1549,7 @@ export declare class Domani {
         cursor?: string;
         type?: string;
     }): Promise<{
-        events?: {
+        events?: ({
             id?: string;
             tokenId?: string | null;
             type?: string;
@@ -1252,7 +1557,7 @@ export declare class Domani {
             targetId?: string | null;
             metadata?: Record<string, unknown>;
             createdAt?: string;
-        }[];
+        })[];
         next_cursor?: string | null;
         hint?: string;
     }>;
@@ -1284,7 +1589,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 +1605,7 @@ export declare class Domani {
         limit?: number;
         cursor?: string;
     }): Promise<{
-        deals?: {
+        deals?: ({
             id?: string;
             domain?: string;
             price?: number;
@@ -1311,7 +1616,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 +1626,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 +1654,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 +1668,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 +1679,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 +1690,7 @@ export declare class Domani {
     listInvoices(query?: {
         limit?: number;
     }): Promise<{
-        invoices?: {
+        invoices?: ({
             id?: string;
             number?: string | null;
             status?: string;
@@ -1393,7 +1701,7 @@ export declare class Domani {
             created?: string;
             hosted_invoice_url?: string | null;
             invoice_pdf?: string | null;
-        }[];
+        })[];
         has_more?: boolean;
         hint?: string;
     }>;
@@ -1406,10 +1714,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,30 +1739,31 @@ 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;
@@ -1452,11 +1773,12 @@ export declare class Domani {
             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 +1786,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 +1812,7 @@ export declare class Domani {
         limit?: number;
         cursor?: string;
     }): Promise<{
-        notifications?: {
+        notifications?: ({
             id?: string;
             type?: string;
             title?: string;
@@ -1484,7 +1820,7 @@ export declare class Domani {
             action_url?: string | null;
             read?: boolean;
             created_at?: string;
-        }[];
+        })[];
         has_more?: boolean;
         next_cursor?: string | null;
     }>;
@@ -1493,12 +1829,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;
     }>;
@@ -1578,9 +1914,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;
@@ -1656,6 +1991,10 @@ export declare class Domani {
         payment_chain?: "base" | "ethereum";
         years?: number;
     }): Promise<unknown>;
+    /** 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 +2008,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;
@@ -1729,18 +2075,41 @@ 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: {
@@ -1803,6 +2172,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 +2231,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;
@@ -1946,6 +2325,21 @@ export declare class Domani {
         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 +2371,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 +2413,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 +2452,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 +2499,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;

package/dist/index.js

@@ -72,6 +72,10 @@ class Domani {
             throw new DomaniError(res.status, data);
         return data;
     }
+    /** Accept an access or ownership offer (POST /api/workspaces/access/offers/accept) */
+    acceptWorkspaceAccessOffer(body) {
+        return this.request("POST", `/api/workspaces/access/offers/accept`, { body });
+    }
     /** Accept a workspace invitation (POST /api/workspaces/invitations/accept) */
     acceptWorkspaceInvitation(body) {
         return this.request("POST", `/api/workspaces/invitations/accept`, { body });
@@ -180,6 +184,10 @@ class Domani {
     createDeal(body) {
         return this.request("POST", `/api/deals`, { body });
     }
+    /** Analyze a domain and persist an evidence-backed brief (POST /api/domain-briefs) */
+    createDomainBrief(body) {
+        return this.request("POST", `/api/domain-briefs`, { body });
+    }
     /** List a domain for sale (PUT /api/domains/{domain}/for-sale) */
     createListing(domain, body) {
         return this.request("PUT", `/api/domains/${enc(domain)}/for-sale`, { body });
@@ -208,6 +216,10 @@ class Domani {
     createWorkspace(body) {
         return this.request("POST", `/api/workspaces`, { body });
     }
+    /** Offer mailbox access or workspace ownership (POST /api/workspaces/{id}/access/offers) */
+    createWorkspaceAccessOffer(id, body) {
+        return this.request("POST", `/api/workspaces/${enc(id)}/access/offers`, { body });
+    }
     /** Start Mailzero workspace checkout (POST /api/workspaces/{id}/billing/checkout) */
     createWorkspaceCheckout(id, body) {
         return this.request("POST", `/api/workspaces/${enc(id)}/billing/checkout`, { body });
@@ -252,6 +264,10 @@ class Domani {
     getAccount() {
         return this.request("GET", `/api/me`, undefined);
     }
+    /** Get truthful activation state and recommended next actions (GET /api/me/activation) */
+    getActivation() {
+        return this.request("GET", `/api/me/activation`, undefined);
+    }
     /** Get EPP auth code (GET /api/domains/{domain}/auth-code) */
     getAuthCode(domain) {
         return this.request("GET", `/api/domains/${enc(domain)}/auth-code`, undefined);
@@ -272,6 +288,10 @@ class Domani {
     getContact() {
         return this.request("GET", `/api/me/contact`, undefined);
     }
+    /** Get active viewers, composers, and the compose lease (GET /api/email/collaboration/coordination) */
+    getConversationCoordination(query) {
+        return this.request("GET", `/api/email/collaboration/coordination`, { query });
+    }
     /** Get deal detail with timeline (GET /api/deals/{id}) */
     getDeal(id) {
         return this.request("GET", `/api/deals/${enc(id)}`, undefined);
@@ -288,6 +308,10 @@ class Domani {
     getDnssecRecords(domain) {
         return this.request("GET", `/api/domains/${enc(domain)}/dnssec`, undefined);
     }
+    /** Get a previously generated domain brief (GET /api/domain-briefs/{id}) */
+    getDomainBrief(id) {
+        return this.request("GET", `/api/domain-briefs/${enc(id)}`, undefined);
+    }
     /** Check email DNS status (GET /api/domains/{domain}/email/status) */
     getDomainEmailStatus(domain) {
         return this.request("GET", `/api/domains/${enc(domain)}/email/status`, undefined);
@@ -372,6 +396,14 @@ class Domani {
     getWorkspace(id) {
         return this.request("GET", `/api/workspaces/${enc(id)}`, undefined);
     }
+    /** Get the canonical workspace access graph (GET /api/workspaces/{id}/access) */
+    getWorkspaceAccess(id) {
+        return this.request("GET", `/api/workspaces/${enc(id)}/access`, undefined);
+    }
+    /** Heartbeat viewing or composing presence (PUT /api/email/collaboration/coordination) */
+    heartbeatConversationPresence(body) {
+        return this.request("PUT", `/api/email/collaboration/coordination`, { body });
+    }
     /** Import an external domain (POST /api/domains/import) */
     importDomain(body) {
         return this.request("POST", `/api/domains/import`, { body });
@@ -408,7 +440,7 @@ class Domani {
     listConversationNotes(id) {
         return this.request("GET", `/api/email/collaboration/${enc(id)}/notes`, undefined);
     }
-    /** List shared inbox conversation state (GET /api/email/collaboration) */
+    /** List persisted shared inbox state (GET /api/email/collaboration) */
     listConversationStates(query) {
         return this.request("GET", `/api/email/collaboration`, { query });
     }
@@ -440,6 +472,10 @@ class Domani {
     listMailboxAliases(address) {
         return this.request("GET", `/api/emails/${enc(address)}/aliases`, undefined);
     }
+    /** Incrementally synchronize one mailbox (GET /api/email/changes) */
+    listMailboxChanges(query) {
+        return this.request("GET", `/api/email/changes`, { query });
+    }
     /** List app passwords (hosted) (GET /api/emails/{address}/credentials) */
     listMailboxCredentials(address) {
         return this.request("GET", `/api/emails/${enc(address)}/credentials`, undefined);
@@ -456,6 +492,10 @@ class Domani {
     listMailRules(address) {
         return this.request("GET", `/api/emails/${enc(address)}/rules`, undefined);
     }
+    /** List actionable mailbox conversations (GET /api/email/work-queue) */
+    listMailWorkQueue(query) {
+        return this.request("GET", `/api/email/work-queue`, { query });
+    }
     /** List your negotiations (GET /api/negotiations) */
     listNegotiations(query) {
         return this.request("GET", `/api/negotiations`, { query });
@@ -524,10 +564,18 @@ class Domani {
     provisionAgent(body) {
         return this.request("POST", `/api/agents/provision`, { body });
     }
+    /** Refresh a domain brief from live sources (POST /api/domain-briefs/{id}/refresh) */
+    refreshDomainBrief(id) {
+        return this.request("POST", `/api/domain-briefs/${enc(id)}/refresh`, undefined);
+    }
     /** Create a new account (POST /api/auth/register) */
     registerUser(body) {
         return this.request("POST", `/api/auth/register`, { body });
     }
+    /** Release this client's presence and compose lease (DELETE /api/email/collaboration/coordination) */
+    releaseConversationPresence(body) {
+        return this.request("DELETE", `/api/email/collaboration/coordination`, { body });
+    }
     /** Release an agent identity (DELETE /api/agents/identity/{slug}) */
     releaseIdentity(slug) {
         return this.request("DELETE", `/api/agents/identity/${enc(slug)}`, undefined);
@@ -568,6 +616,10 @@ class Domani {
     renewDomain(domain, body) {
         return this.request("POST", `/api/domains/${enc(domain)}/renew`, { body });
     }
+    /** Replay a webhook delivery (POST /api/webhooks/{id}/deliveries/{deliveryId}/replay) */
+    replayWebhookDelivery(id, deliveryId, body) {
+        return this.request("POST", `/api/webhooks/${enc(id)}/deliveries/${enc(deliveryId)}/replay`, { body });
+    }
     /** Reply to a message (POST /api/emails/{address}/messages/{id}/reply) */
     replyToMessageByAddress(address, id, body) {
         return this.request("POST", `/api/emails/${enc(address)}/messages/${enc(id)}/reply`, { body });
@@ -600,6 +652,10 @@ class Domani {
     revokeToken(id) {
         return this.request("DELETE", `/api/tokens/${enc(id)}`, undefined);
     }
+    /** Revoke an access grant and its credentials (DELETE /api/workspaces/{id}/access/grants/{grantId}) */
+    revokeWorkspaceAccess(id, grantId, body) {
+        return this.request("DELETE", `/api/workspaces/${enc(id)}/access/grants/${enc(grantId)}`, { body });
+    }
     /** Revoke a pending invitation (DELETE /api/workspaces/{id}/invitations/{invitationId}) */
     revokeWorkspaceInvitation(id, invitationId) {
         return this.request("DELETE", `/api/workspaces/${enc(id)}/invitations/${enc(invitationId)}`, undefined);
@@ -660,6 +716,10 @@ class Domani {
     setupDomainEmail(domain, body) {
         return this.request("POST", `/api/domains/${enc(domain)}/email/setup`, { body });
     }
+    /** Plan or apply one access grant (PUT /api/workspaces/{id}/access) */
+    setWorkspaceAccess(id, body) {
+        return this.request("PUT", `/api/workspaces/${enc(id)}/access`, { body });
+    }
     /** Capture a DNS snapshot (POST /api/domains/{domain}/dns/snapshot) */
     snapshotDns(domain, body) {
         return this.request("POST", `/api/domains/${enc(domain)}/dns/snapshot`, { body });
@@ -672,6 +732,14 @@ class Domani {
     suggestDomains(query) {
         return this.request("GET", `/api/domains/suggest`, { query });
     }
+    /** Create or replace a flat access group (PUT /api/workspaces/{id}/access/groups) */
+    syncAccessGroup(id, body) {
+        return this.request("PUT", `/api/workspaces/${enc(id)}/access/groups`, { body });
+    }
+    /** Create or replace an explicit mailbox collection (PUT /api/workspaces/{id}/access/collections) */
+    syncMailboxCollection(id, body) {
+        return this.request("PUT", `/api/workspaces/${enc(id)}/access/collections`, { body });
+    }
     /** Test mailbox webhook (POST /api/emails/{address}/webhook/test) */
     testMailboxWebhook(address) {
         return this.request("POST", `/api/emails/${enc(address)}/webhook/test`, undefined);
@@ -684,6 +752,10 @@ class Domani {
     updateAccount(body) {
         return this.request("PUT", `/api/me`, { body });
     }
+    /** Dismiss or restore first-run guidance (PUT /api/me/activation) */
+    updateActivationPreference(body) {
+        return this.request("PUT", `/api/me/activation`, { body });
+    }
     /** Assign or update a shared inbox conversation (PATCH /api/email/collaboration) */
     updateConversationState(body) {
         return this.request("PATCH", `/api/email/collaboration`, { body });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "domani",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Official TypeScript SDK for the domani API - domains, email, and identity for AI agents.",
   "main": "./src/index.ts",
   "types": "./src/index.ts",