domani 1.0.6 → 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" | "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";
+    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;
 }
@@ -240,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;
@@ -266,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;
@@ -302,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;
@@ -461,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;
@@ -541,6 +866,7 @@ export interface DomainBrief {
             detectedAt: string;
             type: "identity" | "content" | "redirect" | "registration";
             summary: string;
+            data?: Record<string, unknown>;
             evidenceIds: string[];
         })[];
     };
@@ -606,6 +932,7 @@ export interface DomainBrief {
         claimKey: string;
         label: string;
         value: string;
+        data?: Record<string, unknown>;
         source: string;
         sourceUrl?: string;
         confidence: "high" | "medium" | "low";
@@ -642,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;
@@ -856,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 {
@@ -899,6 +1275,12 @@ export declare class Domani {
         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;
@@ -984,17 +1366,7 @@ export declare class Domani {
         years?: number;
         max_price?: number;
         ref?: string;
-    }, paymentSignature?: 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;
@@ -1147,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;
@@ -1368,6 +1767,17 @@ 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) */
@@ -1433,6 +1843,30 @@ export declare class Domani {
         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";
@@ -1456,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;
@@ -1627,6 +2182,8 @@ 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;
@@ -1678,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;
@@ -1849,6 +2440,26 @@ 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;
@@ -1858,6 +2469,8 @@ export declare class Domani {
     }): Promise<void>;
     /** Leave a workspace (DELETE /api/workspaces/{id}/members/me) */
     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;
@@ -1977,6 +2590,7 @@ export declare class Domani {
         limit?: number;
         direction?: "in" | "out" | "all";
         folder?: "inbox" | "archive" | "sent" | "spam" | "trash";
+        label?: string;
         view?: "starred" | "all" | "needs_human";
         since?: string;
         from?: string;
@@ -1989,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;
@@ -2133,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;
@@ -2276,6 +2904,12 @@ export declare class Domani {
     }): 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;
@@ -2369,6 +3003,24 @@ export declare class Domani {
     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[];
@@ -2412,6 +3064,12 @@ 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;
@@ -2434,6 +3092,7 @@ export declare class Domani {
         webhook_url?: string | null;
         signing_secret?: string | null;
         has_webhook?: boolean;
+        events?: string[];
         header_names?: string[];
         hint?: string;
     }>;
@@ -2560,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;
@@ -2601,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;
@@ -2696,12 +3434,14 @@ export declare class Domani {
     /** Set mailbox webhook (PUT /api/emails/{address}/webhook) */
     setMailboxWebhook(address: string, body: {
         url: string;
+        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;
     }>;
@@ -2770,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;
@@ -2864,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;
@@ -2892,10 +3669,13 @@ 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;
     }, idempotencyKey?: string): Promise<MailboxOperationReceipt>;
     /** Update binding browser mode (PATCH /api/domains/{domain}/hostname-bindings/{id}) */

package/dist/index.js

@@ -76,6 +76,35 @@ class Domani {
             throw new DomaniError(res.status, data);
         return data;
     }
+    /** Open a server-sent event stream; read `response.body` with an SSE parser. */
+    async stream(method, path, opts) {
+        let url = this.baseUrl + path;
+        if (opts?.query) {
+            const qs = new URLSearchParams();
+            for (const [k, v] of Object.entries(opts.query))
+                if (v !== undefined && v !== null)
+                    qs.append(k, String(v));
+            const s = qs.toString();
+            if (s)
+                url += (url.includes("?") ? "&" : "?") + s;
+        }
+        const headers = { Authorization: `Bearer ${this.apiKey}`, Accept: "text/event-stream" };
+        if (opts?.headers)
+            for (const [name, value] of Object.entries(opts.headers))
+                if (value !== undefined)
+                    headers[name] = value;
+        const res = await this.fetchImpl(url, { method, headers, signal: opts?.signal });
+        if (!res.ok) {
+            const text = await res.text();
+            let data = text;
+            try {
+                data = JSON.parse(text);
+            }
+            catch { /* not json */ }
+            throw new DomaniError(res.status, data);
+        }
+        return res;
+    }
     /** Accept an access or ownership offer (POST /api/workspaces/access/offers/accept) */
     acceptWorkspaceAccessOffer(body) {
         return this.request("POST", `/api/workspaces/access/offers/accept`, { body });
@@ -176,6 +205,10 @@ class Domani {
     connectDomain(domain, body) {
         return this.request("POST", `/api/domains/${enc(domain)}/connect`, { body });
     }
+    /** Give an agent its own API key in one call (POST /api/agents/identity/{slug}/tokens) */
+    createAgentToken(slug, body) {
+        return this.request("POST", `/api/agents/identity/${enc(slug)}/tokens`, { body });
+    }
     /** Place a backorder on a taken domain (POST /api/backorders) */
     createBackorder(body) {
         return this.request("POST", `/api/backorders`, { body });
@@ -240,6 +273,10 @@ class Domani {
     deleteAccount() {
         return this.request("DELETE", `/api/me`, undefined);
     }
+    /** Delete assistant-derived data (DELETE /api/assistant/data) */
+    deleteAssistantData() {
+        return this.request("DELETE", `/api/assistant/data`, undefined);
+    }
     /** Delete a contact (DELETE /api/contacts/{address}) */
     deleteContact(address) {
         return this.request("DELETE", `/api/contacts/${enc(address)}`, undefined);
@@ -284,6 +321,14 @@ class Domani {
     exchangeOAuthToken() {
         return this.request("POST", `/api/oauth/token`, undefined);
     }
+    /** Export derived assistant data (GET /api/assistant/data) */
+    exportAssistantData() {
+        return this.request("GET", `/api/assistant/data`, undefined);
+    }
+    /** Extract the fields you need from a message with your own schema (POST /api/emails/{address}/messages/{id}/extract) */
+    extractFromEmailMessage(address, id, body) {
+        return this.request("POST", `/api/emails/${enc(address)}/messages/${enc(id)}/extract`, { body });
+    }
     /** Finalize an agreed negotiation (pay) (POST /api/negotiations/{id}/finalize) */
     finalizeNegotiation(id, body) {
         return this.request("POST", `/api/negotiations/${enc(id)}/finalize`, { body });
@@ -300,6 +345,42 @@ class Domani {
     getActivation() {
         return this.request("GET", `/api/me/activation`, undefined);
     }
+    /** Get the exact action preview by opaque ID (GET /api/assistant/action-plans/{id}) */
+    getAssistantActionPlan(id) {
+        return this.request("GET", `/api/assistant/action-plans/${enc(id)}`, undefined);
+    }
+    /** Get content-minimized assistant Activity (GET /api/assistant/activity) */
+    getAssistantActivity(query) {
+        return this.request("GET", `/api/assistant/activity`, { query });
+    }
+    /** Get background history-import progress (GET /api/assistant/backfill) */
+    getAssistantBackfill() {
+        return this.request("GET", `/api/assistant/backfill`, undefined);
+    }
+    /** Read the situation brief for a correspondent (GET /api/assistant/brief) */
+    getAssistantCorrespondentBrief(query) {
+        return this.request("GET", `/api/assistant/brief`, { query });
+    }
+    /** Get Mailzero assistant settings (GET /api/assistant/settings) */
+    getAssistantSettings() {
+        return this.request("GET", `/api/assistant/settings`, undefined);
+    }
+    /** Get the grounded Today decision queue (GET /api/assistant/today) */
+    getAssistantToday(query) {
+        return this.request("GET", `/api/assistant/today`, { query });
+    }
+    /** Get one assistant Work item and exact current plan (GET /api/assistant/work-items/{id}) */
+    getAssistantWorkItem(id) {
+        return this.request("GET", `/api/assistant/work-items/${enc(id)}`, undefined);
+    }
+    /** Read the situation brief of a Work item (GET /api/assistant/work-items/{id}/brief) */
+    getAssistantWorkItemBrief(id) {
+        return this.request("GET", `/api/assistant/work-items/${enc(id)}/brief`, undefined);
+    }
+    /** Read the facts behind a Work item (GET /api/assistant/work-items/{id}/facts) */
+    getAssistantWorkItemFacts(id) {
+        return this.request("GET", `/api/assistant/work-items/${enc(id)}/facts`, undefined);
+    }
     /** Get EPP auth code (GET /api/domains/{domain}/auth-code) */
     getAuthCode(domain) {
         return this.request("GET", `/api/domains/${enc(domain)}/auth-code`, undefined);
@@ -364,6 +445,10 @@ class Domani {
     getEmailDeliverability(domain) {
         return this.request("GET", `/api/domains/${enc(domain)}/email/deliverability`, undefined);
     }
+    /** Read what the assistant established about a message (GET /api/emails/{address}/messages/{id}/facts) */
+    getEmailMessageFacts(address, id) {
+        return this.request("GET", `/api/emails/${enc(address)}/messages/${enc(id)}/facts`, undefined);
+    }
     /** Get an HTTP hostname binding (GET /api/domains/{domain}/hostname-bindings/{id}) */
     getHostnameBinding(domain, id) {
         return this.request("GET", `/api/domains/${enc(domain)}/hostname-bindings/${enc(id)}`, undefined);
@@ -384,6 +469,10 @@ class Domani {
     getMailboxClientSettings(address) {
         return this.request("GET", `/api/emails/${enc(address)}/client-settings`, undefined);
     }
+    /** Read one conversation, oldest message first (GET /api/emails/{address}/threads/{id}) */
+    getMailboxThread(address, id) {
+        return this.request("GET", `/api/emails/${enc(address)}/threads/${enc(id)}`, undefined);
+    }
     /** Get mailbox webhook config (GET /api/emails/{address}/webhook) */
     getMailboxWebhook(address) {
         return this.request("GET", `/api/emails/${enc(address)}/webhook`, undefined);
@@ -452,6 +541,10 @@ class Domani {
     importDomain(body) {
         return this.request("POST", `/api/domains/import`, { body });
     }
+    /** Record a fenced human Decision (POST /api/assistant/work-items/{id}/interactions) */
+    interactWithAssistantWorkItem(id, body) {
+        return this.request("POST", `/api/assistant/work-items/${enc(id)}/interactions`, { body });
+    }
     /** Invite a workspace member (POST /api/workspaces/{id}/invitations) */
     inviteWorkspaceMember(id, body) {
         return this.request("POST", `/api/workspaces/${enc(id)}/invitations`, { body });
@@ -460,6 +553,10 @@ class Domani {
     leaveWorkspace(id) {
         return this.request("DELETE", `/api/workspaces/${enc(id)}/members/me`, undefined);
     }
+    /** List the API tokens of an agent identity (GET /api/agents/identity/{slug}/tokens) */
+    listAgentTokens(slug) {
+        return this.request("GET", `/api/agents/identity/${enc(slug)}/tokens`, undefined);
+    }
     /** List security audit events (GET /api/audit) */
     listAuditEvents(query) {
         return this.request("GET", `/api/audit`, { query });
@@ -544,6 +641,10 @@ class Domani {
     listMailboxesByAddress(query) {
         return this.request("GET", `/api/emails`, { query });
     }
+    /** List the conversations of a mailbox (GET /api/emails/{address}/threads) */
+    listMailboxThreads(address, query) {
+        return this.request("GET", `/api/emails/${enc(address)}/threads`, { query });
+    }
     /** List inbound mail rules (GET /api/emails/{address}/rules) */
     listMailRules(address) {
         return this.request("GET", `/api/emails/${enc(address)}/rules`, undefined);
@@ -608,6 +709,10 @@ class Domani {
     markNotificationRead(id, body) {
         return this.request("PATCH", `/api/notifications/${enc(id)}`, { body });
     }
+    /** Mark a Work item as opened (POST /api/assistant/work-items/{id}/open) */
+    openAssistantWorkItem(id) {
+        return this.request("POST", `/api/assistant/work-items/${enc(id)}/open`, undefined);
+    }
     /** Plan how to adopt an existing domain (GET /api/domains/adoption-plan) */
     planDomainAdoption(query) {
         return this.request("GET", `/api/domains/adoption-plan`, { query });
@@ -632,6 +737,10 @@ class Domani {
     refreshHttpRoute(id, body, idempotencyKey) {
         return this.request("PATCH", `/api/http-routes/${enc(id)}`, { body, headers: { "Idempotency-Key": idempotencyKey } });
     }
+    /** Register a device for redacted Now alerts (POST /api/assistant/devices) */
+    registerAssistantDevice(body) {
+        return this.request("POST", `/api/assistant/devices`, { body });
+    }
     /** Register an OAuth client (RFC 7591) (POST /api/oauth/register) */
     registerOAuthClient(body) {
         return this.request("POST", `/api/oauth/register`, { body });
@@ -648,6 +757,10 @@ class Domani {
     releaseIdentity(slug) {
         return this.request("DELETE", `/api/agents/identity/${enc(slug)}`, undefined);
     }
+    /** Revoke a device registration (DELETE /api/assistant/devices) */
+    removeAssistantDevice(query) {
+        return this.request("DELETE", `/api/assistant/devices`, { query });
+    }
     /** Remove saved payment method (DELETE /api/billing/card) */
     removeCard() {
         return this.request("DELETE", `/api/billing/card`, undefined);
@@ -716,6 +829,14 @@ class Domani {
     restoreDns(domain, body) {
         return this.request("POST", `/api/domains/${enc(domain)}/dns/restore`, { body });
     }
+    /** Retry failed history-import messages (POST /api/assistant/backfill) */
+    retryAssistantBackfillFailures() {
+        return this.request("POST", `/api/assistant/backfill`, undefined);
+    }
+    /** Revoke an agent's API token (DELETE /api/agents/identity/{slug}/tokens/{id}) */
+    revokeAgentToken(slug, id) {
+        return this.request("DELETE", `/api/agents/identity/${enc(slug)}/tokens/${enc(id)}`, undefined);
+    }
     /** Revoke an app password (hosted) (DELETE /api/emails/{address}/credentials/{id}) */
     revokeMailboxCredential(address, id) {
         return this.request("DELETE", `/api/emails/${enc(address)}/credentials/${enc(id)}`, undefined);
@@ -752,6 +873,14 @@ class Domani {
     search(query) {
         return this.request("GET", `/api/domains/search`, { query });
     }
+    /** Search mail by meaning and by words (GET /api/emails/search) */
+    searchEmailMessages(query) {
+        return this.request("GET", `/api/emails/search`, { query });
+    }
+    /** Search one mailbox by meaning and by words (GET /api/emails/{address}/search) */
+    searchEmailMessagesByAddress(address, query) {
+        return this.request("GET", `/api/emails/${enc(address)}/search`, { query });
+    }
     /** List a domain for sale (open marketplace) (POST /api/domains/sell) */
     sellDomain(body) {
         return this.request("POST", `/api/domains/sell`, { body });
@@ -808,10 +937,18 @@ class Domani {
     snapshotDns(domain, body) {
         return this.request("POST", `/api/domains/${enc(domain)}/dns/snapshot`, { body });
     }
+    /** Consent to and start a background history import (POST /api/assistant/preview) */
+    startAssistantPreview(body) {
+        return this.request("POST", `/api/assistant/preview`, { body });
+    }
     /** Start bank payout onboarding (POST /api/billing/connect) */
     startPayoutOnboarding() {
         return this.request("POST", `/api/billing/connect`, undefined);
     }
+    /** Stream mailbox events (server-sent events) (GET /api/emails/{address}/events) */
+    streamMailboxEvents(address, lastEventId, query) {
+        return this.stream("GET", `/api/emails/${enc(address)}/events`, { query, headers: { "Last-Event-ID": lastEventId } });
+    }
     /** AI-powered domain suggestions with availability (GET /api/domains/suggest) */
     suggestDomains(query) {
         return this.request("GET", `/api/domains/suggest`, { query });
@@ -840,6 +977,10 @@ class Domani {
     updateActivationPreference(body) {
         return this.request("PUT", `/api/me/activation`, { body });
     }
+    /** Update Mailzero assistant settings (PUT /api/assistant/settings) */
+    updateAssistantSettings(body) {
+        return this.request("PUT", `/api/assistant/settings`, { 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.6",
+  "version": "1.1.0",
   "description": "Official TypeScript SDK for the domani API - domains, email, and identity for AI agents.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",