domani 1.0.5 → 1.1.0

package/dist/index.d.ts

@@ -18,7 +18,7 @@ export interface Error {
     /** Human-readable error message */
     error: string;
     /** Machine-readable error code */
-    code: "MISSING_API_KEY" | "INVALID_API_KEY" | "EXPIRED_API_KEY" | "MISSING_PARAMETER" | "INVALID_DOMAIN" | "PAYMENT_REQUIRED" | "DOMAIN_UNAVAILABLE" | "RATE_LIMIT_EXCEEDED" | "USER_EXISTS" | "NOT_FOUND" | "UNKNOWN_PROVIDER" | "UNKNOWN_METHOD" | "TARGET_REQUIRED" | "INVALID_PARAMETER" | "CONTACT_REQUIRED" | "INVALID_CONTACT" | "INSUFFICIENT_SCOPE" | "SCOPE_ESCALATION" | "DOMAIN_EXISTS" | "DOMAIN_NOT_ACTIVE" | "UNSUPPORTED_TLD" | "NOT_AVAILABLE" | "ALREADY_REGISTERED" | "TRANSFER_NOT_ELIGIBLE" | "ALREADY_LISTED" | "LISTING_SOLD" | "SELF_PURCHASE" | "DESCRIPTION_TOO_LONG" | "DEAL_NOT_FOUND" | "INVALID_DEAL_STATE" | "EPP_ATTEMPTS_EXCEEDED" | "ACTIVE_DEAL_EXISTS" | "AGENT_IDENTITY_NOT_FOUND" | "AGENT_IDENTITY_ESCALATION" | "CREDENTIAL_REVOKE_FAILED" | "INVALID_IDEMPOTENCY_KEY" | "IDEMPOTENCY_KEY_MISMATCH" | "IDEMPOTENCY_KEY_REUSED" | "OPERATION_IN_PROGRESS" | "OPERATION_SUPERSEDED" | "INVALID_OPERATION_RECEIPT" | "WORKSPACE_ADMIN_REQUIRED" | "PRINCIPAL_NOT_IN_WORKSPACE" | "MAILBOX_NOT_IN_WORKSPACE" | "GROUP_NOT_IN_WORKSPACE" | "COLLECTION_NOT_IN_WORKSPACE" | "ACCESS_VERSION_CONFLICT" | "ACCESS_OFFER_INVALID" | "ACCESS_OFFER_EMAIL_MISMATCH" | "MAIL_DOMAIN_CAPACITY_EXHAUSTED" | "MAIL_PROVIDER_ERROR";
+    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" | "WORKSPACE_OWNER_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" | "INVALID_HTTP_ROUTE_HOSTNAME" | "INVALID_HTTP_ROUTE_UPSTREAM" | "INVALID_HTTP_ROUTE_UPSTREAM_HEADERS" | "INVALID_HTTP_ROUTE_LEASE" | "INVALID_HTTP_ROUTE_POLICY" | "INVALID_HOSTNAME_BINDING" | "HTTP_ROUTE_HOSTNAME_NOT_ALLOWED" | "HTTP_ROUTE_HOSTNAME_REQUIRED" | "HTTP_ROUTE_HOSTNAME_RESERVED" | "HTTP_ROUTE_HOSTNAME_UNAVAILABLE" | "HTTP_ROUTE_CONCURRENCY_LIMIT" | "HTTP_ROUTE_WORKSPACE_LIMIT" | "HTTP_ROUTE_DOMAIN_NOT_OWNED" | "HTTP_ROUTE_TERMINAL" | "HTTP_ROUTE_VERIFICATION_NOT_ENABLED" | "HTTP_ROUTE_VERIFICATION_REQUIRES_HTTPS" | "HTTP_ROUTE_POLICY_WITHOUT_SCOPE" | "HTTP_ROUTE_POLICY_REQUIRED" | "HTTP_ROUTE_AGENT_IDENTITY_REQUIRED" | "HTTP_ROUTE_POLICY_ESCALATION" | "HOSTNAME_BINDING_NOT_ACTIVE" | "HOSTNAME_BINDING_DNS_CONFLICT" | "HOSTNAME_BINDING_ACK_REQUIRED" | "HOSTNAME_BINDING_BROWSER_MODE_MISMATCH" | "HOSTNAME_DNS_CONFLICT" | "ZONE_READ_FAILED" | "DNS_VERSION_CONFLICT" | "UNAUTHORIZED" | "APEX_WEB_MODE_CONFLICT" | "APEX_DELEGATION_ACK_REQUIRED" | "VERIFICATION_COOLDOWN" | "VERIFICATION_SEND_FAILED";
     /** 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;
+    /** Minutes until another verification email may be requested */
+    retry_after_minutes?: number;
     /** Whether retrying after the external condition changes is safe */
     retryable?: boolean;
 }
@@ -87,6 +89,89 @@ export interface DsRecord {
     /** Hex digest of the DNSKEY */
     digest: string;
 }
+export interface HostnameBinding {
+    id: string;
+    hostname_pattern: string;
+    kind: "exact" | "wildcard";
+    browser_mode: "stateless" | "dedicated_site" | "trusted_same_site";
+    status: "manual_setup_required" | "pending_dns" | "pending_certificate" | "active" | "degraded" | "disabled" | "suspended";
+    certificate_status: string;
+    installed_records: DnsRecord[];
+    last_verified_at?: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface HostnameBindingPlan {
+    hostname_pattern: string;
+    kind: "exact" | "wildcard";
+    browser_mode: "stateless" | "dedicated_site" | "trusted_same_site";
+    managed_dns: boolean;
+    zone_version: string;
+    certificate_kind: "exact" | "wildcard";
+    required_records: DnsRecord[];
+    conflicts: ({
+        code: "HOSTNAME_BINDING_DNS_CONFLICT" | "APEX_WEB_MODE_CONFLICT";
+        message: string;
+        record?: DnsRecord;
+    })[];
+    required_acknowledgements: string[];
+    warnings: string[];
+}
+export interface HostnameBindingReceipt {
+    hostname_binding: HostnameBinding;
+    idempotency_key: string;
+    idempotent_replay: boolean;
+    pending?: boolean;
+    manual_records?: DnsRecord[];
+}
+export interface HttpRoute {
+    id: string;
+    url: string;
+    hostname: string;
+    domain: string;
+    upstream: string;
+    /** Names of write-only headers injected toward the upstream; values are never returned */
+    upstream_header_names: string[];
+    host_header: "public" | "upstream";
+    browser_mode: "stateless" | "dedicated_site" | "trusted_same_site";
+    upstream_verification: {
+        mode: "none" | "signed_headers";
+        secret?: string;
+    };
+    status: "active" | "expired" | "deleted" | "suspended";
+    revision: number;
+    expires_at: string;
+    created_at: string;
+    updated_at?: string;
+    created_by: {
+        type: "user" | "agent" | "token";
+        id: string;
+        label: string;
+    };
+}
+export interface HttpRouteReceipt {
+    http_route: HttpRoute;
+    idempotency_key: string;
+    idempotent_replay: boolean;
+    hint?: string;
+}
+export interface HttpRouteVerificationReceipt {
+    http_route: HttpRoute;
+    upstream_verification: {
+        mode: "signed_headers";
+        secret: string;
+    };
+    idempotency_key: string;
+    idempotent_replay: boolean;
+    hint?: string;
+}
+export interface HttpRouteHeadersReceipt {
+    http_route: HttpRoute;
+    upstream_header_names: string[];
+    idempotency_key: string;
+    idempotent_replay: boolean;
+    hint?: string;
+}
 export interface AgentIdentity {
     /** Stable identity id used to bind scoped API tokens */
     id: string;
@@ -147,7 +232,7 @@ export interface MailRule {
     match_field?: "from" | "to" | "subject" | "body";
     match_op?: "contains" | "equals" | "regex";
     match_value?: string;
-    action?: "drop" | "mark_read" | "forward" | "webhook_only" | "label";
+    action?: "drop" | "mark_read" | "forward" | "webhook_only" | "label" | "escalate";
     action_arg?: string | null;
     enabled?: boolean;
     created_at?: string;
@@ -157,7 +242,7 @@ export interface MailboxOperationReceipt {
     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";
+    action: "move" | "mark_read" | "star" | "restore" | "delete_permanently" | "label";
     status: "succeeded" | "partial";
     results: ({
         message_id: string;
@@ -183,7 +268,7 @@ export interface LegacyMailboxOperationReceipt {
     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";
+    action: "move" | "mark_read" | "star" | "restore" | "delete_permanently" | "label";
     status: "succeeded" | "partial";
     results: ({
         message_id: string;
@@ -219,6 +304,138 @@ export interface WorkspaceSummary {
     }[];
     created_at: string;
 }
+export interface AssistantSettings {
+    enabled?: boolean;
+    shadow_enabled?: boolean;
+    paused?: boolean;
+    mailbox_ids?: string[];
+    /** Mailboxes operated by your agents. Their items appear in the agents section of Today instead of Needs you. */
+    agent_mailbox_ids?: string[];
+    /** Your agent identities, for delegation. */
+    agents?: ({
+        slug?: string;
+        name?: string;
+        emoji?: string | null;
+    })[];
+    /** Mailboxes whose mail is searched by words only: their messages are never sent to the embedding model. */
+    search_opt_out_mailbox_ids?: string[];
+    history_window_days?: number;
+    privacy_route?: "private_cloud";
+    attachment_vision?: boolean;
+    pipeline_version?: string;
+    consent?: {
+        required_version?: string;
+        accepted_version?: string | null;
+        accepted_at?: string | null;
+    };
+    mailboxes?: ({
+        id?: string;
+        slug?: string;
+        domain?: string;
+        name?: string | null;
+        kind?: string;
+        address?: string;
+    })[];
+}
+export interface AssistantWorkItem {
+    id?: string;
+    version?: number;
+    status?: "open" | "needs_judgment" | "snoozed" | "waiting" | "handled" | "ignored";
+    title?: string;
+    summary?: string;
+    /** The single thing the owner must do or decide, or null. */
+    ask?: string | null;
+    sender?: {
+        address?: string;
+        name?: string | null;
+        kind?: "human" | "automated" | "self" | "harness";
+    } | null;
+    /** How often this same situation came back: one item, N messages. */
+    recurrence?: {
+        count?: number;
+        first_seen_at?: string | null;
+        last_seen_at?: string | null;
+    };
+    mailbox?: {
+        id?: string;
+        address?: string;
+        name?: string | null;
+        operator?: "human" | "agent";
+        agent?: {
+            name?: string;
+            emoji?: string | null;
+        } | null;
+    };
+    opened_at?: string | null;
+    /** The slug of the agent the owner handed this item to, or null. */
+    delegated_to?: string | null;
+    /** True until the owner opens the item after its latest change. */
+    unread?: boolean;
+    /** The source messages behind this item, newest first. */
+    messages?: ({
+        id?: string;
+        subject?: string | null;
+        from?: string;
+        received_at?: string;
+        conversation_id?: string | null;
+    })[];
+    /** What already happened in this matter, oldest first: one line per earlier message. */
+    history?: {
+        message_id?: string;
+        occurred_at?: string;
+        sender?: string;
+        title?: string;
+    }[];
+    source?: {
+        type?: string;
+        conversation_id?: string | null;
+        event_id?: string;
+        revision?: number;
+    };
+    attention?: {
+        level?: "now" | "needs_you" | "fyi" | "quiet";
+        reason?: string;
+        confidence?: string;
+        deadline?: string | null;
+    };
+    analysis?: {
+        coverage?: string;
+        warnings?: string[];
+    };
+    evidence_refs?: string[];
+    entity_refs?: string[];
+    snoozed_until?: string | null;
+    decision?: {
+        id?: string;
+        version?: number;
+        status?: string;
+        question?: string;
+        options?: {
+            id?: string;
+            label?: string;
+            recommended?: boolean;
+            outcome?: string;
+        }[];
+    } | null;
+    plan?: {
+        id?: string;
+        status?: string;
+        expires_at?: string;
+    } | null;
+}
+export interface AssistantTodayView {
+    type?: "today";
+    as_of?: string;
+    projection_lag_ms?: number;
+    sections?: {
+        now?: AssistantWorkItem[];
+        needs_you?: AssistantWorkItem[];
+        agents?: AssistantWorkItem[];
+        waiting?: AssistantWorkItem[];
+        upcoming?: AssistantWorkItem[];
+        handled?: AssistantWorkItem[];
+    };
+}
 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;
@@ -378,6 +595,197 @@ export interface MailActivity {
     metadata: Record<string, unknown>;
     created_at: string;
 }
+export interface EmailThread {
+    /** Thread id, the id of its first message */
+    id: string;
+    /** Subject of the first message */
+    subject?: string | null;
+    /** Every address that wrote or received in the thread */
+    participants: string[];
+    message_count: number;
+    /** Unread inbound messages */
+    unread_count: number;
+    starred: boolean;
+    has_attachments: boolean;
+    first_message_at: string;
+    last_message_at: string;
+    last_message: {
+        id: string;
+        direction: "in" | "out";
+        from: string;
+        to: string;
+        subject?: string | null;
+        snippet: string;
+        folder: string;
+        is_read: boolean;
+        created_at: string;
+    };
+}
+export interface AssistantBrief {
+    id: string;
+    version: number;
+    generated_at: string;
+    title: string;
+    summary: string;
+    ask?: string | null;
+    mailbox?: {
+        id?: string;
+        address?: string;
+        name?: string | null;
+        operator?: "human" | "agent";
+    };
+    delegated_to?: string | null;
+    situation: {
+        key?: string;
+        status?: string;
+        attention?: {
+            level?: string;
+            reason?: string;
+            confidence?: string;
+            deadline?: string | null;
+        };
+        occurrences?: number;
+        first_seen_at?: string | null;
+        last_seen_at?: string | null;
+        sender?: {
+            address?: string;
+            name?: string | null;
+            kind?: string;
+        } | null;
+    };
+    /** Every mail of the situation, oldest first, with the one-line title the analysis gave it */
+    story: {
+        message_id?: string;
+        occurred_at?: string;
+        sender?: string;
+        title?: string;
+        analysed?: boolean;
+    }[];
+    facts: ({
+        key?: string | null;
+        subject?: string | null;
+        predicate?: string | null;
+        object?: string | null;
+        value?: {
+            type?: string;
+            value?: string | null;
+            currency?: string | null;
+        } | null;
+        basis?: string | null;
+        confidence?: number | null;
+        valid_from?: string | null;
+        valid_until?: string | null;
+        sensitivity?: string;
+        evidence_refs?: string[];
+        seen_at?: string;
+    })[];
+    entities: {
+        kind?: string;
+        name?: string;
+        aliases?: string[];
+        ref?: string;
+    }[];
+    /** Open promises made by the owner's side */
+    commitments: ({
+        id?: string;
+        who?: string;
+        owed_to?: string | null;
+        what?: string;
+        due_at?: string | null;
+        overdue?: boolean;
+        status?: string;
+    })[];
+    /** Open things awaited from others */
+    expectations: ({
+        id?: string;
+        who?: string;
+        what?: string;
+        due_at?: string | null;
+        overdue?: boolean;
+        status?: string;
+    })[];
+    /** Closed loops and receipts, newest first */
+    settled: ({
+        kind?: "commitment" | "expectation" | "receipt";
+        who?: string;
+        what?: string;
+        status?: string;
+        at?: string;
+    })[];
+    awaiting: ({
+        who?: string;
+        what?: string;
+        since?: string;
+        due_at?: string | null;
+        overdue?: boolean;
+    })[];
+    /** The current prepared Decision with its options */
+    decision?: Record<string, unknown> | null;
+    suggested_next: {
+        action?: string;
+        reason?: string;
+        source?: "decision" | "rule";
+    } | null;
+    evidence: ({
+        id?: string;
+        subject?: string | null;
+        from?: string;
+        received_at?: string;
+        conversation_id?: string | null;
+    })[];
+    evidence_refs?: string[];
+}
+export interface Fact {
+    key?: string | null;
+    subject?: string | null;
+    predicate?: string | null;
+    object?: string | null;
+    value?: {
+        type?: "string" | "date" | "money";
+        value?: string | null;
+        currency?: string | null;
+    } | null;
+    basis?: "source_explicit" | "source_implied" | "model_inference" | null | null;
+    confidence?: number | null;
+    valid_from?: string | null;
+    valid_until?: string | null;
+    sensitivity?: string;
+    evidence_refs?: string[];
+    seen_at?: string;
+}
+export interface MessageFacts {
+    message_id: string;
+    thread_id: string;
+    analysed: boolean;
+    /** Only when analysed is false */
+    reason?: "not_enabled" | "not_analysed";
+    analysis?: {
+        id?: string;
+        generated_at?: string;
+        coverage?: string;
+        warnings?: string[];
+        pipeline_version?: string;
+    };
+    facts: Fact[];
+    entities: {
+        kind?: string;
+        name?: string;
+        aliases?: string[];
+        ref?: string;
+    }[];
+    commitments: ({
+        who?: string;
+        what?: string;
+        due_at?: string | null;
+        evidence_refs?: string[];
+    })[];
+    expectations: ({
+        who?: string;
+        what?: string;
+        due_at?: string | null;
+        evidence_refs?: string[];
+    })[];
+}
 export interface MailboxChange {
     /** Monotonic sequence serialized as a string */
     sequence: string;
@@ -458,6 +866,7 @@ export interface DomainBrief {
             detectedAt: string;
             type: "identity" | "content" | "redirect" | "registration";
             summary: string;
+            data?: Record<string, unknown>;
             evidenceIds: string[];
         })[];
     };
@@ -523,6 +932,7 @@ export interface DomainBrief {
         claimKey: string;
         label: string;
         value: string;
+        data?: Record<string, unknown>;
         source: string;
         sourceUrl?: string;
         confidence: "high" | "medium" | "low";
@@ -559,11 +969,57 @@ export interface Backorder {
     caught_at?: string | null;
     /** ID of the Domain created when caught */
     registered_domain_id?: string | null;
-    failure_reason?: string | null;
+    /** Stable, language-independent failure code. Internal registrar prose is never returned. */
+    failure_reason?: "price_cap" | "registration_race" | "marketplace_listing" | "payment" | "registrar" | "unavailable" | "unexpected" | "unspecified" | null;
     /** When the watch window ends */
     expires_at?: string;
     created_at?: string;
 }
+export interface BuyDomainItem {
+    domain: string;
+    status: "active" | "provisioning";
+    expires?: string | null;
+    price: number;
+    currency: string;
+    years: number;
+    payment_method: "card" | "balance" | "x402" | "crypto";
+    payment_tx?: string;
+    auto_renew: boolean;
+    marketplace_purchase?: boolean;
+}
+export interface BuyDomainFailure {
+    domain: string;
+    error: string;
+    failure_code: "registration_race" | "payment" | "registrar" | "unexpected" | "marketplace_listing";
+}
+export interface BuyDomainRegistrationError {
+    error: string;
+    code: "REGISTRATION_FAILED";
+    failure_code: "payment" | "registrar" | "unexpected";
+    refunded?: boolean;
+    hint?: string;
+    documentation_url?: string;
+}
+export interface BuyDomainAvailabilityError {
+    error: string;
+    code: "DOMAIN_UNAVAILABLE";
+    failure_code: "registration_race";
+    hint?: string;
+    documentation_url?: string;
+}
+export interface BuyDomainBulkResult {
+    results: BuyDomainItem[];
+    errors: BuyDomainFailure[];
+    summary: {
+        total: number;
+        succeeded: number;
+        failed: number;
+        charged: number;
+        refunded: number;
+    };
+    hint: string;
+    next_steps: string[];
+}
 export interface DealInvoice {
     deal_id?: string;
     domain?: string;
@@ -668,7 +1124,7 @@ export interface TokenInfo {
     /** Whether this token has expired */
     expired?: boolean;
     /** Permission scopes granted to this token. ['*'] means full access. */
-    scopes?: string[];
+    scopes: string[];
     createdAt: string;
     /** Per-transaction spend cap in USD (null = uncapped) */
     max_per_tx?: number | null;
@@ -678,6 +1134,9 @@ export interface TokenInfo {
     spent_this_month?: number;
     /** Id of the token that minted this one (null = created via dashboard/session) */
     parent_token_id?: string | null;
+    /** Mailbox ids this token is confined to. Empty means no mailbox-id confinement. */
+    mailbox_ids: string[];
+    http_route_policy: HttpRoutePolicy | null;
     /** Agent identity represented by this token. Its mail actions are attributed to this agent. */
     agent_identity?: {
         id?: string;
@@ -685,6 +1144,19 @@ export interface TokenInfo {
         slug?: string;
     } | null;
 }
+export interface HttpRoutePolicy {
+    hostname_rules: ({
+        domain: string;
+        kind: "exact";
+        hostname: string;
+    } | {
+        domain: string;
+        kind: "subdomain_prefix";
+        prefix: string;
+    })[];
+    max_concurrent: number;
+    max_lease_seconds: number;
+}
 export interface Contact {
     /** Contact name */
     name?: string | null;
@@ -757,6 +1229,9 @@ export interface AccountInfo {
     domain_count: number;
     /** Number of active API tokens */
     token_count: number;
+    /** Feature flags enabled for this account (GA features plus the preview features granted to the user), e.g. mailzero_assistant */
+    features?: string[];
+    is_admin?: boolean;
     created_at: string;
 }
 export interface ActivationProjection {
@@ -798,19 +1273,26 @@ export declare class Domani {
     request<T = unknown>(method: string, path: string, opts?: {
         query?: Record<string, unknown>;
         body?: unknown;
+        headers?: Record<string, string | undefined>;
     }): Promise<T>;
+    /** Open a server-sent event stream; read `response.body` with an SSE parser. */
+    stream(method: string, path: string, opts?: {
+        query?: Record<string, unknown>;
+        headers?: Record<string, string | undefined>;
+        signal?: AbortSignal;
+    }): Promise<Response>;
     /** Accept an access or ownership offer (POST /api/workspaces/access/offers/accept) */
     acceptWorkspaceAccessOffer(body: {
         token: string;
-    }): Promise<unknown>;
+    }): Promise<void>;
     /** Accept a workspace invitation (POST /api/workspaces/invitations/accept) */
     acceptWorkspaceInvitation(body: {
         token: string;
-    }): Promise<unknown>;
+    }): Promise<void>;
     /** Accept workspace ownership (POST /api/workspaces/ownership-transfers/accept) */
     acceptWorkspaceOwnershipTransfer(body: {
         token: string;
-    }): Promise<unknown>;
+    }): Promise<void>;
     /** Add a private conversation note (POST /api/email/collaboration/{id}/notes) */
     addConversationNote(id: string, body: {
         body: string;
@@ -837,7 +1319,7 @@ export declare class Domani {
         match_field: "from" | "to" | "subject" | "body";
         match_op: "contains" | "equals" | "regex";
         match_value: string;
-        action: "drop" | "mark_read" | "forward" | "webhook_only" | "label";
+        action: "drop" | "mark_read" | "forward" | "webhook_only" | "label" | "escalate";
         action_arg?: string;
         priority?: number;
         enabled?: boolean;
@@ -856,7 +1338,7 @@ export declare class Domani {
     /** Adopt an owned mailbox into a workspace (POST /api/workspaces/{id}/mailboxes) */
     attachWorkspaceMailbox(id: string, body: {
         mailbox_id: string;
-    }): Promise<unknown>;
+    }): Promise<void>;
     /** Buy an aftermarket domain (POST /api/domains/{domain}/buy-aftermarket) */
     buyAftermarket(domain: string, body?: {
         max_price?: number;
@@ -884,17 +1366,7 @@ export declare class Domani {
         years?: number;
         max_price?: number;
         ref?: string;
-    }): Promise<{
-        domain?: string;
-        status?: "active";
-        expires?: string;
-        price?: number;
-        currency?: string;
-        years?: number;
-        payment_method?: "card" | "x402" | "crypto";
-        payment_tx?: string;
-        marketplace_purchase?: boolean;
-    }>;
+    }, paymentSignature?: string): Promise<BuyDomainItem | BuyDomainBulkResult>;
     /** Cancel a backorder (DELETE /api/backorders/{id}) */
     cancelBackorder(id: string): Promise<{
         id?: string;
@@ -1047,6 +1519,33 @@ export declare class Domani {
         next_steps?: string[];
         diff?: Record<string, unknown>;
     }>;
+    /** Give an agent its own API key in one call (POST /api/agents/identity/{slug}/tokens) */
+    createAgentToken(slug: string, body?: {
+        name?: string;
+        scopes?: string[];
+        mailboxes?: string[];
+        expires_in?: number;
+    }): Promise<{
+        success?: boolean;
+        token?: {
+            id?: string;
+            name?: string;
+            key?: string;
+            scopes?: string[];
+            mailbox_ids?: string[];
+            expires_at?: string | null;
+            agent_identity?: {
+                id?: string;
+                name?: string | null;
+                slug?: string;
+            } | null;
+        };
+        agent?: {
+            slug?: string;
+            name?: string | null;
+        };
+        hint?: string;
+    }>;
     /** Place a backorder on a taken domain (POST /api/backorders) */
     createBackorder(body: {
         domain: string;
@@ -1080,6 +1579,22 @@ export declare class Domani {
     }): Promise<{
         brief: DomainBrief;
     }>;
+    /** Create an HTTP hostname binding (POST /api/domains/{domain}/hostname-bindings) */
+    createHostnameBinding(domain: string, body: {
+        hostname: string;
+        browser_mode?: "stateless" | "dedicated_site" | "trusted_same_site";
+        expected_zone_version?: string;
+        acknowledgements?: string[];
+    }, idempotencyKey: string): Promise<HostnameBindingReceipt>;
+    /** Publish a leased HTTP route (POST /api/http-routes) */
+    createHttpRoute(body: {
+        hostname?: string;
+        upstream: string;
+        expires_in?: number;
+        host_header?: "public" | "upstream";
+        upstream_verification?: "none" | "signed_headers";
+        upstream_headers?: Record<string, string>;
+    }, idempotencyKey: string): Promise<HttpRouteReceipt>;
     /** List a domain for sale (PUT /api/domains/{domain}/for-sale) */
     createListing(domain: string, body: {
         price: number;
@@ -1180,6 +1695,21 @@ export declare class Domani {
         max_per_tx?: number;
         max_per_month?: number;
         agent_identity_id?: string;
+        http_route_policy?: {
+            hostname_rules: ({
+                domain: string;
+                kind: "exact";
+                hostname: string;
+            } | {
+                domain: string;
+                kind: "subdomain_prefix";
+                prefix: string;
+            })[];
+            max_concurrent?: number;
+            max_lease_seconds?: number;
+            acknowledge_apex_delegation?: boolean;
+        };
+        mailboxes?: string[];
     }): Promise<{
         id?: string;
         name?: string;
@@ -1189,6 +1719,8 @@ export declare class Domani {
         createdAt?: string;
         max_per_tx?: number | null;
         max_per_month?: number | null;
+        mailbox_ids?: string[];
+        http_route_policy?: HttpRoutePolicy | null;
         agent_identity?: {
             id?: string;
             name?: string | null;
@@ -1199,7 +1731,7 @@ export declare class Domani {
     createWebhook(body: {
         url: string;
         events: string[];
-        headers?: Record<string, unknown>;
+        headers?: Record<string, string>;
     }): Promise<{
         id?: string;
         url?: string;
@@ -1213,7 +1745,7 @@ export declare class Domani {
     /** Create a workspace (POST /api/workspaces) */
     createWorkspace(body: {
         name: string;
-    }): Promise<unknown>;
+    }): Promise<void>;
     /** Offer mailbox access or workspace ownership (POST /api/workspaces/{id}/access/offers) */
     createWorkspaceAccessOffer(id: string, body: {
         email: string;
@@ -1221,7 +1753,7 @@ export declare class Domani {
         ownership_disposition?: "unchanged" | "claim";
         creator_disposition?: "stay" | "stay_admin" | "leave";
         billing_disposition?: "unchanged" | "sponsor" | "transfer";
-    }): Promise<unknown>;
+    }): Promise<void>;
     /** Start Mailzero workspace checkout (POST /api/workspaces/{id}/billing/checkout) */
     createWorkspaceCheckout(id: string, body: {
         plan: "mail_solo" | "mail_team" | "mail_business";
@@ -1235,6 +1767,19 @@ export declare class Domani {
         deleted?: boolean;
         hint?: string;
     }>;
+    /** Delete assistant-derived data (DELETE /api/assistant/data) */
+    deleteAssistantData(): Promise<{
+        ok?: boolean;
+        deleted?: {
+            work_items?: number;
+            claims?: number;
+            entities?: number;
+            jobs?: number;
+        };
+        source_mail_deleted?: false;
+    }>;
+    /** Delete a contact (DELETE /api/contacts/{address}) */
+    deleteContact(address: string): Promise<void>;
     /** Remove a DNSSEC DS record (disable DNSSEC) (DELETE /api/domains/{domain}/dnssec) */
     deleteDnssecRecord(domain: string, query?: {
         keyTag: string;
@@ -1244,10 +1789,18 @@ export declare class Domani {
         enabled?: boolean;
         records?: DsRecord[];
     }>;
+    /** Disable an HTTP hostname binding (DELETE /api/domains/{domain}/hostname-bindings/{id}) */
+    deleteHostnameBinding(domain: string, id: string): Promise<{
+        disabled: boolean;
+        cleanup_pending: boolean;
+        manual_cleanup_records?: DnsRecord[];
+    }>;
+    /** Terminate a route without releasing its hostname claim (DELETE /api/http-routes/{id}) */
+    deleteHttpRoute(id: string): Promise<void>;
     /** Delete a mailbox (DELETE /api/emails/{address}) */
     deleteMailboxByAddress(address: string, body?: {
         confirm?: boolean;
-    }): Promise<unknown>;
+    }): Promise<void>;
     /** Delete a message (DELETE /api/emails/{address}/messages/{id}) */
     deleteMessageByAddress(address: string, id: string): Promise<{
         id?: string;
@@ -1257,7 +1810,7 @@ export declare class Domani {
     deleteMessagesByAddress(address: string, body?: {
         message_ids: string[];
         idempotency_key?: string;
-    }): Promise<LegacyMailboxOperationReceipt>;
+    }, idempotencyKey?: string): Promise<LegacyMailboxOperationReceipt>;
     /** Delete webhook (DELETE /api/webhooks/{id}) */
     deleteWebhook(id: string): Promise<{
         success?: boolean;
@@ -1272,6 +1825,48 @@ export declare class Domani {
         taken?: string[];
         candidates?: string[];
     }>;
+    /** Flag a message for a human (POST /api/emails/{address}/messages/{id}/escalate) */
+    escalateMessageByAddress(address: string, id: string, body?: {
+        reason?: string;
+        clear?: boolean;
+    }): Promise<{
+        id?: string;
+        needs_human?: boolean;
+        escalation_reason?: string | null;
+        thread_key?: string;
+    }>;
+    /** OAuth token endpoint (POST /api/oauth/token) */
+    exchangeOAuthToken(): Promise<{
+        access_token?: string;
+        token_type?: string;
+        expires_in?: number;
+        refresh_token?: string;
+        scope?: string;
+    }>;
+    /** Export derived assistant data (GET /api/assistant/data) */
+    exportAssistantData(): Promise<{
+        format?: "mailzero-derived-export.v1";
+        exported_at?: string;
+        note?: string;
+    }>;
+    /** Extract the fields you need from a message with your own schema (POST /api/emails/{address}/messages/{id}/extract) */
+    extractFromEmailMessage(address: string, id: string, body: {
+        schema: Record<string, unknown>;
+        instructions?: string;
+    }): Promise<{
+        message_id: string;
+        data: Record<string, unknown>;
+        confidence: number;
+        evidence_quotes: string[];
+        model: string;
+        cached: boolean;
+        generated_at: string;
+        usage?: {
+            input_tokens?: number;
+            output_tokens?: number;
+            latency_ms?: number;
+        };
+    }>;
     /** Finalize an agreed negotiation (pay) (POST /api/negotiations/{id}/finalize) */
     finalizeNegotiation(id: string, body?: {
         payment_method?: "card" | "usdc" | "balance";
@@ -1295,6 +1890,127 @@ export declare class Domani {
     getAccount(): Promise<AccountInfo>;
     /** Get truthful activation state and recommended next actions (GET /api/me/activation) */
     getActivation(): Promise<ActivationProjection>;
+    /** Get the exact action preview by opaque ID (GET /api/assistant/action-plans/{id}) */
+    getAssistantActionPlan(id: string): Promise<{
+        id?: string;
+        status?: "proposed" | "approved" | "executed" | "stale" | "expired";
+        expires_at?: string;
+        source_revision?: number;
+        effects?: ({
+            kind?: "reply";
+            mailbox_id?: string;
+            reply_to_message_id?: string;
+            body?: string;
+            commitments?: Record<string, unknown>[];
+            expected_reply?: Record<string, unknown> | null;
+        })[];
+    }>;
+    /** Get content-minimized assistant Activity (GET /api/assistant/activity) */
+    getAssistantActivity(query?: {
+        limit?: number;
+    }): Promise<{
+        type?: "activity";
+        as_of?: string;
+        events?: ({
+            id?: string;
+            kind?: "interaction" | "receipt";
+            action?: string;
+            status?: string;
+            actor?: string;
+            work_item?: {
+                id?: string;
+                title?: string;
+            };
+            occurred_at?: string;
+        })[];
+    }>;
+    /** Get background history-import progress (GET /api/assistant/backfill) */
+    getAssistantBackfill(): Promise<{
+        backfill?: {
+            id?: string;
+            status?: "queued" | "scanning" | "processing" | "completed" | "cancelled";
+            phase?: string;
+            paused?: boolean;
+            processed?: number;
+            total?: number;
+            failed?: number;
+            percent?: number | null;
+            estimated_seconds_remaining?: number | null;
+            estimated_completion_at?: string | null;
+            can_close_app?: boolean;
+            started_at?: string;
+            completed_at?: string | null;
+        } | null;
+    }>;
+    /** Read the situation brief for a correspondent (GET /api/assistant/brief) */
+    getAssistantCorrespondentBrief(query?: {
+        correspondent: string;
+        mailbox?: string;
+    }): Promise<{
+        correspondent: string;
+        mailboxes: string[];
+        brief: AssistantBrief | unknown;
+        related: {
+            id?: string;
+            title?: string;
+            status?: string;
+            attention_level?: string;
+            occurrences?: number;
+            last_seen_at?: string;
+        }[];
+        recent_mail: ({
+            id?: string;
+            thread_id?: string;
+            subject?: string | null;
+            mailbox?: string;
+            received_at?: string;
+        })[];
+        generated_at: string;
+    }>;
+    /** Get Mailzero assistant settings (GET /api/assistant/settings) */
+    getAssistantSettings(): Promise<AssistantSettings>;
+    /** Get the grounded Today decision queue (GET /api/assistant/today) */
+    getAssistantToday(query?: {
+        agent?: string;
+    }): Promise<AssistantTodayView>;
+    /** Get one assistant Work item and exact current plan (GET /api/assistant/work-items/{id}) */
+    getAssistantWorkItem(id: string): Promise<AssistantWorkItem>;
+    /** Read the situation brief of a Work item (GET /api/assistant/work-items/{id}/brief) */
+    getAssistantWorkItemBrief(id: string): Promise<AssistantBrief>;
+    /** Read the facts behind a Work item (GET /api/assistant/work-items/{id}/facts) */
+    getAssistantWorkItemFacts(id: string): Promise<{
+        work_item_id: string;
+        version?: number;
+        analysed: boolean;
+        analyses?: {
+            id?: string;
+            generated_at?: string;
+            coverage?: string;
+        }[];
+        facts: Fact[];
+        entities: {
+            kind?: string;
+            name?: string;
+            aliases?: string[];
+            ref?: string;
+        }[];
+        commitments: ({
+            id?: string;
+            who?: string;
+            owed_to?: string | null;
+            what?: string;
+            due_at?: string | null;
+            status?: string;
+        })[];
+        expectations: ({
+            id?: string;
+            who?: string;
+            what?: string;
+            due_at?: string | null;
+            status?: string;
+        })[];
+        evidence_refs?: string[];
+    }>;
     /** Get EPP auth code (GET /api/domains/{domain}/auth-code) */
     getAuthCode(domain: string): Promise<{
         domain: string;
@@ -1440,7 +2156,7 @@ export declare class Domani {
             }[];
         };
         sending_health: {
-            recipients?: Record<string, unknown>;
+            recipients?: Record<string, number>;
             rates?: {
                 bounce?: number;
                 complaint?: number;
@@ -1466,6 +2182,16 @@ export declare class Domani {
         })[];
         caveats?: string[];
     }>;
+    /** Read what the assistant established about a message (GET /api/emails/{address}/messages/{id}/facts) */
+    getEmailMessageFacts(address: string, id: string): Promise<MessageFacts>;
+    /** Get an HTTP hostname binding (GET /api/domains/{domain}/hostname-bindings/{id}) */
+    getHostnameBinding(domain: string, id: string): Promise<{
+        hostname_binding: HostnameBinding;
+    }>;
+    /** Get a leased HTTP route (GET /api/http-routes/{id}) */
+    getHttpRoute(id: string): Promise<{
+        http_route: HttpRoute;
+    }>;
     /** Get mailbox avatar info (GET /api/emails/{address}/avatar) */
     getMailboxAvatarByAddress(address: string): Promise<{
         address?: string;
@@ -1509,18 +2235,52 @@ export declare class Domani {
         };
         hint?: string;
     }>;
+    /** Read one conversation, oldest message first (GET /api/emails/{address}/threads/{id}) */
+    getMailboxThread(address: string, id: string): Promise<{
+        id: string;
+        subject?: string | null;
+        participants: string[];
+        message_count: number;
+        unread_count: number;
+        first_message_at?: string;
+        last_message_at?: string;
+        messages: ({
+            id?: string;
+            thread_id?: string;
+            labels?: string[];
+            message_id?: string | null;
+            direction?: "in" | "out";
+            from?: string;
+            to?: string;
+            cc?: string | null;
+            subject?: string | null;
+            text?: string | null;
+            html?: string | null;
+            in_reply_to?: string | null;
+            references?: string | null;
+            folder?: string;
+            is_read?: boolean;
+            starred?: boolean;
+            label?: string | null;
+            status?: string;
+            created_at?: string;
+        })[];
+    }>;
     /** Get mailbox webhook config (GET /api/emails/{address}/webhook) */
     getMailboxWebhook(address: string): Promise<{
         address?: string;
         webhook_url?: string | null;
         signing_secret?: string | null;
         has_webhook?: boolean;
+        events?: string[];
         header_names?: string[];
         hint?: string;
     }>;
     /** Get a message (GET /api/emails/{address}/messages/{id}) */
     getMessageByAddress(address: string, id: string): Promise<{
         id?: string;
+        thread_id?: string;
+        labels?: string[];
         thread_key?: string;
         thread_aliases?: string[];
         message_id?: string | null;
@@ -1656,7 +2416,7 @@ export declare class Domani {
     /** 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>;
+    getWorkspaceAccess(id: string): Promise<void>;
     /** Heartbeat viewing or composing presence (PUT /api/email/collaboration/coordination) */
     heartbeatConversationPresence(body: {
         mailbox_id: string;
@@ -1680,15 +2440,37 @@ export declare class Domani {
         };
         hint?: string;
     }>;
+    /** Record a fenced human Decision (POST /api/assistant/work-items/{id}/interactions) */
+    interactWithAssistantWorkItem(id: string, body: {
+        scope?: "item" | "sender" | "sender_domain" | "situation";
+        type: "choose" | "instruct" | "take_over" | "snooze" | "ignore" | "correct" | "delegate";
+        agent_slug?: string | null;
+        work_item_version: number;
+        decision_id?: string;
+        decision_version?: number;
+        option_id?: string;
+        instruction?: string;
+        until?: string;
+        remind_at?: string;
+        field?: string;
+        correction?: string;
+        idempotency_key: string;
+    }): Promise<{
+        ok?: boolean;
+        work_item?: AssistantWorkItem;
+        plan_id?: string | null;
+    }>;
     /** Invite a workspace member (POST /api/workspaces/{id}/invitations) */
     inviteWorkspaceMember(id: string, body: {
         email: string;
         role?: "admin" | "member";
         mailbox_ids?: string[];
         mailbox_role?: "viewer" | "responder" | "manager";
-    }): Promise<unknown>;
+    }): Promise<void>;
     /** Leave a workspace (DELETE /api/workspaces/{id}/members/me) */
-    leaveWorkspace(id: string): Promise<unknown>;
+    leaveWorkspace(id: string): Promise<void>;
+    /** List the API tokens of an agent identity (GET /api/agents/identity/{slug}/tokens) */
+    listAgentTokens(slug: string): Promise<unknown>;
     /** List security audit events (GET /api/audit) */
     listAuditEvents(query?: {
         limit?: number;
@@ -1727,6 +2509,24 @@ export declare class Domani {
             email?: Record<string, unknown>[];
         };
     }>;
+    /** List contacts (GET /api/contacts) */
+    listContacts(query?: {
+        q?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        contacts?: ({
+            address?: string;
+            name?: string | null;
+            notes?: string | null;
+            source?: "auto" | "manual";
+            message_count?: number;
+            first_seen_at?: string;
+            last_seen_at?: string;
+            last_direction?: string | null;
+        })[];
+        next_cursor?: string | null;
+    }>;
     /** List attributed conversation activity (GET /api/email/collaboration/{id}/activity) */
     listConversationActivity(id: string): Promise<{
         activity: MailActivity[];
@@ -1778,7 +2578,7 @@ export declare class Domani {
             unread?: number;
         })[];
         views?: ({
-            id?: "starred" | "all";
+            id?: "starred" | "all" | "needs_human";
             total?: number;
             unread?: number;
         })[];
@@ -1790,7 +2590,8 @@ export declare class Domani {
         limit?: number;
         direction?: "in" | "out" | "all";
         folder?: "inbox" | "archive" | "sent" | "spam" | "trash";
-        view?: "starred" | "all";
+        label?: string;
+        view?: "starred" | "all" | "needs_human";
         since?: string;
         from?: string;
         to?: string;
@@ -1802,6 +2603,8 @@ export declare class Domani {
     }): Promise<{
         messages?: ({
             id?: string;
+            thread_id?: string;
+            labels?: string[];
             thread_key?: string;
             thread_aliases?: string[];
             message_id?: string | null;
@@ -1809,6 +2612,10 @@ export declare class Domani {
             folder?: "inbox" | "archive" | "sent" | "spam" | "trash";
             read?: boolean;
             starred?: boolean;
+            needs_human?: boolean;
+            escalation_reason?: string | null;
+            remind_at?: string | null;
+            reminder_note?: string | null;
             answered?: boolean;
             forwarded?: boolean;
             spam_detected?: boolean;
@@ -1828,6 +2635,21 @@ export declare class Domani {
         })[];
         next_cursor?: string | null;
     }>;
+    /** List HTTP hostname bindings (GET /api/domains/{domain}/hostname-bindings) */
+    listHostnameBindings(domain: string): Promise<{
+        hostname_bindings: HostnameBinding[];
+    }>;
+    /** List visible leased HTTP routes (GET /api/http-routes) */
+    listHttpRoutes(query?: {
+        domain?: string;
+        hostname?: string;
+        status?: "active" | "expired" | "deleted" | "suspended" | "all";
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        http_routes: HttpRoute[];
+        next_cursor: string | null;
+    }>;
     /** List your agent identities (GET /api/agents/identity) */
     listIdentities(): Promise<{
         identities?: AgentIdentity[];
@@ -1927,6 +2749,18 @@ export declare class Domani {
             storage_measured_at?: string | null;
         })[];
     }>;
+    /** List the conversations of a mailbox (GET /api/emails/{address}/threads) */
+    listMailboxThreads(address: string, query?: {
+        folder?: "all" | "inbox" | "archive" | "sent" | "spam" | "trash";
+        since?: string;
+        limit?: number;
+        cursor?: string;
+        label?: string;
+    }): Promise<{
+        threads: EmailThread[];
+        next_cursor: string | null;
+        has_more: boolean;
+    }>;
     /** List inbound mail rules (GET /api/emails/{address}/rules) */
     listMailRules(address: string): Promise<{
         mailbox?: string;
@@ -2063,13 +2897,19 @@ export declare class Domani {
         message_ids: string[];
         read: boolean;
         idempotency_key?: string;
-    }): Promise<LegacyMailboxOperationReceipt>;
+    }, idempotencyKey?: string): Promise<LegacyMailboxOperationReceipt>;
     /** Mark notification as read (PATCH /api/notifications/{id}) */
     markNotificationRead(id: string, body: {
         read: boolean;
     }): Promise<{
         ok?: boolean;
     }>;
+    /** Mark a Work item as opened (POST /api/assistant/work-items/{id}/open) */
+    openAssistantWorkItem(id: string): Promise<{
+        ok?: boolean;
+        opened_at?: string;
+        unread?: boolean;
+    }>;
     /** Plan how to adopt an existing domain (GET /api/domains/adoption-plan) */
     planDomainAdoption(query?: {
         domain: string;
@@ -2087,6 +2927,7 @@ export declare class Domani {
             nameservers: string[];
             dns_provider: string;
             dnssec_enabled: boolean;
+            checked_at: string | null;
         };
         options: {
             connect?: {
@@ -2111,6 +2952,12 @@ export declare class Domani {
                 reason?: string;
                 code?: string;
                 eligible_at?: string;
+                guidance?: {
+                    managed_via: string;
+                    unlock: string;
+                    auth_code: string;
+                    notes: string[];
+                };
                 next_action?: {
                     method?: string;
                     path?: string;
@@ -2120,6 +2967,11 @@ export declare class Domani {
         invariants: string[];
         warnings: string[];
     }>;
+    /** Plan an HTTP hostname binding (POST /api/domains/{domain}/hostname-bindings/plan) */
+    planHostnameBinding(domain: string, body: {
+        hostname: string;
+        browser_mode?: "stateless" | "dedicated_site" | "trusted_same_site";
+    }): Promise<HostnameBindingPlan>;
     /** Provide EPP/auth code (seller) (PATCH /api/deals/{id}) */
     provideEppCode(id: string, body: {
         auth_code: string;
@@ -2142,11 +2994,50 @@ export declare class Domani {
         payment_tx?: string;
         payment_chain?: "base" | "ethereum";
         years?: number;
-    }): Promise<ProvisionAgentResult>;
+    }, paymentSignature?: string): Promise<ProvisionAgentResult>;
     /** Refresh a domain brief from live sources (POST /api/domain-briefs/{id}/refresh) */
     refreshDomainBrief(id: string): Promise<{
         brief: DomainBrief;
     }>;
+    /** Refresh a route lease (PATCH /api/http-routes/{id}) */
+    refreshHttpRoute(id: string, body: {
+        expires_in: number;
+    }, idempotencyKey: string): Promise<HttpRouteReceipt>;
+    /** Register a device for redacted Now alerts (POST /api/assistant/devices) */
+    registerAssistantDevice(body: {
+        installation_id: string;
+        platform: "ios" | "android";
+        environment: "development" | "preview" | "production";
+        push_token: string;
+        locale: string;
+        lock_screen_detail?: "redacted" | "sender_only";
+    }): Promise<{
+        ok?: boolean;
+        device?: {
+            id?: string;
+            platform?: string;
+            environment?: string;
+            locale?: string;
+            lockScreenDetail?: string;
+        };
+    }>;
+    /** Register an OAuth client (RFC 7591) (POST /api/oauth/register) */
+    registerOAuthClient(body: {
+        redirect_uris: string[];
+        client_name?: string;
+        token_endpoint_auth_method?: "none" | "client_secret_post" | "client_secret_basic";
+        client_uri?: string;
+        logo_uri?: string;
+    }): Promise<{
+        client_id?: string;
+        client_name?: string;
+        redirect_uris?: string[];
+        token_endpoint_auth_method?: string;
+        grant_types?: string[];
+        response_types?: string[];
+        client_id_issued_at?: number;
+        client_secret?: string;
+    }>;
     /** Create a new account (POST /api/auth/register) */
     registerUser(body: {
         email: string;
@@ -2173,12 +3064,18 @@ export declare class Domani {
         slug?: string;
         released?: boolean;
     }>;
+    /** Revoke a device registration (DELETE /api/assistant/devices) */
+    removeAssistantDevice(query?: {
+        installation_id: string;
+    }): Promise<{
+        ok?: boolean;
+    }>;
     /** Remove saved payment method (DELETE /api/billing/card) */
     removeCard(): Promise<{
         removed?: boolean;
     }>;
     /** Remove email from a domain (DELETE /api/domains/{domain}/email/setup) */
-    removeDomainEmail(domain: string): Promise<unknown>;
+    removeDomainEmail(domain: string): Promise<void>;
     /** Remove a mailbox alias (DELETE /api/emails/{address}/aliases/{alias}) */
     removeMailboxAlias(address: string, alias: string): Promise<{
         address?: string;
@@ -2188,13 +3085,14 @@ export declare class Domani {
     /** Remove a member mailbox permission (DELETE /api/workspaces/{id}/mailboxes/{mailboxId}/grants) */
     removeMailboxGrant(id: string, mailboxId: string, body: {
         membership_id: string;
-    }): Promise<unknown>;
+    }): Promise<void>;
     /** Remove mailbox webhook (DELETE /api/emails/{address}/webhook) */
     removeMailboxWebhook(address: string): Promise<{
         address?: string;
         webhook_url?: string | null;
         signing_secret?: string | null;
         has_webhook?: boolean;
+        events?: string[];
         header_names?: string[];
         hint?: string;
     }>;
@@ -2211,7 +3109,7 @@ export declare class Domani {
         hint?: string;
     }>;
     /** Remove a workspace member (DELETE /api/workspaces/{id}/members/{membershipId}) */
-    removeWorkspaceMember(id: string, membershipId: string): Promise<unknown>;
+    removeWorkspaceMember(id: string, membershipId: string): Promise<void>;
     /** Renew a domain (POST /api/domains/{domain}/renew) */
     renewDomain(domain: string, body?: {
         years?: number;
@@ -2256,7 +3154,7 @@ export declare class Domani {
             lease_id: string;
             expected_reply_version: number;
         };
-    }): Promise<{
+    }, idempotencyKey?: string): Promise<{
         id?: string;
         message_id?: string;
         from?: string;
@@ -2267,7 +3165,7 @@ export declare class Domani {
     /** Request a workspace ownership transfer (POST /api/workspaces/{id}/ownership-transfer) */
     requestWorkspaceOwnershipTransfer(id: string, body: {
         membership_id: string;
-    }): Promise<unknown>;
+    }): Promise<void>;
     /** Research or refresh a public domain profile (POST /api/domains/{domain}/profile) */
     researchPublicDomainProfile(domain: string, query?: {
         depth?: "instant" | "deep";
@@ -2321,6 +3219,16 @@ export declare class Domani {
         dry_run?: boolean;
         would_apply?: DnsRecord[];
     }>;
+    /** Retry failed history-import messages (POST /api/assistant/backfill) */
+    retryAssistantBackfillFailures(): Promise<{
+        ok?: boolean;
+        retried?: number;
+    }>;
+    /** Revoke an agent's API token (DELETE /api/agents/identity/{slug}/tokens/{id}) */
+    revokeAgentToken(slug: string, id: string): Promise<{
+        success?: boolean;
+        hint?: string;
+    }>;
     /** Revoke an app password (hosted) (DELETE /api/emails/{address}/credentials/{id}) */
     revokeMailboxCredential(address: string, id: string): Promise<{
         id?: string;
@@ -2334,11 +3242,17 @@ export declare class Domani {
     /** 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>;
+    }): Promise<void>;
     /** Revoke a pending invitation (DELETE /api/workspaces/{id}/invitations/{invitationId}) */
-    revokeWorkspaceInvitation(id: string, invitationId: string): Promise<unknown>;
+    revokeWorkspaceInvitation(id: string, invitationId: string): Promise<void>;
     /** Revoke a pending ownership transfer (DELETE /api/workspaces/{id}/ownership-transfer/{transferId}) */
-    revokeWorkspaceOwnershipTransfer(id: string, transferId: string): Promise<unknown>;
+    revokeWorkspaceOwnershipTransfer(id: string, transferId: string): Promise<void>;
+    /** Replace write-only upstream authentication headers (PUT /api/http-routes/{id}/upstream-headers) */
+    rotateHttpRouteUpstreamHeaders(id: string, body: {
+        upstream_headers: Record<string, string>;
+    }, idempotencyKey: string): Promise<HttpRouteHeadersReceipt>;
+    /** Rotate the upstream verification secret (POST /api/http-routes/{id}/upstream-verification/rotate) */
+    rotateHttpRouteUpstreamVerification(id: string, idempotencyKey: string): Promise<HttpRouteVerificationReceipt>;
     /** Rotate webhook signing secret (POST /api/emails/{address}/webhook/rotate) */
     rotateMailboxWebhookSecret(address: string): Promise<{
         address?: string;
@@ -2356,6 +3270,75 @@ export declare class Domani {
         source?: "all" | "primary" | "secondary";
         order?: "asc" | "desc";
     }): Promise<SearchResult>;
+    /** Search mail by meaning and by words (GET /api/emails/search) */
+    searchEmailMessages(query?: {
+        mailbox?: string;
+        q: string;
+        mode?: "hybrid" | "semantic" | "keyword";
+        limit?: number;
+        since?: string;
+        until?: string;
+        folder?: "inbox" | "archive" | "sent" | "spam" | "trash";
+        from?: string;
+        label?: string;
+    }): Promise<{
+        results?: ({
+            message?: {
+                id?: string;
+                mailbox?: string;
+                thread_key?: string;
+                direction?: string;
+                from?: string;
+                to?: string;
+                subject?: string | null;
+                snippet?: string;
+                created_at?: string;
+                folder?: string;
+                is_read?: boolean;
+            };
+            score?: number;
+            why?: "words" | "meaning" | "both";
+            highlight?: string | null;
+        })[];
+        mode?: "hybrid" | "semantic" | "keyword";
+        query?: string;
+        took_ms?: number;
+        hint?: string;
+    }>;
+    /** Search one mailbox by meaning and by words (GET /api/emails/{address}/search) */
+    searchEmailMessagesByAddress(address: string, query?: {
+        q: string;
+        mode?: "hybrid" | "semantic" | "keyword";
+        limit?: number;
+        since?: string;
+        until?: string;
+        folder?: "inbox" | "archive" | "sent" | "spam" | "trash";
+        from?: string;
+        label?: string;
+    }): Promise<{
+        results?: ({
+            message?: {
+                id?: string;
+                mailbox?: string;
+                thread_key?: string;
+                direction?: string;
+                from?: string;
+                to?: string;
+                subject?: string | null;
+                snippet?: string;
+                created_at?: string;
+                folder?: string;
+                is_read?: boolean;
+            };
+            score?: number;
+            why?: "words" | "meaning" | "both";
+            highlight?: string | null;
+        })[];
+        mode?: "hybrid" | "semantic" | "keyword";
+        query?: string;
+        took_ms?: number;
+        hint?: string;
+    }>;
     /** List a domain for sale (open marketplace) (POST /api/domains/sell) */
     sellDomain(body: {
         domain: string;
@@ -2390,6 +3373,7 @@ export declare class Domani {
         in_reply_to?: string;
         references?: string;
         idempotency_key?: string;
+        send_at?: string;
         coordination?: {
             thread_key: string;
             client_id: string;
@@ -2402,7 +3386,7 @@ export declare class Domani {
             filename: string;
             content_type?: string;
         }[];
-    }): Promise<{
+    }, idempotencyKey?: string): Promise<{
         id?: string;
         message_id?: string;
         from?: string;
@@ -2446,19 +3430,31 @@ export declare class Domani {
     setMailboxGrant(id: string, mailboxId: string, body: {
         membership_id: string;
         role: "viewer" | "responder" | "manager";
-    }): Promise<unknown>;
+    }): Promise<void>;
     /** Set mailbox webhook (PUT /api/emails/{address}/webhook) */
     setMailboxWebhook(address: string, body: {
         url: string;
-        headers?: Record<string, unknown>;
+        events?: ("email.received" | "email.delivered" | "email.bounced" | "email.failed" | "email.suppressed" | "email.complained" | "email.delayed" | "assistant.item.delegated" | "assistant.item.recalled")[];
+        headers?: Record<string, string>;
     }): Promise<{
         address?: string;
         webhook_url?: string;
         signing_secret?: string;
         has_webhook?: boolean;
+        events?: string[];
         header_names?: string[];
         hint?: string;
     }>;
+    /** Set a follow-up reminder (POST /api/emails/{address}/messages/{id}/remind) */
+    setMessageReminderByAddress(address: string, id: string, body?: {
+        remind_at?: string;
+        note?: string;
+        clear?: boolean;
+    }): Promise<{
+        id?: string;
+        remind_at?: string | null;
+        reminder_note?: string | null;
+    }>;
     /** Set nameservers for a domain (PUT /api/domains/{domain}/nameservers) */
     setNameservers(domain: string, body: {
         nameservers: string[];
@@ -2503,7 +3499,7 @@ export declare class Domani {
         };
         expected_version?: number;
         reason?: string;
-    }): Promise<unknown>;
+    }): Promise<void>;
     /** Capture a DNS snapshot (POST /api/domains/{domain}/dns/snapshot) */
     snapshotDns(domain: string, body?: {
         extra_subdomains?: string[];
@@ -2514,10 +3510,29 @@ export declare class Domani {
         sources?: string[];
         capturedAt?: string;
     }>;
+    /** Consent to and start a background history import (POST /api/assistant/preview) */
+    startAssistantPreview(body: {
+        mailbox_ids: string[];
+        history_window_days?: number;
+        consent: true;
+        consent_version: "mailzero-personal-ai.v1";
+    }): Promise<{
+        ok?: boolean;
+        preview?: {
+            mailbox_ids?: string[];
+            history_window_days?: number;
+            background?: boolean;
+            backfill_id?: string;
+        };
+    }>;
     /** Start bank payout onboarding (POST /api/billing/connect) */
     startPayoutOnboarding(): Promise<{
         url?: string;
     }>;
+    /** Stream mailbox events (server-sent events) (GET /api/emails/{address}/events) */
+    streamMailboxEvents(address: string, lastEventId?: string, query?: {
+        since?: string;
+    }): Promise<Response>;
     /** AI-powered domain suggestions with availability (GET /api/domains/suggest) */
     suggestDomains(query?: {
         prompt: string;
@@ -2545,14 +3560,14 @@ export declare class Domani {
             id: string;
             label: string;
         })[];
-    }): Promise<unknown>;
+    }): Promise<void>;
     /** 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>;
+    }): Promise<void>;
     /** Test mailbox webhook (POST /api/emails/{address}/webhook/test) */
     testMailboxWebhook(address: string): Promise<{
         address?: string;
@@ -2569,7 +3584,29 @@ export declare class Domani {
         payment_tx?: string;
         payment_chain?: "base" | "ethereum";
         extra_subdomains?: string[];
-    }): Promise<unknown>;
+    }): Promise<{
+        domain: string;
+        status: "pending" | "active";
+        expires: string;
+        price: number;
+        currency: string;
+        payment_method: string;
+        payment_tx?: string;
+        auto_renew?: boolean;
+        hint: string;
+        dns_snapshot?: {
+            record_count?: number;
+            subdomain_count?: number;
+        };
+        nameservers_preserved: true;
+        dns_migration: "not_requested";
+        continuity: {
+            nameservers?: string[];
+            dns_provider?: string;
+            dnssec_enabled?: boolean;
+            verification_status?: "verified" | "repaired" | "degraded" | "unknown";
+        };
+    }>;
     /** Update account preferences (PUT /api/me) */
     updateAccount(body: {
         preferred_payment_method?: "card" | "usdc" | null;
@@ -2586,9 +3623,27 @@ export declare class Domani {
         dismissed_version: number;
         hint: string;
     }>;
+    /** Update Mailzero assistant settings (PUT /api/assistant/settings) */
+    updateAssistantSettings(body: {
+        enabled?: boolean;
+        shadow_enabled?: boolean;
+        paused?: boolean;
+        mailbox_ids?: string[];
+        agent_mailbox_ids?: string[];
+        history_window_days?: number;
+        attachment_vision?: boolean;
+    }): Promise<{
+        ok?: boolean;
+        enabled?: boolean;
+        shadow_enabled?: boolean;
+        paused?: boolean;
+        mailbox_ids?: string[];
+    }>;
     /** Assign or update a shared inbox conversation (PATCH /api/email/collaboration) */
     updateConversationState(body: {
         mailbox_id: string;
+        thread_id?: string;
+        labels?: string[];
         thread_key: string;
         thread_aliases?: string[];
         subject?: string | null;
@@ -2614,12 +3669,20 @@ export declare class Domani {
     /** Apply a lifecycle action to messages (POST /api/emails/{address}/messages/actions) */
     updateEmailMessagesByAddress(address: string, body: {
         message_ids: string[];
-        action: "move" | "mark_read" | "star" | "restore" | "delete_permanently";
+        action: "move" | "mark_read" | "star" | "restore" | "delete_permanently" | "label";
         destination?: "inbox" | "archive" | "sent" | "spam" | "trash";
         read?: boolean;
         starred?: boolean;
+        add?: string[];
+        remove?: string[];
+        set?: string[];
         idempotency_key?: string;
-    }): Promise<MailboxOperationReceipt>;
+    }, idempotencyKey?: string): Promise<MailboxOperationReceipt>;
+    /** Update binding browser mode (PATCH /api/domains/{domain}/hostname-bindings/{id}) */
+    updateHostnameBinding(domain: string, id: string, body: {
+        browser_mode: "stateless" | "dedicated_site" | "trusted_same_site";
+        acknowledgements?: string[];
+    }, idempotencyKey: string): Promise<HostnameBindingReceipt>;
     /** Update an agent identity (PATCH /api/agents/identity/{slug}) */
     updateIdentity(slug: string, body: {
         name?: string;
@@ -2653,6 +3716,7 @@ export declare class Domani {
         webhook_url?: string | null;
         forward_to?: string | null;
         drop_spam?: boolean;
+        tone_notes?: string | null;
     }): Promise<{
         id?: string;
         address?: string;
@@ -2661,6 +3725,7 @@ export declare class Domani {
         name?: string | null;
         webhook_url?: string | null;
         forward_to?: string | null;
+        tone_notes?: string | null;
         signing_secret?: string;
     }>;
     /** Update notification preferences (PUT /api/notifications/preferences) */
@@ -2689,7 +3754,7 @@ export declare class Domani {
         url?: string;
         events?: string[];
         active?: boolean;
-        headers?: Record<string, unknown>;
+        headers?: Record<string, string>;
     }): Promise<{
         id?: string;
         url?: string;
@@ -2701,11 +3766,17 @@ export declare class Domani {
     /** Rename a workspace (PATCH /api/workspaces/{id}) */
     updateWorkspace(id: string, body: {
         name: string;
-    }): Promise<unknown>;
+    }): Promise<void>;
     /** Change a member role (PATCH /api/workspaces/{id}/members/{membershipId}) */
     updateWorkspaceMember(id: string, membershipId: string, body: {
         role: "admin" | "member";
-    }): Promise<unknown>;
+    }): Promise<void>;
+    /** Create or update a contact (POST /api/contacts) */
+    upsertContact(body: {
+        address: string;
+        name?: string | null;
+        notes?: string | null;
+    }): Promise<void>;
     /** Verify that a provider connection is working (POST /api/domains/{domain}/verify) */
     verifyConnection(domain: string, body: {
         target?: string;
@@ -2720,6 +3791,11 @@ export declare class Domani {
         hint?: string;
         next_steps?: string[];
     }>;
+    /** Verify binding DNS and certificate (POST /api/domains/{domain}/hostname-bindings/{id}/verify) */
+    verifyHostnameBinding(domain: string, id: string): Promise<{
+        hostname_binding: HostnameBinding;
+        pending: boolean;
+    }>;
     /** Verify and complete domain import (POST /api/domains/import/verify) */
     verifyImport(body: {
         domain: string;
@@ -2734,7 +3810,7 @@ export declare class Domani {
     /** Verify a magic link token (GET /api/auth/verify) */
     verifyMagicLink(query?: {
         token: string;
-    }): Promise<unknown>;
+    }): Promise<void>;
     /** Verify TXT ownership for external listing (POST /api/domains/sell/verify) */
     verifySellListing(body: {
         domain: string;