primcli 3.0.0-preview.12 → 3.0.0-preview.14

package/dist/oclif/index.js

@@ -1,12 +1,12 @@
-import { $ as readEmailInteraction, A as explainPendingMailNotFound, At as cliInvocation, Bt as formatAlreadySentNotice, C as promptLine$2, Ct as sendOutcomeExitCode, D as formatBrowserLoginInstructions, Dt as successfulSendOutcome, E as canOfferCopyHotkey, Et as serializeErrorPayload, F as latestOwnOutbound, Ft as loadSkillLine, G as clearConsumedPendingMail, Gt as classificationFactLines, H as wakeRecipientField, Ht as emptyEmailListHint, I as readThreadContext, It as currentMailSessionKey, J as readPendingMail, Jt as noFactsMessage, K as clearReadPendingMail, Kt as classificationOf, L as sentInThread, Lt as detectAgentRuntime, M as describeWake, N as displayAddress, Nt as generatedAgentName, O as listenForCopyHotkey, Ot as thrownErrorExitCode, P as formatMailWakeLine, Pt as identitySuggestions, Q as interactionNextActions, Qt as ConnectedAgentKeyRequiredError, R as serverMuted, Rt as detectRuntimeSession, S as approveThenRerunHint, St as sendIdentityFields, T as withApproval, Tt as sentHistoryWindowStart, U as wakeRelationship, Ut as mailReach, V as wakeReadCommand, Vt as withFlagSuggestion, W as claimPendingMail, Wt as readCallerMailFor, X as removePendingMail, Xt as ATTACHMENT_WAIT_MAX_MS, Y as recordPendingMail, Yt as ATTACHMENT_WAIT_FLAG_DESCRIPTION, Z as interactionHumanLine, Zt as withAttachmentWait, _ as takesStepUp, _n as setKnownCommands, _t as formatPriorRepliesWarning, a as createOperationCommand, an as selectedOrgFromEnv, at as SEND_OUTCOME_HELP, b as STEP_UP_HEADER$1, bt as priorRepliesThatWentOut, c as formatErrorPayload, cn as credentialsFromUserLogin, ct as buildFollowUpCommand, d as isGrantRefusal, dn as revokeUserLogin, dt as classifySendError, en as createAuthenticatedCliApiClient, et as replyExpectation, f as parameterFlagName, fn as roleKeyLabel, ft as deriveSendIdempotencyKey, g as surfaceUnauthorizedHint, gn as sanitizeForTerminal, gt as formatPriorRepliesCheckSkipped, h as runWithTiming, hn as routeWarningLines, ht as formatDeletedEarlierSendNotice, i as TIME_FLAG_DESCRIPTION, in as resolveCliApiRequestConfig, it as MAX_SEND_WAIT_TIMEOUT_MS, j as bareAddress, jt as connectNextSteps, k as openBrowser, l as hasControlCharacter$1, ln as fetchCliOrgs, lt as buildThrownSendFailureEnvelope, m as refusalDetails, mn as switchCurrentOrg, mt as followUpCommandPrefix, n as API_ERROR_CODES, nn as refreshStoredCliCredentials, o as extractErrorCode, on as CliOrgRefusedError, ot as apiResultHttpStatus, p as readTextFileFlag, pn as roleKeyText, pt as excludeSignalReplies, q as pendingMailPath, qt as isEmailId, r as OPERATION_PATH_FLAGS, rn as refuseOrgSelectionForProfile, rt as IDEMPOTENCY_KEY_FLAG_DESCRIPTION, s as extractErrorPayload, sn as RESTRICTED_ROLE_NOTE, st as assertValidIdempotencyKey, t as API_BASE_URL_FLAG_DESCRIPTION, tn as createCliApiClient, tt as replyInteractionWarning, u as headerFlagName, un as isBuiltInRoleKey, ut as checkPriorReplies, v as writeErrorWithHints, vn as operationManifest, vt as formatSendFailureSummary, w as terminalApprovalIo, wt as sendWaitClampNotice, x as STEP_UP_TOKEN_FLAG_DESCRIPTION, xt as reportSendCommandResult, y as BROWSER_FLAG_DESCRIPTION, yt as formatSendRecordFailureSummary, z as serverRelationship, zt as runtimeSessionVariableList } from "../api-command-CNCsVNk0.js";
-import { $ as parseWebhookEvent, $n as simulateRoute, $t as getRepeatingSend, A as lateMailReread, An as listWakeDispatches, At as deleteWakeSchedule, B as ensureSearchReportsReplyState, Bn as replyToEmail, Bt as getConversation, C as waitOutRetryAfter, Cn as listOrganizationPeople, Ct as createWakeAuthorization, D as encodeReceivedAtSearchCursor, Dn as listSentAttachmentArchiveMembers, Dt as deleteMemory, E as cursorFromAcceptedRows, En as listRoutes, F as AWAITING_VALUES, Ft as downloadSentAttachmentByFilename, G as queryUsesAwaiting, Gt as getFunctionRouting, H as formatRepliesCell, Hn as revokeCredential, Ht as getDefaultNetworkAgent, I as REPLY_STATE_UNSUPPORTED_CODE, It as getAccessMode, Jn as semanticSearch, Jt as getKey, Kn as searchEmails, Kt as getFunctionTestRunTrace, L as ReplyStateUnsupportedError, Ln as redeemCreditCode, Lt as getAccount, M as sinceFromFlags, Mn as pollCliLogin, Mt as downloadEmailAttachmentByFilename, N as sleep$3, Nn as pullWebhookEvent, O as fetchEmailSearchPage, On as listSentEmails, Ot as deleteRoute, P as AWAITING_FLAG_DESCRIPTION, Pt as downloadSentAttachmentArchiveMember, Qn as setMemory, Qt as getOwnGrant, R as assertAwaitingFilterRows, Rn as removeDefaultNetworkMember, Rt as getAgentContactPolicy, S as transientFailure, Sn as listMailboxAccess, St as createRoute, T as collectNewAcceptedEmails, Tn as listRoles, U as hasReplyState, Un as rotateKey, Ut as getEmail, V as formatAwaitingCell, Vn as resendAgentSignupVerification, Vt as getCreditBalance, W as isAwaitingRejectedError, Wn as runWakeSchedule, Wt as getFunction, Xn as setFunctionRoute, Xt as getOrgRoutingTopology, Yn as sendEmail, Yt as getMemory, Z as isEmailReceivedEvent, Zn as setFunctionSecret, Zt as getOutboundStatus, _ as describeApiFailure, _n as listEndpoints, _t as cliLogout, a as REPEAT_IDLE_MAX_MINUTES, an as leaveOrganization, ar as unsetFunctionRoute, at as assertAutomatedVerdict, b as retryTransient, bn as listGroups, bt as createFunction, cn as listAgentContacts, cr as updateKey, d as parseRepeatTick, dn as listDefaultNetworkAgents, dr as updateWakeAuthorization, dt as isAutomatedRejectedError, en as getSendFrom, er as startAgentClaim, et as parseFromHeader, f as preparePresenceAliveEmail, fn as listDefaultNetworkMembers, fr as updateWakeSchedule, ft as addDefaultNetworkMember, g as WaitDeadlineReached, gn as listEmails, gt as checkSendability, hn as listEmailRuleResults, hr as whoami, ht as checkDefaultNetworkContactAdmission, i as REPEAT_EVERY_MAX_MINUTES, ir as testFunction, it as AutomatedFilterUnsupportedError, j as quoteDslValue, jn as listWakeSchedules, jt as downloadEmailAttachmentArchiveMember, k as filtersFromFlags, kn as listWakeAuthorizations, kt as deleteWakeAuthorization, l as parseInteractionEnvelope, ln as listAgentNetworks, lr as updateRepeatingSend, m as repeatStopCommand, mn as listEmailAttachmentArchiveMembers, mr as verifyAgentSignup, mt as cancelSentEmailByIdempotencyKey, nn as getThread, nr as startCliLogin, nt as AUTOMATED_FLAG_DESCRIPTION, o as REPEAT_MAX_SENDS_MAX, on as listActivityObjects, or as updateDefaultNetworkMember, ot as automatedRejectedError, p as prepareSignalEmail, pn as listDomains, pr as verifyAgentClaim, pt as cancelSentEmail, qn as searchMemories, qt as getInboxStatus, rn as getWakeSchedule, rr as stopRepeatFromEmail, rt as AUTOMATED_VALUES, s as buildRepeatStopBody, sr as updateFunction, tn as getSentEmail, tr as startAgentSignup, tt as AUTOMATED_FILTER_UNSUPPORTED_CODE, u as parsePresenceEnvelope, ur as updateRoute, ut as hasAutomatedVerdict, vn as listFunctionLogs, vt as completeWebhookEvent, w as SINCE_VALUE_HELP, wn as listRepeatingSends, wt as createWakeSchedule, x as retryingOperation, xn as listKeys, xt as createKey, y as pauseForTransientFailure, yn as listFunctions, yt as createEndpoint, z as awaitingRejectedError, zn as reorderRoutes } from "../repeats-Dj_o6c-X-wjmw2Jbx.js";
-import { S as readBundledConnectSkill, _ as NotificationOutcomeUnknownError, a as NotificationRetryError, b as installedConnectSkillFile, c as readConversationStatusContent, d as SESSION_UUID$1, g as NativeSessionNotLoadedError, h as NativeSessionError, i as notificationReceiptPage, l as createListenHandler, m as NativeSessionDisconnectedError, n as notificationSenders, o as isRoutineNotificationContent, p as defaultSessionSocket, r as openSessionNotifications, s as notificationPartReader, t as notificationScope, u as readableDelivery, v as connectSkillTarget, x as installedVersion, y as installConnectSkill } from "../notify-session-WKFsaFt3.js";
+import { $ as interactionNextActions, $t as ConnectedAgentKeyRequiredError, A as openBrowser, B as serverRelationship, Bt as runtimeSessionVariableList, C as approveThenRerunHint, Ct as sendIdentityFields, D as canOfferCopyHotkey, Dt as serializeErrorPayload, E as withApproval, Et as sentHistoryWindowStart, F as formatMailWakeLine, Ft as identitySuggestions, G as claimPendingMail, Gt as readCallerMailFor, H as wakeReadCommand, Ht as withFlagSuggestion, I as latestOwnOutbound, It as loadSkillLine, J as pendingMailPath, Jt as isEmailId, K as clearConsumedPendingMail, Kt as classificationFactLines, L as readThreadContext, Lt as currentMailSessionKey, M as bareAddress, Mt as connectNextSteps, N as describeWake, O as formatBrowserLoginInstructions, Ot as successfulSendOutcome, P as displayAddress, Pt as generatedAgentName, Q as interactionHumanLine, Qt as withAttachmentWait, R as sentInThread, Rt as detectAgentRuntime, S as STEP_UP_TOKEN_FLAG_DESCRIPTION, St as reportSendCommandResult, T as terminalApprovalIo, Tt as sendWaitClampNotice, U as wakeRecipientField, Ut as emptyEmailListHint, Vt as formatAlreadySentNotice, W as wakeRelationship, Wt as mailReach, X as recordPendingMail, Xt as ATTACHMENT_WAIT_FLAG_DESCRIPTION, Y as readPendingMail, Yt as noFactsMessage, Z as removePendingMail, Zt as ATTACHMENT_WAIT_MAX_MS, _ as surfaceUnauthorizedHint, _n as sanitizeForTerminal, _t as formatPriorRepliesCheckSkipped, a as createOperationCommand, an as resolveCliApiRequestConfig, at as MAX_SEND_WAIT_TIMEOUT_MS, b as BROWSER_FLAG_DESCRIPTION, bt as formatSendRecordFailureSummary, c as formatErrorPayload, cn as RESTRICTED_ROLE_NOTE, ct as assertValidIdempotencyKey, d as isGrantRefusal, dn as isBuiltInRoleKey, dt as checkPriorReplies, et as readEmailInteraction, f as networkErrorHint, fn as revokeUserLogin, ft as classifySendError, g as runWithTiming, gn as routeWarningLines, gt as formatDeletedEarlierSendNotice, h as refusalDetails, hn as switchCurrentOrg, ht as followUpCommandPrefix, i as TIME_FLAG_DESCRIPTION, in as refuseOrgSelectionForProfile, it as IDEMPOTENCY_KEY_FLAG_DESCRIPTION, j as explainPendingMailNotFound, jt as cliInvocation, k as listenForCopyHotkey, kt as thrownErrorExitCode, l as hasControlCharacter$1, ln as credentialsFromUserLogin, lt as buildFollowUpCommand, m as readTextFileFlag, mn as roleKeyText, mt as excludeSignalReplies, n as API_ERROR_CODES, nn as createCliApiClient, nt as replyInteractionWarning, o as extractErrorCode, on as selectedOrgFromEnv, ot as SEND_OUTCOME_HELP, p as parameterFlagName, pn as roleKeyLabel, pt as deriveSendIdempotencyKey, q as clearReadPendingMail, qt as classificationOf, r as OPERATION_PATH_FLAGS, rn as refreshStoredCliCredentials, s as extractErrorPayload, sn as CliOrgRefusedError, st as apiResultHttpStatus, t as API_BASE_URL_FLAG_DESCRIPTION, tn as createAuthenticatedCliApiClient, tt as replyExpectation, u as headerFlagName, un as fetchCliOrgs, ut as buildThrownSendFailureEnvelope, v as takesStepUp, vn as setKnownCommands, vt as formatPriorRepliesWarning, w as promptLine$2, wt as sendOutcomeExitCode, x as STEP_UP_HEADER$1, xt as priorRepliesThatWentOut, y as writeErrorWithHints, yn as operationManifest, yt as formatSendFailureSummary, z as serverMuted, zt as detectRuntimeSession } from "../api-command-BTOIanV1.js";
+import { $n as setMemory, $t as getOwnGrant, A as filtersFromFlags, An as listWakeAuthorizations, At as deleteWakeAuthorization, B as awaitingRejectedError, Bn as reorderRoutes, C as transientFailure, Cn as listMailboxAccess, Ct as createRoute, D as cursorFromAcceptedRows, Dn as listRoutes, E as collectNewAcceptedEmails, En as listRoles, F as AWAITING_FLAG_DESCRIPTION, Ft as downloadSentAttachmentArchiveMember, G as isAwaitingRejectedError, Gn as runWakeSchedule, Gt as getFunction, H as formatAwaitingCell, Hn as resendAgentSignupVerification, Ht as getCreditBalance, I as AWAITING_VALUES, It as downloadSentAttachmentByFilename, Jn as searchMemories, Jt as getInboxStatus, K as queryUsesAwaiting, Kt as getFunctionRouting, L as REPLY_STATE_UNSUPPORTED_CODE, Lt as getAccessMode, M as quoteDslValue, Mn as listWakeSchedules, Mt as downloadEmailAttachmentArchiveMember, N as sinceFromFlags, Nn as pollCliLogin, Nt as downloadEmailAttachmentByFilename, O as encodeReceivedAtSearchCursor, On as listSentAttachmentArchiveMembers, Ot as deleteMemory, P as sleep$3, Pn as pullWebhookEvent, Q as isEmailReceivedEvent, Qn as setFunctionSecret, Qt as getOutboundStatus, R as ReplyStateUnsupportedError, Rn as redeemCreditCode, Rt as getAccount, S as retryingOperation, Sn as listKeys, St as createKey, T as SINCE_VALUE_HELP, Tn as listRepeatingSends, Tt as createWakeSchedule, U as formatRepliesCell, Un as revokeCredential, Ut as getDefaultNetworkAgent, V as ensureSearchReportsReplyState, Vn as replyToEmail, Vt as getConversation, W as hasReplyState, Wn as rotateKey, Wt as getEmail, Xn as sendEmail, Xt as getMemory, Yn as semanticSearch, Yt as getKey, Zn as setFunctionRoute, Zt as getOrgRoutingTopology, _ as backoffDelay, _n as listEmails, _t as checkSendability, a as REPEAT_IDLE_MAX_MINUTES, ar as testFunction, at as AutomatedFilterUnsupportedError, b as pauseForTransientFailure, bn as listFunctions, bt as createEndpoint, cr as updateFunction, d as parseRepeatTick, dr as updateRoute, dt as hasAutomatedVerdict, en as getRepeatingSend, er as simulateRoute, et as parseWebhookEvent, f as preparePresenceAliveEmail, fn as listDefaultNetworkAgents, fr as updateWakeAuthorization, ft as isAutomatedRejectedError, g as WaitDeadlineReached, gn as listEmailRuleResults, gr as whoami, gt as checkDefaultNetworkContactAdmission, hn as listEmailAttachmentArchiveMembers, hr as verifyAgentSignup, ht as cancelSentEmailByIdempotencyKey, i as REPEAT_EVERY_MAX_MINUTES, in as getWakeSchedule, ir as stopRepeatFromEmail, it as AUTOMATED_VALUES, j as lateMailReread, jn as listWakeDispatches, jt as deleteWakeSchedule, k as fetchEmailSearchPage, kn as listSentEmails, kt as deleteRoute, l as parseInteractionEnvelope, ln as listAgentContacts, lr as updateKey, m as repeatStopCommand, mn as listDomains, mr as verifyAgentClaim, mt as cancelSentEmail, nn as getSentEmail, nr as startAgentSignup, nt as AUTOMATED_FILTER_UNSUPPORTED_CODE, o as REPEAT_MAX_SENDS_MAX, on as leaveOrganization, or as unsetFunctionRoute, ot as assertAutomatedVerdict, p as prepareSignalEmail, pn as listDefaultNetworkMembers, pr as updateWakeSchedule, pt as addDefaultNetworkMember, qn as searchEmails, qt as getFunctionTestRunTrace, rn as getThread, rr as startCliLogin, rt as AUTOMATED_FLAG_DESCRIPTION, s as buildRepeatStopBody, sn as listActivityObjects, sr as updateDefaultNetworkMember, st as automatedRejectedError, tn as getSendFrom, tr as startAgentClaim, tt as parseFromHeader, u as parsePresenceEnvelope, un as listAgentNetworks, ur as updateRepeatingSend, v as describeApiFailure, vn as listEndpoints, vt as cliLogout, w as waitOutRetryAfter, wn as listOrganizationPeople, wt as createWakeAuthorization, x as retryTransient, xn as listGroups, xt as createFunction, yn as listFunctionLogs, yt as completeWebhookEvent, z as assertAwaitingFilterRows, zn as removeDefaultNetworkMember, zt as getAgentContactPolicy } from "../repeats-Dj_o6c-X-B7sSj0oc.js";
+import { S as readBundledConnectSkill, _ as NotificationOutcomeUnknownError, a as NotificationRetryError, b as installedConnectSkillFile, c as readConversationStatusContent, d as SESSION_UUID$1, g as NativeSessionNotLoadedError, h as NativeSessionError, i as notificationReceiptPage, l as createListenHandler, m as NativeSessionDisconnectedError, n as notificationSenders, o as isRoutineNotificationContent, p as defaultSessionSocket, r as openSessionNotifications, s as notificationPartReader, t as notificationScope, u as readableDelivery, v as connectSkillTarget, x as installedVersion, y as installConnectSkill } from "../notify-session-b_0jyPIk.js";
 import { A as AGENT_ADDRESS_ENV, C as saveCliCredentials, D as loadActiveChatState, E as deleteChatState, F as agentProfilesDirectory, H as requireDefaultLoginProfile, M as AgentConnectionSetupError, N as agentProfileDirectory, O as loadChatConversationByLocalId, P as agentProfileName, R as loadConnectedAgentProfile, S as resolveCliAuth, T as chatStatePath, W as PrimitiveApiClient, _ as deleteCliCredentials, a as normalizeCliEnvironmentName, b as loadCliCredentials, c as resolveConfigEnvironment, g as credentialsPath, h as credentialsLockPath, i as loadCliConfig, j as AGENT_PROFILE_ENV, k as saveActiveChatState, l as saveCliConfig, m as cliAccessTokenExpiresAt, n as deleteCliConfig, o as redactCliEnvironment, p as acquireCliCredentialsLock, r as emptyCliConfig, s as removeCliEnvironment, u as upsertCliEnvironment, v as deleteCliCredentialsLock, w as saveSignupCredentials, y as detectPrimitiveKeyEnvMisname } from "../cli-config-Ms_0vNjq.js";
 import { C as resolveListenSubscription, S as normalizeListenOrigin, _ as acquireListenLock, a as mailLockBusy, c as mailTime, d as readMailJson, f as removeMailFile, g as ListenStateError, h as writeMailJson, i as mailId, l as privateMailDirectory, m as withMailLock, o as mailObject, u as privateMailPermissions, y as listenIdentity } from "../shared-mail-files-BAQSGxxz.js";
-import { $ as saveConnectionName, A as ContactPolicyReadRetryError, B as AddressNotesApiError, C as RECEIVER_MODES, Ct as upsertManagedBlock, D as registrationSummary, Dt as refreshOwnerMemberAddressPeriodically, E as failedSessionRegistration, Et as addSessionReceiver, F as canonicalContactSelector, G as contactAgentAddress, H as runAddressNotesRequest, I as AgentDisconnectError, J as agentInvitationHash, K as runContactRequest, L as claimOverRevokedSetup, M as NetworkAdmissionPendingError, N as createNotificationContactPolicy, O as registrationSummaryLine, Ot as withOwnerMemberAddress, P as evaluateContactPolicy, Q as refusalAfterReplacement, R as clearRevokedAddresses, S as runAgentConnect, St as readManagedFile, T as verificationReplySubmitted, Tt as readHookLauncherWarning, U as ContactsApiError, V as addressNoteTarget, W as contactAddress, X as readAgentInvitation, Y as connectAgent, Z as receiverStatusCommand, _ as enrollmentResumes, _t as samePath, a as endSession, at as boundSessionProfiles, b as invitationProfileName, bt as inspectManagedBlock, c as pendingSessionDisconnects, ct as describeSessionHookChange, d as registerSession, dt as ephemeralCliReason, et as savedReceiver, f as retryPendingDisconnects, ft as findOnPath, g as enrollAgent, gt as repairClaudeHooks, h as staleSessionAgents, ht as readClaudeSettings, i as connectedProfilesForSession, it as recordHookMailCheck, j as NETWORK_ADMISSION_PENDING_RETRY_MS, k as waitForRegistrations, l as psProcessInfo, lt as describeSessionHookItem, m as runDetached, mt as inspectClaudeHooks, n as OMP_MAIN, nt as releaseRegistrationsForProfile, o as headlessClaudeRun, ot as claudeConfigDir, p as revokeStaleSessionAgents, pt as hasMachineSessionHooks, q as agentConnectionStatus, r as agentConnectionState, rt as installClaudeWakeHook, st as currentCliLocation, t as HOOK_END_GRACE_MS, tt as MACHINE_RUNTIMES, u as readClaudeHookInput, ut as ensureHookLauncher, v as connectWarnings, vt as writeClaudeSettings, w as externalReceivingState, wt as writeManagedFile, x as pollCheckCommand, xt as jsonIndentation, y as defaultAgentProfileName, yt as MachineFileError, z as disconnectAgent } from "../machine-session-DkXYR62a.js";
-import { a as readBeforeDeadline, c as readPresenceProjection, i as readApiBeforeDeadline, n as isPlainChatReply, o as scopedChatSenderTrust, r as isScopedChatReply, s as presenceDisposition, t as isConnectedChatCredential } from "../scoped-chat-B1Fi6_qM.js";
+import { $ as saveConnectionName, A as ContactPolicyReadRetryError, B as AddressNotesApiError, C as RECEIVER_MODES, Ct as upsertManagedBlock, D as registrationSummary, Dt as refreshOwnerMemberAddressPeriodically, E as failedSessionRegistration, Et as addSessionReceiver, F as canonicalContactSelector, G as contactAgentAddress, H as runAddressNotesRequest, I as AgentDisconnectError, J as agentInvitationHash, K as runContactRequest, L as claimOverRevokedSetup, M as NetworkAdmissionPendingError, N as createNotificationContactPolicy, O as registrationSummaryLine, Ot as withOwnerMemberAddress, P as evaluateContactPolicy, Q as refusalAfterReplacement, R as clearRevokedAddresses, S as runAgentConnect, St as readManagedFile, T as verificationReplySubmitted, Tt as readHookLauncherWarning, U as ContactsApiError, V as addressNoteTarget, W as contactAddress, X as readAgentInvitation, Y as connectAgent, Z as receiverStatusCommand, _ as enrollmentResumes, _t as samePath, a as endSession, at as boundSessionProfiles, b as invitationProfileName, bt as inspectManagedBlock, c as pendingSessionDisconnects, ct as describeSessionHookChange, d as registerSession, dt as ephemeralCliReason, et as savedReceiver, f as retryPendingDisconnects, ft as findOnPath, g as enrollAgent, gt as repairClaudeHooks, h as staleSessionAgents, ht as readClaudeSettings, i as connectedProfilesForSession, it as recordHookMailCheck, j as NETWORK_ADMISSION_PENDING_RETRY_MS, k as waitForRegistrations, l as psProcessInfo, lt as describeSessionHookItem, m as runDetached, mt as inspectClaudeHooks, n as OMP_MAIN, nt as releaseRegistrationsForProfile, o as headlessClaudeRun, ot as claudeConfigDir, p as revokeStaleSessionAgents, pt as hasMachineSessionHooks, q as agentConnectionStatus, r as agentConnectionState, rt as installClaudeWakeHook, st as currentCliLocation, t as HOOK_END_GRACE_MS, tt as MACHINE_RUNTIMES, u as readClaudeHookInput, ut as ensureHookLauncher, v as connectWarnings, vt as writeClaudeSettings, w as externalReceivingState, wt as writeManagedFile, x as pollCheckCommand, xt as jsonIndentation, y as defaultAgentProfileName, yt as MachineFileError, z as disconnectAgent } from "../machine-session-BTkDAKda.js";
+import { a as readBeforeDeadline, c as readPresenceProjection, i as readApiBeforeDeadline, n as isPlainChatReply, o as scopedChatSenderTrust, r as isScopedChatReply, s as presenceDisposition, t as isConnectedChatCredential } from "../scoped-chat-Cqmn-k7q.js";
 import { autoSignalEligible, dispatchAutoRead, dispatchAutoWorking, haltAutoWorking, isSentSignal, readWorkingLease, restoreAutoWorking } from "./auto-signals.js";
-import { a as ensureSharedMailSubscription, c as isConnectedAgentKey, d as reserveSharedMailSubscription, f as followEmailConversation, g as EventReceiverError, h as EventConnection, i as sharedMailScope, l as createSharedMailWaiter, m as otherParticipants, n as reconcileChatSend, p as readConversationFollow, r as openSharedMailReceiver, s as AGENT_CONNECTION_REQUIRED_MESSAGE, t as sendSignal, u as openSharedMailStore } from "../signal-command-BdJVZXGl.js";
+import { a as ensureSharedMailSubscription, c as isConnectedAgentKey, d as reserveSharedMailSubscription, f as followEmailConversation, g as EventReceiverError, h as EventConnection, i as sharedMailScope, l as createSharedMailWaiter, m as otherParticipants, n as reconcileChatSend, p as readConversationFollow, r as openSharedMailReceiver, s as AGENT_CONNECTION_REQUIRED_MESSAGE, t as sendSignal, u as openSharedMailStore } from "../signal-command-ewPBzvjU.js";
 import { a as thrownErrorBody, i as runStreamingJson, n as guardJsonOutputCommands, r as jsonOutputRequested, t as JSON_OUTPUT_FLAG } from "../json-output-ch756TXV.js";
 import { a as backgroundListenStatus, c as runBackgroundListen, d as stopBackgroundListen, f as verifyBackgroundListenTarget, o as backgroundListenToken, r as backgroundListenConfiguration, u as startBackgroundListen } from "../listen-background-DyBYca28.js";
 import { ORG_SELECTION_ENV } from "./global-org-flag.js";
@@ -184,6 +184,11 @@ const openapiDocument = {
 			"description": "Organization administration for people: your own connected apps and CLI logins, the organization's connected apps, its name and logo, and semantic search consent. API keys, agent connection keys and agents are refused. Billing and deleting the organization are done in the dashboard only.",
 			"x-openapi-spec": "https://api.primitive.dev/v1/openapi/tags/organization-settings"
 		},
+		{
+			"name": "Email notifications",
+			"description": "The notification emails Primitive sends an organization's members: the organization chooses, per kind, whether it is off, left to each member or required, and each member chooses where it is left to them. Some kinds are always sent. API keys, agent connection keys and agents are refused.",
+			"x-openapi-spec": "https://api.primitive.dev/v1/openapi/tags/email-notifications"
+		},
 		{
 			"name": "Roles and members",
 			"description": "Roles, member roles and removal, the mailbox access mode, break-glass, transfers and suspensions. Reads are open to people; every write is person only: a dashboard session, or the person's own OAuth or CLI token with a session step-up. API keys never reach these. Answers 404 feature_disabled while the feature is not enabled for the organization, with details.feature naming the feature; contact Primitive to turn it on.",
@@ -2502,7 +2507,12 @@ const openapiDocument = {
 					"name": "outbound_only",
 					"in": "query",
 					"schema": { "type": "boolean" },
-					"description": "When true, include only outbound DNS records. Verified domains default to outbound-only; pending claims default to all required records."
+					"description": "When true, include only outbound DNS records. Cannot be combined with inbound_only=true. By default, include all records."
+				}, {
+					"name": "inbound_only",
+					"in": "query",
+					"schema": { "type": "boolean" },
+					"description": "When true, include only inbound MX and ownership TXT records. Cannot be combined with outbound_only=true."
 				}],
 				"responses": {
 					"200": {
@@ -21769,7 +21779,7 @@ const openapiDocument = {
 		"/activity/objects": { "get": {
 			"operationId": "listActivityObjects",
 			"summary": "List what you created, or what you were asked",
-			"description": "The objects the caller created, newest first, each with where it stands now, including ones since disabled, deleted or revoked where the object keeps a row: Functions, endpoints, Function triggers, pull subscriptions, recipient routes, filters, wake schedules, repeating sends and scheduled sends. An API key, an app or an agent sees what it created itself; a webhook given to an API key lists under that key. A person (a dashboard session, or their own Primitive CLI or app login) sees what they created through any credential of theirs, each item naming it, and also their API keys, personal agents, email rules, rule requests and objections to rules over their mail (objections only on the dashboard or the Primitive CLI). Each kind is listed only if the caller could list it through that kind's own route; a kind it could not is named in withheld, with no count. Ids, names and states only: never a webhook URL or mail content. Needs activity:read_self. With relation=asked it lists instead what other members asked of the person, open or answered: the rule requests made to them, and the objections to rules they wrote, under their current membership, each naming the member who asked or objected in created_through. A key, an app or an agent has none, and gets both kinds in withheld. With relation=concerning it lists instead what other members did that concerns the person's own mail: each time a rule started covering one of their mailboxes or saved a new version while covering it, named as the rule was then, naming its author in created_through, under their current membership; only on the dashboard or the Primitive CLI. A key, an app or an agent has none, and gets email_rule_coverage in withheld. A notice never reads as ended. Notices are written by a periodic job and can lag: until the notices record a rule starting to cover you, the first page lists that rule as pending (pending_complete says whether that check finished), and as_of says about when the notices last looked. For what covers you now, read GET /email-rules/covering-me.",
+			"description": "The objects the caller created, newest first, each with where it stands now, including ones since disabled, deleted or revoked where the object keeps a row: Functions, endpoints, Function triggers, pull subscriptions, recipient routes, filters, wake schedules, repeating sends and scheduled sends. An API key, an app or an agent sees what it created itself; a webhook given to an API key lists under that key. A person (a dashboard session, or their own Primitive CLI or app login) sees what they created through any credential of theirs, each item naming it, and also their API keys, personal agents, email rules, rule requests and objections to rules over their mail (objections only on the dashboard or the Primitive CLI). Each kind is listed only if the caller could list it through that kind's own route; a kind it could not is named in withheld, with no count. Ids, names and states only: never a webhook URL or mail content. Needs activity:read_self. With relation=asked it lists instead what other members asked of the person, open or answered: the rule requests made to them, and the objections to rules they wrote, under their current membership, each naming the member who asked or objected in created_through. A key, an app or an agent has none, and gets both kinds in withheld. With relation=concerning it lists instead what other members did that concerns the person's own mail: each time a rule started covering one of their mailboxes, saved a new version, or changed who receives its matches while covering it, named as the rule was then, naming its author in created_through, under their current membership; only on the dashboard or the Primitive CLI. A key, an app or an agent has none, and gets email_rule_coverage in withheld. A notice never reads as ended. Notices are written by a periodic job and can lag: until the notices record a rule starting to cover you, the first page lists that rule as pending (pending_complete says whether that check finished), and as_of says about when the notices last looked. For what covers you now, read GET /email-rules/covering-me.",
 			"tags": ["Activity"],
 			"security": [{ "BearerAuth": [] }],
 			"parameters": [
@@ -21780,7 +21790,7 @@ const openapiDocument = {
 					"description": "created (the default), asked or concerning.",
 					"schema": {
 						"default": "created",
-						"description": "created (the default): what you created. asked: what other members asked of you, open or answered: rule requests made to you, and objections to rules you wrote; kind may then name only email_rule_request and email_rule_objection. concerning: what other members did that concerns your own mail: a rule that started covering one of your mailboxes, or saved a new version while covering it (email_rule_coverage, the only kind it takes). asked and concerning are for a person's own view only.",
+						"description": "created (the default): what you created. asked: what other members asked of you, open or answered: rule requests made to you, and objections to rules you wrote; kind may then name only email_rule_request and email_rule_objection. concerning: what other members did that concerns your own mail: an active rule that started covering one of your mailboxes, saved a new version, or changed who receives its matches while covering it (email_rule_coverage, the only kind it takes). A rule in draft or observe is not told of; GET /v1/email-rules/covering-me lists it. asked and concerning are for a person's own view only.",
 						"type": "string",
 						"enum": [
 							"created",
@@ -21997,7 +22007,7 @@ const openapiDocument = {
 		"/email-rules/compile": { "post": {
 			"operationId": "compileEmailRule",
 			"summary": "Compile a rule description",
-			"description": "Turns a plain-English description of which received emails to match into a rule tree over the column contract, with an explanation of what it matches, the assumptions made, and warnings for what the columns cannot express. Where the columns fall short it adds up to five yes/no questions, asked only after the conditions match; they read the subject, the new text and attachment file names, never attachment contents. Nothing is saved. For a rule with no questions, breadth counts, read only, how much of your recent classified mail its conditions match; for a grant rule with questions, conditions_breadth counts its conditions alone. include_sql returns the SQL it renders to. kind do_not_share compiles for recall. Needs mail:read, the email rules feature, and a member's own full-access credential (no API key, agent key or narrowed token).",
+			"description": "Turns a plain-English description of which received emails to match into a rule tree over the column contract, with an explanation of what it matches, the assumptions made, and warnings for what the columns cannot express. Where the columns fall short it adds up to five yes/no questions, asked only after the conditions match; they read the subject, the new text and attachment file names, never attachment contents. Nothing is saved. For a rule with no questions, breadth counts, read only, how much of the recent classified mail in evaluation_scope (by default your own mailboxes) its conditions match; for a grant rule with questions, conditions_breadth counts its conditions alone. include_sql returns the SQL it renders to. kind do_not_share compiles for recall. Needs mail:read, the email rules feature, and a member's own full-access credential (no API key, agent key or narrowed token).",
 			"tags": ["Email Rules"],
 			"security": [{ "BearerAuth": [] }],
 			"requestBody": {
@@ -22052,7 +22062,11 @@ const openapiDocument = {
 					}
 				},
 				"403": {
-					"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden.",
+					"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden. email_rule_scope_not_readable: scope_selection names something you cannot read.",
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+				},
+				"409": {
+					"description": "email_rule_author_unresolvable: with evaluation_scope selected, you cannot act as a rule's author right now (details.reason left, revoked, suspended, membership_ended or no_mail_read).",
 					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
 				},
 				"422": {
@@ -22149,7 +22163,7 @@ const openapiDocument = {
 					}
 				},
 				"403": {
-					"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden. grant_forbidden with details.reason mail_depth: your access to mail shows headers only, and a rule decides on what emails say. email_rule_scope_not_readable: scope_selection names something you cannot read.",
+					"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden. grant_forbidden with details.reason mail_depth: your access to mail shows headers only, and a rule decides on what emails say. email_rule_scope_not_readable: scope_selection names something you cannot read. forbidden with details.reason covering_view_only: you read this rule only in the covering view, since it decided on your mail before and covers none of your mailboxes now (details.covering_view).",
 					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
 				},
 				"404": {
@@ -22246,15 +22260,15 @@ const openapiDocument = {
 					}
 				},
 				"403": {
-					"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden. email_rule_scope_not_readable: scope_selection names something you cannot read.",
+					"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden. email_rule_scope_not_readable: scope_selection names something you cannot read. forbidden with details.reason covering_view_only: you read this rule only in the covering view, since it decided on your mail before and covers none of your mailboxes now (details.covering_view).",
 					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
 				},
 				"404": {
-					"description": "not_found: rule_id names no rule you can see (details.reason rule_not_found), or request_id no rule request you can see (request_not_found).",
+					"description": "not_found: rule_id names no rule you can see or that covers your mailboxes (details.reason rule_not_found), or request_id no rule request you can see (request_not_found).",
 					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
 				},
 				"409": {
-					"description": "email_rule_author_unresolvable: the rule cannot run as its author (for an unsaved tree or a request, you). email_rule_request_not_pending: request_id names a request already decided.",
+					"description": "email_rule_author_unresolvable: the rule cannot run as its author (for an unsaved tree, a request or a rule covering you, you). email_rule_request_not_pending: request_id names a request already decided.",
 					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
 				},
 				"422": {
@@ -22305,7 +22319,7 @@ const openapiDocument = {
 		"/email-rules/test-sample": { "post": {
 			"operationId": "testEmailRuleOnSample",
 			"summary": "Test a rule against a made-up email",
-			"description": "Reports what a rule would decide for an email you describe (sender, recipients, subject, plain text, attachment types; optionally automated, from a mailing list, and a spam score), classified and decided as received mail would be. A rule reading a spam score you gave none for decides on none (unset_columns). Nothing is stored. Test an unsaved tree or a saved rule by rule_id. The answer includes what the classifier read. Needs mail:read, the email rules feature, and a member's own full-access credential (no API key, agent key or narrowed token).",
+			"description": "Reports what a rule would decide for an email you describe (sender, recipients, subject, plain text, attachment types and file names; optionally automated, from a mailing list, and a spam score), classified and decided as received mail would be. A rule reading a spam score you gave none for decides on none (unset_columns). Nothing is stored. Test an unsaved tree or a saved rule by rule_id. The answer includes what the classifier read. Needs mail:read, the email rules feature, and a member's own full-access credential (no API key, agent key or narrowed token).",
 			"tags": ["Email Rules"],
 			"security": [{ "BearerAuth": [] }],
 			"requestBody": {
@@ -22351,15 +22365,15 @@ const openapiDocument = {
 					}
 				},
 				"403": {
-					"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden. email_rule_scope_not_readable: scope_selection names something you cannot read.",
+					"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden. email_rule_scope_not_readable: scope_selection names something you cannot read. forbidden with details.reason covering_view_only: you read this rule only in the covering view, since it decided on your mail before and covers none of your mailboxes now (details.covering_view).",
 					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
 				},
 				"404": {
-					"description": "not_found: rule_id names no rule you can see (details.reason rule_not_found).",
+					"description": "not_found: rule_id names no rule you can see or that covers your mailboxes (details.reason rule_not_found).",
 					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
 				},
 				"409": {
-					"description": "email_rule_author_unresolvable: the rule cannot run as its author (for an unsaved tree, you), so it would decide nothing for real. details.reason is left, revoked, suspended, membership_ended, no_mail_read, no_own_mailbox, no_shareable_mailbox or no_selected_mailbox.",
+					"description": "email_rule_author_unresolvable: the rule cannot run as its author (for an unsaved tree or a rule covering you, you), so it would decide nothing for real. details.reason is left, revoked, suspended, membership_ended, no_mail_read, no_own_mailbox, no_shareable_mailbox or no_selected_mailbox.",
 					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
 				},
 				"429": {
@@ -22692,7 +22706,7 @@ const openapiDocument = {
 						}
 					},
 					"403": {
-						"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden. forbidden with details.reason covering_view_only (your dashboard session or the Primitive CLI only): you may read this rule only because it covers your mailbox; details.covering_view is where (getEmailRuleCoveringMe).",
+						"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden. forbidden with details.reason covering_view_only (your dashboard session or the Primitive CLI only): you may read this rule only because it covers your mailbox or decided on your mail; details.covering_view is where (getEmailRuleCoveringMe).",
 						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
 					},
 					"404": {
@@ -22837,7 +22851,7 @@ const openapiDocument = {
 			"delete": {
 				"operationId": "deleteEmailRule",
 				"summary": "Delete a rule",
-				"description": "Deletes a rule with its versions, its decisions and the access it granted. A share of it ends (end_reason rule_deleted), and the member who shared can still list what it handed over. The answer lists the shares it ended (ended_shares) and the unrevoked keys that still list it, which now read nothing through it (keys, other_keys; left out when they could not be read). The author or a reader of all the organization's mail may delete it; while it is shared, only the author or someone who manages members from the dashboard. Needs mail:read, the email rules feature, and a member's own full-access credential (no API key, agent key or narrowed token).",
+				"description": "Deletes a rule with its versions, its decisions and the access it granted. A share of it ends (end_reason rule_deleted), and the member who shared can still list what it handed over. The answer lists the shares it ended (ended_shares), says whom with (share_notice), and lists the unrevoked keys that still list it, which now read nothing through it (keys, other_keys; left out when they could not be read). The author or a reader of all the organization's mail may delete it; while it is shared, only the author or someone who manages members from the dashboard. Needs mail:read, the email rules feature, and a member's own full-access credential (no API key, agent key or narrowed token).",
 				"tags": ["Email Rules"],
 				"security": [{ "BearerAuth": [] }],
 				"parameters": [{
@@ -23030,7 +23044,7 @@ const openapiDocument = {
 					}
 				},
 				"403": {
-					"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden. grant_forbidden with details.reason mail_depth: your access to mail shows headers only, and what a rule decided is read from what emails say.",
+					"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden. grant_forbidden with details.reason mail_depth: your access to mail shows headers only, and what a rule decided is read from what emails say. forbidden with details.reason covering_view_only (your dashboard session or the Primitive CLI only): you may read this rule only because it covers your mailbox or decided on your mail; details.covering_view is where (listEmailRuleDecisionsOnMyMail).",
 					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
 				},
 				"404": {
@@ -23200,7 +23214,7 @@ const openapiDocument = {
 					"required": false,
 					"description": "Read only these version numbers, comma-separated, at most 100. Not with limit or cursor.",
 					"schema": {
-						"description": "Read only these version numbers, comma-separated. Without it, every version, newest first, a page at a time.",
+						"description": "Read only these version numbers, comma-separated. Without it, the versions listed, newest first, a page at a time.",
 						"type": "string",
 						"pattern": "^[1-9]\\d{0,8}(,[1-9]\\d{0,8}){0,99}$"
 					}
@@ -23260,7 +23274,7 @@ const openapiDocument = {
 					}
 				},
 				"403": {
-					"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden.",
+					"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden. forbidden with details.reason covering_view_only (your dashboard session or the Primitive CLI only): you may read this rule only because it covers your mailbox or decided on your mail; details.covering_view is where (listEmailRuleVersionsCoveringMe while it covers you).",
 					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
 				},
 				"404": {
@@ -25154,264 +25168,69 @@ const openapiDocument = {
 			},
 			"x-primitive-permission": ["mail:read"]
 		} },
-		"/email-rule-objections": {
-			"post": {
-				"operationId": "createEmailRuleObjection",
-				"summary": "Object to a rule over your mail",
-				"description": "Asks the author of a rule that covers one of your own mailboxes now to turn it off. Only a rule that covers you now: one you see only because it once decided on your mail cannot be objected to. An objection is seen by the member who made it, the rule's author and the organization's owners and admins. It stays pending until the rule's author accepts it, turning the rule off, or declines it, or the member who made it withdraws it, which clears its message. It never changes after that. You may have one pending objection per rule and 50 in all, and object to the same rule again only 10 minutes after you last did, whatever became of it. Needs mail:read, the email rules feature, and a member's own full-access credential (no API key, agent key or narrowed token). Only on your own dashboard session or the Primitive CLI.",
-				"tags": ["Email Rule Oversight"],
-				"security": [{ "BearerAuth": [] }],
-				"requestBody": {
+		"/email-rules/covering-me/{id}/versions": { "get": {
+			"operationId": "listEmailRuleVersionsCoveringMe",
+			"summary": "Read versions of a rule over your mail",
+			"description": "The versions of a rule that covers one of your own mailboxes now that applied to your mail: its current version and each earlier one that decided on mail at your own mailboxes, so a decision can be read in the words of the version that made it. Each has what the covering view shows of a version: its wording, tree, explanation and assumptions. A version that did neither is not listed. Without versions, newest first, a page at a time (meta.cursor); with versions, only those named that are listed, oldest first. Needs mail:read, the email rules feature, and a member's own full-access credential (no API key, agent key or narrowed token). Only on your own dashboard session or the Primitive CLI.",
+			"tags": ["Email Rule Oversight"],
+			"security": [{ "BearerAuth": [] }],
+			"parameters": [
+				{
+					"name": "id",
+					"in": "path",
 					"required": true,
-					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateEmailRuleObjectionRequest" } } }
+					"description": "The rule id.",
+					"schema": {
+						"type": "string",
+						"format": "uuid"
+					}
 				},
-				"responses": {
-					"200": {
-						"description": "Object to a rule over your mail",
-						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
-							"type": "object",
-							"required": ["data"],
-							"properties": { "data": { "$ref": "#/components/schemas/CreateEmailRuleObjectionResult" } }
-						}] } } },
-						"headers": {
-							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit" },
-							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining" },
-							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
-							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy" }
-						}
-					},
-					"400": {
-						"description": "validation_error; details.reason own_rule: it is your own rule, which you can turn off yourself.",
-						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
-					},
-					"401": {
-						"description": "Invalid or missing API key",
-						"content": { "application/json": {
-							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
-							"example": {
-								"success": false,
-								"error": {
-									"code": "unauthorized",
-									"message": "Invalid or missing API key"
-								}
-							}
-						} },
-						"headers": {
-							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-unauthenticated" },
-							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-unauthenticated" },
-							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset-unauthenticated" },
-							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-unauthenticated" }
-						}
-					},
-					"403": {
-						"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden; details.reason first_party_required means this credential is not your dashboard session or the Primitive CLI.",
-						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
-					},
-					"404": {
-						"description": "not_found: no rule with this id covers your mailboxes now.",
-						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
-					},
-					"409": {
-						"description": "conflict: details.reason objection_pending, you already have a pending objection to this rule (details.objection_id); objection_limit, you have 50 pending objections.",
-						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
-					},
-					"429": {
-						"description": "Rate limit exceeded. The `ratelimit-*` headers describe the limiter that rejected this request, with its own limit and window, not the API budget that successful responses report. A limiter that reports only a wait sends `Retry-After` alone.",
-						"headers": {
-							"Retry-After": {
-								"schema": { "type": "integer" },
-								"description": "Seconds to wait before retrying"
-							},
-							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-429" },
-							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-429" },
-							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
-							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-429" }
-						},
-						"content": { "application/json": {
-							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
-							"example": {
-								"success": false,
-								"error": {
-									"code": "rate_limit_exceeded",
-									"message": "Rate limit exceeded"
-								}
-							}
-						} }
-					},
-					"503": {
-						"description": "service_unavailable: checking which rules cover you, or the hourly limit, could not be done; nothing was written (Retry-After).",
-						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+				{
+					"name": "limit",
+					"in": "query",
+					"required": false,
+					"description": "Versions per page when versions is not given: 1 to 100, default 50.",
+					"schema": {
+						"type": "integer",
+						"minimum": 1,
+						"maximum": 100
 					}
 				},
-				"x-primitive-permission": ["mail:read"],
-				"parameters": [{
-					"name": "Idempotency-Key",
-					"in": "header",
+				{
+					"name": "cursor",
+					"in": "query",
 					"required": false,
-					"description": "Optional, and not used to deduplicate: this operation stores no result by the key, so a retry with the same key runs the request again. Operations that need a credential refuse a key that is empty, longer than 255 characters or not printable ASCII with 400 `validation_error` and echo a valid one in the Idempotency-Key response header; operations that need none ignore it.",
+					"description": "meta.cursor from the preceding page. Omit for the first page. Not with versions.",
 					"schema": {
 						"type": "string",
-						"minLength": 1,
-						"maxLength": 255
-					}
-				}]
-			},
-			"get": {
-				"operationId": "listEmailRuleObjections",
-				"summary": "List objections",
-				"description": "Objections you made, objections to rules you wrote, or every objection you can see, newest first. An objection is seen by the member who made it, the rule's author and the organization's owners and admins. It stays pending until the rule's author accepts it, turning the rule off, or declines it, or the member who made it withdraws it, which clears its message. It never changes after that. Needs mail:read, the email rules feature, and a member's own full-access credential (no API key, agent key or narrowed token). Only on your own dashboard session or the Primitive CLI.",
-				"tags": ["Email Rule Oversight"],
-				"security": [{ "BearerAuth": [] }],
-				"parameters": [
-					{
-						"name": "box",
-						"in": "query",
-						"required": false,
-						"description": "outgoing (the default): objections you made. incoming: objections to rules you wrote. all: every objection you can see.",
-						"schema": {
-							"default": "outgoing",
-							"description": "outgoing: objections you made; incoming: objections to rules you wrote; all: every objection you can see (owners and admins see the organization's).",
-							"type": "string",
-							"enum": [
-								"outgoing",
-								"incoming",
-								"all"
-							]
-						}
-					},
-					{
-						"name": "status",
-						"in": "query",
-						"required": false,
-						"description": "pending (the default), decided, or any.",
-						"schema": {
-							"default": "pending",
-							"type": "string",
-							"enum": [
-								"pending",
-								"decided",
-								"any"
-							]
-						}
-					},
-					{
-						"name": "limit",
-						"in": "query",
-						"required": false,
-						"description": "Objections per page, from 1 to 100; defaults to 25.",
-						"schema": {
-							"default": 25,
-							"type": "integer",
-							"minimum": 1,
-							"maximum": 100
-						}
-					},
-					{
-						"name": "cursor",
-						"in": "query",
-						"required": false,
-						"description": "meta.cursor from the preceding page. Omit for the first page.",
-						"schema": {
-							"type": "string",
-							"maxLength": 200
-						}
-					}
-				],
-				"responses": {
-					"200": {
-						"description": "List objections",
-						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
-							"type": "object",
-							"required": ["data", "meta"],
-							"properties": {
-								"data": { "$ref": "#/components/schemas/ListEmailRuleObjectionsResult" },
-								"meta": { "$ref": "#/components/schemas/CursorPageMeta" }
-							}
-						}] } } },
-						"headers": {
-							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit" },
-							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining" },
-							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
-							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy" }
-						}
-					},
-					"400": {
-						"description": "validation_error: a cursor not returned in meta.cursor.",
-						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
-					},
-					"401": {
-						"description": "Invalid or missing API key",
-						"content": { "application/json": {
-							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
-							"example": {
-								"success": false,
-								"error": {
-									"code": "unauthorized",
-									"message": "Invalid or missing API key"
-								}
-							}
-						} },
-						"headers": {
-							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-unauthenticated" },
-							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-unauthenticated" },
-							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset-unauthenticated" },
-							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-unauthenticated" }
-						}
-					},
-					"403": {
-						"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden; details.reason first_party_required means this credential is not your dashboard session or the Primitive CLI.",
-						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
-					},
-					"429": {
-						"description": "Rate limit exceeded. The `ratelimit-*` headers describe the limiter that rejected this request, with its own limit and window, not the API budget that successful responses report. A limiter that reports only a wait sends `Retry-After` alone.",
-						"headers": {
-							"Retry-After": {
-								"schema": { "type": "integer" },
-								"description": "Seconds to wait before retrying"
-							},
-							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-429" },
-							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-429" },
-							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
-							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-429" }
-						},
-						"content": { "application/json": {
-							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
-							"example": {
-								"success": false,
-								"error": {
-									"code": "rate_limit_exceeded",
-									"message": "Rate limit exceeded"
-								}
-							}
-						} }
+						"maxLength": 200
 					}
 				},
-				"x-primitive-permission": ["mail:read"]
-			}
-		},
-		"/email-rule-objections/{id}": { "get": {
-			"operationId": "getEmailRuleObjection",
-			"summary": "Get an objection",
-			"description": "One objection you can see. An objection is seen by the member who made it, the rule's author and the organization's owners and admins. It stays pending until the rule's author accepts it, turning the rule off, or declines it, or the member who made it withdraws it, which clears its message. It never changes after that. Needs mail:read, the email rules feature, and a member's own full-access credential (no API key, agent key or narrowed token). Only on your own dashboard session or the Primitive CLI.",
-			"tags": ["Email Rule Oversight"],
-			"security": [{ "BearerAuth": [] }],
-			"parameters": [{
-				"name": "id",
-				"in": "path",
-				"required": true,
-				"description": "The objection id.",
-				"schema": {
-					"type": "string",
-					"format": "uuid"
+				{
+					"name": "versions",
+					"in": "query",
+					"required": false,
+					"description": "Read only these version numbers, comma-separated, at most 100. Not with limit or cursor.",
+					"schema": {
+						"description": "Read only these version numbers, comma-separated. Without it, the versions listed, newest first, a page at a time.",
+						"type": "string",
+						"pattern": "^[1-9]\\d{0,8}(,[1-9]\\d{0,8}){0,99}$"
+					}
 				}
-			}],
+			],
 			"responses": {
 				"200": {
-					"description": "Get an objection",
+					"description": "Read versions of a rule over your mail",
 					"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
 						"type": "object",
 						"required": ["data"],
-						"properties": { "data": { "$ref": "#/components/schemas/GetEmailRuleObjectionResult" } }
+						"properties": {
+							"data": { "$ref": "#/components/schemas/ListEmailRuleVersionsCoveringMeResult" },
+							"meta": {
+								"$ref": "#/components/schemas/CursorPageMeta",
+								"description": "Absent when versions is given."
+							}
+						}
 					}] } } },
 					"headers": {
 						"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit" },
@@ -25420,6 +25239,10 @@ const openapiDocument = {
 						"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy" }
 					}
 				},
+				"400": {
+					"description": "validation_error: a cursor not returned in meta.cursor, or versions with limit or cursor.",
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+				},
 				"401": {
 					"description": "Invalid or missing API key",
 					"content": { "application/json": {
@@ -25440,11 +25263,331 @@ const openapiDocument = {
 					}
 				},
 				"403": {
-					"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden; details.reason first_party_required means this credential is not your dashboard session or the Primitive CLI.",
+					"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden; details.reason first_party_required means this credential is not your dashboard session or the Primitive CLI. forbidden with details.reason no_longer_covers: it decided on your mail before but covers none of your mailboxes now; details.covering_view (getEmailRuleCoveringMe) shows the version that last decided on your mail.",
 					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
 				},
 				"404": {
-					"description": "not_found: no objection with this id that you can see.",
+					"description": "not_found: no rule with this id covers your mailboxes or decided on your mail.",
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+				},
+				"429": {
+					"description": "Rate limit exceeded. The `ratelimit-*` headers describe the limiter that rejected this request, with its own limit and window, not the API budget that successful responses report. A limiter that reports only a wait sends `Retry-After` alone.",
+					"headers": {
+						"Retry-After": {
+							"schema": { "type": "integer" },
+							"description": "Seconds to wait before retrying"
+						},
+						"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-429" },
+						"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-429" },
+						"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+						"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-429" }
+					},
+					"content": { "application/json": {
+						"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+						"example": {
+							"success": false,
+							"error": {
+								"code": "rate_limit_exceeded",
+								"message": "Rate limit exceeded"
+							}
+						}
+					} }
+				}
+			},
+			"x-primitive-permission": ["mail:read"]
+		} },
+		"/email-rule-objections": {
+			"post": {
+				"operationId": "createEmailRuleObjection",
+				"summary": "Object to a rule over your mail",
+				"description": "Asks the author of a rule that covers one of your own mailboxes now to turn it off. Only a rule that covers you now: one you see only because it once decided on your mail cannot be objected to. An objection is seen by the member who made it, the rule's author and the organization's owners and admins. It stays pending until the rule's author accepts it, turning the rule off, or declines it, or the member who made it withdraws it, which clears its message. It never changes after that. You may have one pending objection per rule and 50 in all, and object to the same rule again only 10 minutes after you last did, whatever became of it. Needs mail:read, the email rules feature, and a member's own full-access credential (no API key, agent key or narrowed token). Only on your own dashboard session or the Primitive CLI.",
+				"tags": ["Email Rule Oversight"],
+				"security": [{ "BearerAuth": [] }],
+				"requestBody": {
+					"required": true,
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateEmailRuleObjectionRequest" } } }
+				},
+				"responses": {
+					"200": {
+						"description": "Object to a rule over your mail",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
+							"type": "object",
+							"required": ["data"],
+							"properties": { "data": { "$ref": "#/components/schemas/CreateEmailRuleObjectionResult" } }
+						}] } } },
+						"headers": {
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy" }
+						}
+					},
+					"400": {
+						"description": "validation_error; details.reason own_rule: it is your own rule, which you can turn off yourself.",
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+					},
+					"401": {
+						"description": "Invalid or missing API key",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "unauthorized",
+									"message": "Invalid or missing API key"
+								}
+							}
+						} },
+						"headers": {
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-unauthenticated" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-unauthenticated" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset-unauthenticated" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-unauthenticated" }
+						}
+					},
+					"403": {
+						"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden; details.reason first_party_required means this credential is not your dashboard session or the Primitive CLI.",
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+					},
+					"404": {
+						"description": "not_found: no rule with this id covers your mailboxes now.",
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+					},
+					"409": {
+						"description": "conflict: details.reason objection_pending, you already have a pending objection to this rule (details.objection_id); objection_limit, you have 50 pending objections.",
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+					},
+					"429": {
+						"description": "Rate limit exceeded. The `ratelimit-*` headers describe the limiter that rejected this request, with its own limit and window, not the API budget that successful responses report. A limiter that reports only a wait sends `Retry-After` alone.",
+						"headers": {
+							"Retry-After": {
+								"schema": { "type": "integer" },
+								"description": "Seconds to wait before retrying"
+							},
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-429" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-429" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-429" }
+						},
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "rate_limit_exceeded",
+									"message": "Rate limit exceeded"
+								}
+							}
+						} }
+					},
+					"503": {
+						"description": "service_unavailable: checking which rules cover you, or the hourly limit, could not be done; nothing was written (Retry-After).",
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+					}
+				},
+				"x-primitive-permission": ["mail:read"],
+				"parameters": [{
+					"name": "Idempotency-Key",
+					"in": "header",
+					"required": false,
+					"description": "Optional, and not used to deduplicate: this operation stores no result by the key, so a retry with the same key runs the request again. Operations that need a credential refuse a key that is empty, longer than 255 characters or not printable ASCII with 400 `validation_error` and echo a valid one in the Idempotency-Key response header; operations that need none ignore it.",
+					"schema": {
+						"type": "string",
+						"minLength": 1,
+						"maxLength": 255
+					}
+				}]
+			},
+			"get": {
+				"operationId": "listEmailRuleObjections",
+				"summary": "List objections",
+				"description": "Objections you made and objections to rules you wrote (by default), only one of the two, or every objection you can see, newest first. An objection is seen by the member who made it, the rule's author and the organization's owners and admins. It stays pending until the rule's author accepts it, turning the rule off, or declines it, or the member who made it withdraws it, which clears its message. It never changes after that. Needs mail:read, the email rules feature, and a member's own full-access credential (no API key, agent key or narrowed token). Only on your own dashboard session or the Primitive CLI.",
+				"tags": ["Email Rule Oversight"],
+				"security": [{ "BearerAuth": [] }],
+				"parameters": [
+					{
+						"name": "box",
+						"in": "query",
+						"required": false,
+						"description": "mine (the default): objections you made and objections to rules you wrote, each saying which (is_objector, is_author). outgoing: only those you made. incoming: only those to rules you wrote. all: every objection you can see.",
+						"schema": {
+							"default": "mine",
+							"description": "mine: objections you made and objections to rules you wrote (is_objector or is_author says which); outgoing: only those you made; incoming: only those to rules you wrote; each in your current membership. all: every objection you can see (owners and admins see the organization's).",
+							"type": "string",
+							"enum": [
+								"mine",
+								"outgoing",
+								"incoming",
+								"all"
+							]
+						}
+					},
+					{
+						"name": "status",
+						"in": "query",
+						"required": false,
+						"description": "pending (the default), decided, or any.",
+						"schema": {
+							"default": "pending",
+							"type": "string",
+							"enum": [
+								"pending",
+								"decided",
+								"any"
+							]
+						}
+					},
+					{
+						"name": "limit",
+						"in": "query",
+						"required": false,
+						"description": "Objections per page, from 1 to 100; defaults to 25.",
+						"schema": {
+							"default": 25,
+							"type": "integer",
+							"minimum": 1,
+							"maximum": 100
+						}
+					},
+					{
+						"name": "cursor",
+						"in": "query",
+						"required": false,
+						"description": "meta.cursor from the preceding page. Omit for the first page.",
+						"schema": {
+							"type": "string",
+							"maxLength": 200
+						}
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "List objections",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
+							"type": "object",
+							"required": ["data", "meta"],
+							"properties": {
+								"data": { "$ref": "#/components/schemas/ListEmailRuleObjectionsResult" },
+								"meta": { "$ref": "#/components/schemas/CursorPageMeta" }
+							}
+						}] } } },
+						"headers": {
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy" }
+						}
+					},
+					"400": {
+						"description": "validation_error: a cursor not returned in meta.cursor.",
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+					},
+					"401": {
+						"description": "Invalid or missing API key",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "unauthorized",
+									"message": "Invalid or missing API key"
+								}
+							}
+						} },
+						"headers": {
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-unauthenticated" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-unauthenticated" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset-unauthenticated" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-unauthenticated" }
+						}
+					},
+					"403": {
+						"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden; details.reason first_party_required means this credential is not your dashboard session or the Primitive CLI.",
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+					},
+					"429": {
+						"description": "Rate limit exceeded. The `ratelimit-*` headers describe the limiter that rejected this request, with its own limit and window, not the API budget that successful responses report. A limiter that reports only a wait sends `Retry-After` alone.",
+						"headers": {
+							"Retry-After": {
+								"schema": { "type": "integer" },
+								"description": "Seconds to wait before retrying"
+							},
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-429" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-429" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-429" }
+						},
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "rate_limit_exceeded",
+									"message": "Rate limit exceeded"
+								}
+							}
+						} }
+					}
+				},
+				"x-primitive-permission": ["mail:read"]
+			}
+		},
+		"/email-rule-objections/{id}": { "get": {
+			"operationId": "getEmailRuleObjection",
+			"summary": "Get an objection",
+			"description": "One objection you can see. An objection is seen by the member who made it, the rule's author and the organization's owners and admins. It stays pending until the rule's author accepts it, turning the rule off, or declines it, or the member who made it withdraws it, which clears its message. It never changes after that. Needs mail:read, the email rules feature, and a member's own full-access credential (no API key, agent key or narrowed token). Only on your own dashboard session or the Primitive CLI.",
+			"tags": ["Email Rule Oversight"],
+			"security": [{ "BearerAuth": [] }],
+			"parameters": [{
+				"name": "id",
+				"in": "path",
+				"required": true,
+				"description": "The objection id.",
+				"schema": {
+					"type": "string",
+					"format": "uuid"
+				}
+			}],
+			"responses": {
+				"200": {
+					"description": "Get an objection",
+					"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
+						"type": "object",
+						"required": ["data"],
+						"properties": { "data": { "$ref": "#/components/schemas/GetEmailRuleObjectionResult" } }
+					}] } } },
+					"headers": {
+						"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit" },
+						"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining" },
+						"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+						"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy" }
+					}
+				},
+				"401": {
+					"description": "Invalid or missing API key",
+					"content": { "application/json": {
+						"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+						"example": {
+							"success": false,
+							"error": {
+								"code": "unauthorized",
+								"message": "Invalid or missing API key"
+							}
+						}
+					} },
+					"headers": {
+						"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-unauthenticated" },
+						"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-unauthenticated" },
+						"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset-unauthenticated" },
+						"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-unauthenticated" }
+					}
+				},
+				"403": {
+					"description": "feature_not_enabled: this organization lacks the email rules feature; permission refusals answer forbidden or grant_forbidden; details.reason first_party_required means this credential is not your dashboard session or the Primitive CLI.",
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+				},
+				"404": {
+					"description": "not_found: no objection with this id that you can see.",
 					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
 				},
 				"429": {
@@ -26106,6 +26249,218 @@ const openapiDocument = {
 				}
 			}]
 		} },
+		"/mail-imports/google/messages": { "post": {
+			"operationId": "importGoogleMailMessage",
+			"summary": "Import one historical Google Workspace message",
+			"description": "Requires the organization email_import entitlement, granted by staff. Only the configured current owner, using a full personal session or verified first-party CLI, may import into the configured primary mailbox. Primitive verifies the transient provider token and fetches RAW content itself. No raw uploads or client provenance are accepted. Sent, draft, spam and trash messages are skipped. Historical mail appears in normal history without live delivery effects. An indeterminate response requires retrying the same provider ID. User provider credentials are never stored or queued.",
+			"tags": ["Emails"],
+			"security": [{ "BearerAuth": [] }],
+			"requestBody": {
+				"required": true,
+				"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportGoogleMailMessageRequest" } } }
+			},
+			"responses": {
+				"200": {
+					"description": "Import one historical Google Workspace message",
+					"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
+						"type": "object",
+						"required": ["data"],
+						"properties": { "data": { "$ref": "#/components/schemas/ImportGoogleMailMessageResult" } }
+					}] } } },
+					"headers": {
+						"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit" },
+						"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining" },
+						"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+						"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy" }
+					}
+				},
+				"400": {
+					"description": "Invalid request parameters",
+					"content": { "application/json": {
+						"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+						"example": {
+							"success": false,
+							"error": {
+								"code": "validation_error",
+								"message": "Invalid domain format"
+							}
+						}
+					} }
+				},
+				"401": {
+					"description": "mail_import_provider_auth: reauthorize the provider.",
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+				},
+				"403": {
+					"description": "feature_disabled: the organization lacks email_import; or mail_import_forbidden: identity or current access differs.",
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+				},
+				"409": {
+					"description": "mail_import_cap_exceeded or mail_import_storage_limit: the fixed pilot budget is exhausted.",
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+				},
+				"422": {
+					"description": "Mail import input, content, storage or publication fence could not be accepted.",
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+				},
+				"429": {
+					"description": "Rate limit exceeded. The `ratelimit-*` headers describe the limiter that rejected this request, with its own limit and window, not the API budget that successful responses report. A limiter that reports only a wait sends `Retry-After` alone.",
+					"headers": {
+						"Retry-After": {
+							"schema": { "type": "integer" },
+							"description": "Seconds to wait before retrying"
+						},
+						"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-429" },
+						"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-429" },
+						"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+						"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-429" }
+					},
+					"content": { "application/json": {
+						"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+						"example": {
+							"success": false,
+							"error": {
+								"code": "rate_limit_exceeded",
+								"message": "Rate limit exceeded"
+							}
+						}
+					} }
+				},
+				"502": {
+					"description": "Provider acquisition failed or exceeded its deadline.",
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+				},
+				"503": {
+					"description": "mail_import_disabled or mail_import_unavailable; retry the same ID after resolving the cause.",
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+				}
+			},
+			"parameters": [{
+				"in": "header",
+				"name": "X-Primitive-Google-Access-Token",
+				"required": true,
+				"description": "Transient provider user access token. Send only in this redacted header, never in a URL or JSON body. Uses the dedicated configured desktop client and readonly/identity scopes.",
+				"schema": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 8192,
+					"writeOnly": true
+				}
+			}, {
+				"name": "Idempotency-Key",
+				"in": "header",
+				"required": false,
+				"description": "Optional, and not used to deduplicate: this operation stores no result by the key, so a retry with the same key runs the request again. Operations that need a credential refuse a key that is empty, longer than 255 characters or not printable ASCII with 400 `validation_error` and echo a valid one in the Idempotency-Key response header; operations that need none ignore it.",
+				"schema": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 255
+				}
+			}],
+			"x-primitive-permission": ["mail:read"]
+		} },
+		"/mail-imports/google/reconcile": { "post": {
+			"operationId": "reconcileGoogleMailImport",
+			"summary": "Reconcile scoped historical import attempts",
+			"description": "The same configured owner may recover expired attempts after the email_import entitlement is revoked. Recovery does not require that entitlement. Selects only server-owned manifests for the configured mailbox/account/policy. No provider token, object keys, prefixes or email IDs are accepted. Unsettled uploads remain unresolved and charged; this operation does not promise automatic cleanup after a process dies.",
+			"tags": ["Emails"],
+			"security": [{ "BearerAuth": [] }],
+			"requestBody": {
+				"required": true,
+				"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReconcileGoogleMailImportRequest" } } }
+			},
+			"responses": {
+				"200": {
+					"description": "Reconcile scoped historical import attempts",
+					"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
+						"type": "object",
+						"required": ["data"],
+						"properties": { "data": { "$ref": "#/components/schemas/ReconcileGoogleMailImportResult" } }
+					}] } } },
+					"headers": {
+						"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit" },
+						"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining" },
+						"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+						"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy" }
+					}
+				},
+				"400": {
+					"description": "Invalid request parameters",
+					"content": { "application/json": {
+						"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+						"example": {
+							"success": false,
+							"error": {
+								"code": "validation_error",
+								"message": "Invalid domain format"
+							}
+						}
+					} }
+				},
+				"401": {
+					"description": "Invalid or missing API key",
+					"content": { "application/json": {
+						"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+						"example": {
+							"success": false,
+							"error": {
+								"code": "unauthorized",
+								"message": "Invalid or missing API key"
+							}
+						}
+					} },
+					"headers": {
+						"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-unauthenticated" },
+						"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-unauthenticated" },
+						"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset-unauthenticated" },
+						"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-unauthenticated" }
+					}
+				},
+				"403": {
+					"description": "mail_import_forbidden: current owner access is required.",
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+				},
+				"429": {
+					"description": "Rate limit exceeded. The `ratelimit-*` headers describe the limiter that rejected this request, with its own limit and window, not the API budget that successful responses report. A limiter that reports only a wait sends `Retry-After` alone.",
+					"headers": {
+						"Retry-After": {
+							"schema": { "type": "integer" },
+							"description": "Seconds to wait before retrying"
+						},
+						"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-429" },
+						"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-429" },
+						"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+						"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-429" }
+					},
+					"content": { "application/json": {
+						"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+						"example": {
+							"success": false,
+							"error": {
+								"code": "rate_limit_exceeded",
+								"message": "Rate limit exceeded"
+							}
+						}
+					} }
+				},
+				"503": {
+					"description": "mail_import_disabled: no valid policy is configured; or mail_import_unavailable.",
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+				}
+			},
+			"x-primitive-permission": ["mail:read"],
+			"parameters": [{
+				"name": "Idempotency-Key",
+				"in": "header",
+				"required": false,
+				"description": "Optional, and not used to deduplicate: this operation stores no result by the key, so a retry with the same key runs the request again. Operations that need a credential refuse a key that is empty, longer than 255 characters or not printable ASCII with 400 `validation_error` and echo a valid one in the Idempotency-Key response header; operations that need none ignore it.",
+				"schema": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 255
+				}
+			}]
+		} },
 		"/emails/{id}/signal": { "post": {
 			"operationId": "signalEmail",
 			"summary": "Send a read, working or typing signal about an email",
@@ -35683,7 +36038,7 @@ const openapiDocument = {
 					"name": "Primitive-Step-Up",
 					"in": "header",
 					"required": false,
-					"description": "A single-use step-up token of purpose `org_settings.write` (Change the organization name, logo or semantic search setting), valid 5 minutes. When this operation answers 403 `step_up_required`, the person confirms at the link in `details.step_up_url` and the request is retried with the token that page shows, in this header. Accepted only with the person's own OAuth token of the client it was confirmed for; refused with a token issued for MCP, with any API key or agent connection key, and with a dashboard session.",
+					"description": "A single-use step-up token of purpose `org_settings.write` (Change the organization name, logo, semantic search setting or email notification settings), valid 5 minutes. When this operation answers 403 `step_up_required`, the person confirms at the link in `details.step_up_url` and the request is retried with the token that page shows, in this header. Accepted only with the person's own OAuth token of the client it was confirmed for; refused with a token issued for MCP, with any API key or agent connection key, and with a dashboard session.",
 					"schema": {
 						"type": "string",
 						"pattern": "^pstep_[0-9a-f]{64}$"
@@ -35834,7 +36189,7 @@ const openapiDocument = {
 					"name": "Primitive-Step-Up",
 					"in": "header",
 					"required": false,
-					"description": "A single-use step-up token of purpose `org_settings.write` (Change the organization name, logo or semantic search setting), valid 5 minutes. When this operation answers 403 `step_up_required`, the person confirms at the link in `details.step_up_url` and the request is retried with the token that page shows, in this header. Accepted only with the person's own OAuth token of the client it was confirmed for; refused with a token issued for MCP, with any API key or agent connection key, and with a dashboard session.",
+					"description": "A single-use step-up token of purpose `org_settings.write` (Change the organization name, logo, semantic search setting or email notification settings), valid 5 minutes. When this operation answers 403 `step_up_required`, the person confirms at the link in `details.step_up_url` and the request is retried with the token that page shows, in this header. Accepted only with the person's own OAuth token of the client it was confirmed for; refused with a token issued for MCP, with any API key or agent connection key, and with a dashboard session.",
 					"schema": {
 						"type": "string",
 						"pattern": "^pstep_[0-9a-f]{64}$"
@@ -35983,7 +36338,7 @@ const openapiDocument = {
 					"name": "Primitive-Step-Up",
 					"in": "header",
 					"required": false,
-					"description": "A single-use step-up token of purpose `org_settings.write` (Change the organization name, logo or semantic search setting), valid 5 minutes. When this operation answers 403 `step_up_required`, the person confirms at the link in `details.step_up_url` and the request is retried with the token that page shows, in this header. Accepted only with the person's own OAuth token of the client it was confirmed for; refused with a token issued for MCP, with any API key or agent connection key, and with a dashboard session.",
+					"description": "A single-use step-up token of purpose `org_settings.write` (Change the organization name, logo, semantic search setting or email notification settings), valid 5 minutes. When this operation answers 403 `step_up_required`, the person confirms at the link in `details.step_up_url` and the request is retried with the token that page shows, in this header. Accepted only with the person's own OAuth token of the client it was confirmed for; refused with a token issued for MCP, with any API key or agent connection key, and with a dashboard session.",
 					"schema": {
 						"type": "string",
 						"pattern": "^pstep_[0-9a-f]{64}$"
@@ -36094,34 +36449,548 @@ const openapiDocument = {
 								}
 							}
 						} }
-					},
-					"502": {
-						"description": "upstream_unavailable: the organization profile could not be reached, or (after a write) the change was saved but could not be read back. Retryable for a read; read the profile again before repeating a write.",
-						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
-					},
-					"503": {
-						"description": "upstream_unavailable: the organization profile is temporarily unavailable. Retry-After says when to retry.",
-						"headers": { "Retry-After": {
-							"description": "Seconds to wait before retrying.",
-							"schema": {
-								"type": "integer",
-								"minimum": 1
-							}
-						} },
-						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+					},
+					"502": {
+						"description": "upstream_unavailable: the organization profile could not be reached, or (after a write) the change was saved but could not be read back. Retryable for a read; read the profile again before repeating a write.",
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+					},
+					"503": {
+						"description": "upstream_unavailable: the organization profile is temporarily unavailable. Retry-After says when to retry.",
+						"headers": { "Retry-After": {
+							"description": "Seconds to wait before retrying.",
+							"schema": {
+								"type": "integer",
+								"minimum": 1
+							}
+						} },
+						"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
+					}
+				},
+				"x-primitive-permission": ["org:manage"],
+				"x-primitive-permission-alternatives": [["members:manage"]]
+			}
+		},
+		"/search-settings": {
+			"get": {
+				"operationId": "getSearchSettings",
+				"summary": "Get the semantic search setting",
+				"tags": ["Organization settings"],
+				"security": [{ "BearerAuth": [] }],
+				"description": "Whether the organization consents to semantic search, and whether it is active: it also needs a paid plan, the feature to be available to the organization, and HIPAA mode off.\n\nPerson only: a dashboard session or the person's own OAuth token (the CLI or an app they connected). API keys, agent connection keys and agents are refused.",
+				"x-primitive-person-only": { "access": "person" },
+				"parameters": [],
+				"responses": {
+					"200": {
+						"description": "Success",
+						"content": { "application/json": { "schema": {
+							"type": "object",
+							"required": ["success", "data"],
+							"properties": {
+								"success": {
+									"type": "boolean",
+									"const": true
+								},
+								"data": { "$ref": "#/components/schemas/OrgSettings_getSearchSettings_Result" }
+							}
+						} } },
+						"headers": {
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy" }
+						}
+					},
+					"400": {
+						"description": "Invalid request parameters",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "validation_error",
+									"message": "Invalid domain format"
+								}
+							}
+						} }
+					},
+					"401": {
+						"description": "Invalid or missing API key",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "unauthorized",
+									"message": "Invalid or missing API key"
+								}
+							}
+						} },
+						"headers": {
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-unauthenticated" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-unauthenticated" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset-unauthenticated" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-unauthenticated" }
+						}
+					},
+					"403": {
+						"description": "Authenticated caller lacks permission for the operation",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "forbidden",
+									"message": "Insufficient permissions"
+								}
+							}
+						} }
+					},
+					"404": {
+						"description": "Resource not found",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "not_found",
+									"message": "Resource not found"
+								}
+							}
+						} }
+					},
+					"429": {
+						"description": "Rate limit exceeded. The `ratelimit-*` headers describe the limiter that rejected this request, with its own limit and window, not the API budget that successful responses report. A limiter that reports only a wait sends `Retry-After` alone.",
+						"headers": {
+							"Retry-After": {
+								"schema": { "type": "integer" },
+								"description": "Seconds to wait before retrying"
+							},
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-429" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-429" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-429" }
+						},
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "rate_limit_exceeded",
+									"message": "Rate limit exceeded"
+								}
+							}
+						} }
+					}
+				},
+				"x-primitive-permission": ["org:read"]
+			},
+			"put": {
+				"operationId": "updateSearchSettings",
+				"summary": "Change the semantic search setting",
+				"tags": ["Organization settings"],
+				"security": [{ "BearerAuth": [] }],
+				"description": "Consent to, or withdraw consent from, semantic search. Consenting sends the organization's mail content to an embedding provider, so it is a person's decision. Turning it on is refused with 409 under HIPAA mode (hipaa_mode), without a paid plan (plan_required) or while it is not available to the organization (not_available). Turning it off is always allowed.\n\nPerson only: a dashboard session, or the person's own OAuth token with a step-up token for purpose `org_settings.write` in the Primitive-Step-Up header. Without one an OAuth token is answered 403 step_up_required, whose details carry the dashboard URL that issues it (or 403 grant_forbidden when the person's role could not do it anyway). The person's role must hold search_settings:manage. API keys and agent connection keys are refused. An agent acting for the person is refused unless it carries a step-up token the person issued in the dashboard.",
+				"x-primitive-person-only": {
+					"access": "step_up",
+					"step_up_purpose": "org_settings.write"
+				},
+				"parameters": [{
+					"name": "Primitive-Step-Up",
+					"in": "header",
+					"required": false,
+					"description": "A single-use step-up token of purpose `org_settings.write` (Change the organization name, logo, semantic search setting or email notification settings), valid 5 minutes. When this operation answers 403 `step_up_required`, the person confirms at the link in `details.step_up_url` and the request is retried with the token that page shows, in this header. Accepted only with the person's own OAuth token of the client it was confirmed for; refused with a token issued for MCP, with any API key or agent connection key, and with a dashboard session.",
+					"schema": {
+						"type": "string",
+						"pattern": "^pstep_[0-9a-f]{64}$"
+					}
+				}],
+				"responses": {
+					"200": {
+						"description": "Success",
+						"content": { "application/json": { "schema": {
+							"type": "object",
+							"required": ["success", "data"],
+							"properties": {
+								"success": {
+									"type": "boolean",
+									"const": true
+								},
+								"data": { "$ref": "#/components/schemas/OrgSettings_updateSearchSettings_Result" }
+							}
+						} } },
+						"headers": {
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy" }
+						}
+					},
+					"400": {
+						"description": "Invalid request parameters",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "validation_error",
+									"message": "Invalid domain format"
+								}
+							}
+						} }
+					},
+					"401": {
+						"description": "Invalid or missing API key",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "unauthorized",
+									"message": "Invalid or missing API key"
+								}
+							}
+						} },
+						"headers": {
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-unauthenticated" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-unauthenticated" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset-unauthenticated" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-unauthenticated" }
+						}
+					},
+					"403": {
+						"description": "Authenticated caller lacks permission for the operation",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "forbidden",
+									"message": "Insufficient permissions"
+								}
+							}
+						} }
+					},
+					"404": {
+						"description": "Resource not found",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "not_found",
+									"message": "Resource not found"
+								}
+							}
+						} }
+					},
+					"409": {
+						"description": "The request conflicts with the current state of the resource",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "conflict",
+									"message": "The request conflicts with the current state of the resource"
+								}
+							}
+						} }
+					},
+					"429": {
+						"description": "Rate limit exceeded. The `ratelimit-*` headers describe the limiter that rejected this request, with its own limit and window, not the API budget that successful responses report. A limiter that reports only a wait sends `Retry-After` alone.",
+						"headers": {
+							"Retry-After": {
+								"schema": { "type": "integer" },
+								"description": "Seconds to wait before retrying"
+							},
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-429" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-429" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-429" }
+						},
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "rate_limit_exceeded",
+									"message": "Rate limit exceeded"
+								}
+							}
+						} }
+					}
+				},
+				"requestBody": {
+					"required": true,
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrgSettings_updateSearchSettings_Input" } } }
+				},
+				"x-primitive-permission": ["search_settings:manage"]
+			}
+		},
+		"/email-notification-settings": {
+			"get": {
+				"operationId": "getEmailNotificationSettings",
+				"summary": "Get the organization's email notification settings",
+				"tags": ["Email notifications"],
+				"security": [{ "BearerAuth": [] }],
+				"description": "Every kind of notification email Primitive sends the organization's members, and who may turn it off. Each kind lists its label and description, its class, whether it needs an entitlement and whether the organization has it, the organization's mode (null for platform_required) and the modes it may choose, and whether the calling member gets it and may change that.\n\nPerson only: a dashboard session or the person's own OAuth token (the CLI or an app they connected). API keys, agent connection keys and agents are refused.",
+				"x-primitive-person-only": { "access": "person" },
+				"parameters": [],
+				"responses": {
+					"200": {
+						"description": "Success",
+						"content": { "application/json": { "schema": {
+							"type": "object",
+							"required": ["success", "data"],
+							"properties": {
+								"success": {
+									"type": "boolean",
+									"const": true
+								},
+								"data": { "$ref": "#/components/schemas/EmailNotifications_getEmailNotificationSettings_Result" }
+							}
+						} } },
+						"headers": {
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy" }
+						}
+					},
+					"400": {
+						"description": "Invalid request parameters",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "validation_error",
+									"message": "Invalid domain format"
+								}
+							}
+						} }
+					},
+					"401": {
+						"description": "Invalid or missing API key",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "unauthorized",
+									"message": "Invalid or missing API key"
+								}
+							}
+						} },
+						"headers": {
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-unauthenticated" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-unauthenticated" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset-unauthenticated" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-unauthenticated" }
+						}
+					},
+					"403": {
+						"description": "Authenticated caller lacks permission for the operation",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "forbidden",
+									"message": "Insufficient permissions"
+								}
+							}
+						} }
+					},
+					"404": {
+						"description": "Resource not found",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "not_found",
+									"message": "Resource not found"
+								}
+							}
+						} }
+					},
+					"429": {
+						"description": "Rate limit exceeded. The `ratelimit-*` headers describe the limiter that rejected this request, with its own limit and window, not the API budget that successful responses report. A limiter that reports only a wait sends `Retry-After` alone.",
+						"headers": {
+							"Retry-After": {
+								"schema": { "type": "integer" },
+								"description": "Seconds to wait before retrying"
+							},
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-429" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-429" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-429" }
+						},
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "rate_limit_exceeded",
+									"message": "Rate limit exceeded"
+								}
+							}
+						} }
+					}
+				},
+				"x-primitive-permission": ["org:read"]
+			},
+			"put": {
+				"operationId": "updateEmailNotificationSettings",
+				"summary": "Change the organization's email notification settings",
+				"tags": ["Email notifications"],
+				"security": [{ "BearerAuth": [] }],
+				"description": "Set the organization's mode for one or more kinds: off (nobody gets it), optional_on (each member gets it unless they turn it off), optional_off (only members who turn it on get it) or required (every member gets it). Kinds left out keep their mode. An unknown kind is refused with 400 (validation_error, details.reason unknown_kind). A platform_required kind is refused with 409 (conflict, details.reason platform_required), and required for an optional kind with 409 (conflict, details.reason mode_not_allowed); nothing is changed. Answers the settings as they now stand. Each kind lists its label and description, its class, whether it needs an entitlement and whether the organization has it, the organization's mode (null for platform_required) and the modes it may choose, and whether the calling member gets it and may change that.\n\nPerson only: a dashboard session, or the person's own OAuth token with a step-up token for purpose `org_settings.write` in the Primitive-Step-Up header. Without one an OAuth token is answered 403 step_up_required, whose details carry the dashboard URL that issues it (or 403 grant_forbidden when the person's role could not do it anyway). The person's role must hold notification_policy:manage. API keys and agent connection keys are refused. An agent acting for the person is refused unless it carries a step-up token the person issued in the dashboard.",
+				"x-primitive-person-only": {
+					"access": "step_up",
+					"step_up_purpose": "org_settings.write"
+				},
+				"parameters": [{
+					"name": "Primitive-Step-Up",
+					"in": "header",
+					"required": false,
+					"description": "A single-use step-up token of purpose `org_settings.write` (Change the organization name, logo, semantic search setting or email notification settings), valid 5 minutes. When this operation answers 403 `step_up_required`, the person confirms at the link in `details.step_up_url` and the request is retried with the token that page shows, in this header. Accepted only with the person's own OAuth token of the client it was confirmed for; refused with a token issued for MCP, with any API key or agent connection key, and with a dashboard session.",
+					"schema": {
+						"type": "string",
+						"pattern": "^pstep_[0-9a-f]{64}$"
+					}
+				}],
+				"responses": {
+					"200": {
+						"description": "Success",
+						"content": { "application/json": { "schema": {
+							"type": "object",
+							"required": ["success", "data"],
+							"properties": {
+								"success": {
+									"type": "boolean",
+									"const": true
+								},
+								"data": { "$ref": "#/components/schemas/EmailNotifications_updateEmailNotificationSettings_Result" }
+							}
+						} } },
+						"headers": {
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy" }
+						}
+					},
+					"400": {
+						"description": "Invalid request parameters",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "validation_error",
+									"message": "Invalid domain format"
+								}
+							}
+						} }
+					},
+					"401": {
+						"description": "Invalid or missing API key",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "unauthorized",
+									"message": "Invalid or missing API key"
+								}
+							}
+						} },
+						"headers": {
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-unauthenticated" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-unauthenticated" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset-unauthenticated" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-unauthenticated" }
+						}
+					},
+					"403": {
+						"description": "Authenticated caller lacks permission for the operation",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "forbidden",
+									"message": "Insufficient permissions"
+								}
+							}
+						} }
+					},
+					"404": {
+						"description": "Resource not found",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "not_found",
+									"message": "Resource not found"
+								}
+							}
+						} }
+					},
+					"409": {
+						"description": "The request conflicts with the current state of the resource",
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "conflict",
+									"message": "The request conflicts with the current state of the resource"
+								}
+							}
+						} }
+					},
+					"429": {
+						"description": "Rate limit exceeded. The `ratelimit-*` headers describe the limiter that rejected this request, with its own limit and window, not the API budget that successful responses report. A limiter that reports only a wait sends `Retry-After` alone.",
+						"headers": {
+							"Retry-After": {
+								"schema": { "type": "integer" },
+								"description": "Seconds to wait before retrying"
+							},
+							"ratelimit-limit": { "$ref": "#/components/headers/ratelimit-limit-429" },
+							"ratelimit-remaining": { "$ref": "#/components/headers/ratelimit-remaining-429" },
+							"ratelimit-reset": { "$ref": "#/components/headers/ratelimit-reset" },
+							"ratelimit-policy": { "$ref": "#/components/headers/ratelimit-policy-429" }
+						},
+						"content": { "application/json": {
+							"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+							"example": {
+								"success": false,
+								"error": {
+									"code": "rate_limit_exceeded",
+									"message": "Rate limit exceeded"
+								}
+							}
+						} }
 					}
 				},
-				"x-primitive-permission": ["org:manage"],
-				"x-primitive-permission-alternatives": [["members:manage"]]
+				"requestBody": {
+					"required": true,
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmailNotifications_updateEmailNotificationSettings_Input" } } }
+				},
+				"x-primitive-permission": ["notification_policy:manage"]
 			}
 		},
-		"/search-settings": {
+		"/email-notification-preferences": {
 			"get": {
-				"operationId": "getSearchSettings",
-				"summary": "Get the semantic search setting",
-				"tags": ["Organization settings"],
+				"operationId": "getEmailNotificationPreferences",
+				"summary": "Get my email notification preferences",
+				"tags": ["Email notifications"],
 				"security": [{ "BearerAuth": [] }],
-				"description": "Whether the organization consents to semantic search, and whether it is active: it also needs a paid plan, the feature to be available to the organization, and HIPAA mode off.\n\nPerson only: a dashboard session or the person's own OAuth token (the CLI or an app they connected). API keys, agent connection keys and agents are refused.",
+				"description": "The notification emails the calling member gets, and which of them they may turn on or off. Each kind lists its label and description, its class, whether it needs an entitlement and whether the organization has it, the organization's mode (null for platform_required) and the modes it may choose, and whether the calling member gets it and may change that.\n\nPerson only: a dashboard session or the person's own OAuth token (the CLI or an app they connected). The person's role must hold notifications:manage. API keys, agent connection keys and agents are refused.",
 				"x-primitive-person-only": { "access": "person" },
 				"parameters": [],
 				"responses": {
@@ -36135,7 +37004,7 @@ const openapiDocument = {
 									"type": "boolean",
 									"const": true
 								},
-								"data": { "$ref": "#/components/schemas/OrgSettings_getSearchSettings_Result" }
+								"data": { "$ref": "#/components/schemas/EmailNotifications_getEmailNotificationPreferences_Result" }
 							}
 						} } },
 						"headers": {
@@ -36227,28 +37096,16 @@ const openapiDocument = {
 						} }
 					}
 				},
-				"x-primitive-permission": ["org:read"]
+				"x-primitive-permission": ["notifications:manage"]
 			},
 			"put": {
-				"operationId": "updateSearchSettings",
-				"summary": "Change the semantic search setting",
-				"tags": ["Organization settings"],
+				"operationId": "updateEmailNotificationPreferences",
+				"summary": "Change my email notification preferences",
+				"tags": ["Email notifications"],
 				"security": [{ "BearerAuth": [] }],
-				"description": "Consent to, or withdraw consent from, semantic search. Consenting sends the organization's mail content to an embedding provider, so it is a person's decision. Turning it on is refused with 409 under HIPAA mode (hipaa_mode), without a paid plan (plan_required) or while it is not available to the organization (not_available). Turning it off is always allowed.\n\nPerson only: a dashboard session, or the person's own OAuth token with a step-up token for purpose `org_settings.write` in the Primitive-Step-Up header. Without one an OAuth token is answered 403 step_up_required, whose details carry the dashboard URL that issues it (or 403 grant_forbidden when the person's role could not do it anyway). The person's role must hold search_settings:manage. API keys and agent connection keys are refused. An agent acting for the person is refused unless it carries a step-up token the person issued in the dashboard.",
-				"x-primitive-person-only": {
-					"access": "step_up",
-					"step_up_purpose": "org_settings.write"
-				},
-				"parameters": [{
-					"name": "Primitive-Step-Up",
-					"in": "header",
-					"required": false,
-					"description": "A single-use step-up token of purpose `org_settings.write` (Change the organization name, logo or semantic search setting), valid 5 minutes. When this operation answers 403 `step_up_required`, the person confirms at the link in `details.step_up_url` and the request is retried with the token that page shows, in this header. Accepted only with the person's own OAuth token of the client it was confirmed for; refused with a token issued for MCP, with any API key or agent connection key, and with a dashboard session.",
-					"schema": {
-						"type": "string",
-						"pattern": "^pstep_[0-9a-f]{64}$"
-					}
-				}],
+				"description": "Turn one or more kinds on or off for the calling member. Only a kind whose organization mode is optional_on or optional_off can be changed: a platform_required kind, one the organization requires, and one it turned off are refused with 409 (conflict, details.reason not_member_choice, details.org_mode saying which), and nothing is changed. An unknown kind is refused with 400. Answers the preferences as they now stand. Each kind lists its label and description, its class, whether it needs an entitlement and whether the organization has it, the organization's mode (null for platform_required) and the modes it may choose, and whether the calling member gets it and may change that.\n\nPerson only: a dashboard session or the person's own OAuth token (the CLI or an app they connected). The person's role must hold notifications:manage. API keys, agent connection keys and agents are refused.",
+				"x-primitive-person-only": { "access": "person" },
+				"parameters": [],
 				"responses": {
 					"200": {
 						"description": "Success",
@@ -36260,7 +37117,7 @@ const openapiDocument = {
 									"type": "boolean",
 									"const": true
 								},
-								"data": { "$ref": "#/components/schemas/OrgSettings_updateSearchSettings_Result" }
+								"data": { "$ref": "#/components/schemas/EmailNotifications_updateEmailNotificationPreferences_Result" }
 							}
 						} } },
 						"headers": {
@@ -36367,9 +37224,9 @@ const openapiDocument = {
 				},
 				"requestBody": {
 					"required": true,
-					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrgSettings_updateSearchSettings_Input" } } }
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmailNotifications_updateEmailNotificationPreferences_Input" } } }
 				},
-				"x-primitive-permission": ["search_settings:manage"]
+				"x-primitive-permission": ["notifications:manage"]
 			}
 		},
 		"/roles": {
@@ -40304,6 +41161,7 @@ const openapiDocument = {
 									"agent_work_version_conflict",
 									"already_claimed",
 									"already_member",
+									"always_sent",
 									"archive_busy",
 									"archive_invalid",
 									"archive_limit_exceeded",
@@ -40425,6 +41283,22 @@ const openapiDocument = {
 									"latest_message_mismatch",
 									"latest_message_thread_unresolved",
 									"load_test_recipient_not_allowed",
+									"mail_import_cap_exceeded",
+									"mail_import_content_mismatch",
+									"mail_import_deadline",
+									"mail_import_disabled",
+									"mail_import_fenced",
+									"mail_import_forbidden",
+									"mail_import_invalid_input",
+									"mail_import_invalid_provider_response",
+									"mail_import_out_of_window",
+									"mail_import_policy_mismatch",
+									"mail_import_provider_auth",
+									"mail_import_provider_unavailable",
+									"mail_import_storage_failed",
+									"mail_import_storage_limit",
+									"mail_import_too_large",
+									"mail_import_unavailable",
 									"mail_relay_unavailable",
 									"mail_routing_conflict",
 									"mail_topic_edit_conflict",
@@ -40480,6 +41354,7 @@ const openapiDocument = {
 									"removal_failed",
 									"removal_timeout",
 									"request_expired",
+									"required_by_organization",
 									"resend_limit_exceeded",
 									"resend_too_soon",
 									"role_assigned",
@@ -43288,6 +44163,11 @@ const openapiDocument = {
 							}
 						}
 					},
+					"attachments": {
+						"type": "array",
+						"items": { "$ref": "#/components/schemas/EmailAttachment" },
+						"description": "Attachment metadata (file name, type, size), the same items in the same order as `parsed.attachments`. Kept for a credential that reads headers only, where `parsed` is null. Empty when the email has none, its content is withheld (read `status` and `rejection_reason`), or it is not parsed yet or its parse failed (read `parse_status`). No bytes; download a part with `/emails/{id}/attachments/{part_index}`."
+					},
 					"imported": {
 						"type": ["object", "null"],
 						"description": "Historical acquisition; never sender or SMTP delivery proof. Null for live mail. Excluded from live tails and deltas.",
@@ -43346,6 +44226,7 @@ const openapiDocument = {
 					"from_verified",
 					"from_header_email",
 					"from_name",
+					"attachments",
 					"imported",
 					"snippet"
 				]
@@ -44167,6 +45048,33 @@ const openapiDocument = {
 							}
 						}
 					},
+					"unsubscribe": {
+						"type": "object",
+						"additionalProperties": false,
+						"required": ["url"],
+						"description": "One-click unsubscribe for the message. Primitive writes a `List-Unsubscribe` header naming `url` (and `mailto` when given) and, unless `one_click` is false, `List-Unsubscribe-Post: List-Unsubscribe=One-Click` (RFC 8058), and DKIM-signs both. A receiver that offers one-click unsubscribe sends an HTTPS POST to `url` with the form body `List-Unsubscribe=One-Click`; your endpoint records the unsubscribe. Every recipient of the message gets the same `url`, so send one message per recipient when the URL identifies who to unsubscribe. The `headers` map refuses both header names, so this field is the only way to set them, and the headers it adds count toward the 25 entries `headers` may hold. A field whose rendered `List-Unsubscribe` would pass 980 characters is refused. Not accepted on a repeating send.",
+						"properties": {
+							"url": {
+								"type": "string",
+								"minLength": 1,
+								"maxLength": 700,
+								"pattern": "^[Hh][Tt][Tt][Pp][Ss]://(?:[A-Za-z0-9\\-._~:/?#\\[\\]@!$&'()*+;=]|%[0-9A-Fa-f]{2})+$",
+								"description": "Absolute https URL that unsubscribes the recipient, at most 700 characters of URL characters only: printable ASCII with no spaces, double quotes, angle brackets or commas (percent-encode a comma as %2C), `%` only as a percent-encoded byte, `[` and `]` only around an IPv6 address host, a port from 1 to 65535, no `=?` (which mail readers can decode as an encoded word), and no user name or password. The host must be public: not a single-label name, `localhost` or a name under `.localhost`, `.internal`, `.local`, `.home.arpa` or `.localdomain`, or a loopback, link-local, private, shared, reserved, multicast or unspecified IP address, including an IPv6 address that embeds one. The scheme is written in lower case."
+							},
+							"one_click": {
+								"type": "boolean",
+								"default": true,
+								"description": "Whether to also write `List-Unsubscribe-Post: List-Unsubscribe=One-Click`, which tells the receiver it may unsubscribe with a single POST to `url`. Set false when `url` needs the recipient to open a page and confirm."
+							},
+							"mailto": {
+								"type": "string",
+								"minLength": 3,
+								"maxLength": 254,
+								"pattern": "^[A-Za-z0-9!$'*+=_~-]+(?:\\.[A-Za-z0-9!$'*+=_~-]+)*@[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$",
+								"description": "An address to also offer as a `mailto:` unsubscribe, written after `url`. The address alone, without the `mailto:` prefix: at most 64 letters, digits and `.!$'*+=_~-` before the `@`, and a dotted domain after it. An `=` is written as `%3D` in the header."
+							}
+						}
+					},
 					"headers": {
 						"type": "object",
 						"maxProperties": 25,
@@ -45212,6 +46120,33 @@ const openapiDocument = {
 						"type": "boolean",
 						"description": "Send an informational message the receiver need not answer or wake for. It is sent as an `ack` signal (status `received`) about the message in `in_reply_to`, whose note is `body_text` (at most 2000 characters, which may be omitted). Receivers see it as `fyi: true`. Plain text only: it cannot be combined with `body_html`, `attachments`, `payload_attachments` or `scheduled_at`, and on `/send-mail` it requires `in_reply_to`."
 					},
+					"unsubscribe": {
+						"type": "object",
+						"additionalProperties": false,
+						"required": ["url"],
+						"description": "One-click unsubscribe for the message. Primitive writes a `List-Unsubscribe` header naming `url` (and `mailto` when given) and, unless `one_click` is false, `List-Unsubscribe-Post: List-Unsubscribe=One-Click` (RFC 8058), and DKIM-signs both. A receiver that offers one-click unsubscribe sends an HTTPS POST to `url` with the form body `List-Unsubscribe=One-Click`; your endpoint records the unsubscribe. Every recipient of the message gets the same `url`, so send one message per recipient when the URL identifies who to unsubscribe. The `headers` map refuses both header names, so this field is the only way to set them, and the headers it adds count toward the 25 entries `headers` may hold. A field whose rendered `List-Unsubscribe` would pass 980 characters is refused. Not accepted on a repeating send.",
+						"properties": {
+							"url": {
+								"type": "string",
+								"minLength": 1,
+								"maxLength": 700,
+								"pattern": "^[Hh][Tt][Tt][Pp][Ss]://(?:[A-Za-z0-9\\-._~:/?#\\[\\]@!$&'()*+;=]|%[0-9A-Fa-f]{2})+$",
+								"description": "Absolute https URL that unsubscribes the recipient, at most 700 characters of URL characters only: printable ASCII with no spaces, double quotes, angle brackets or commas (percent-encode a comma as %2C), `%` only as a percent-encoded byte, `[` and `]` only around an IPv6 address host, a port from 1 to 65535, no `=?` (which mail readers can decode as an encoded word), and no user name or password. The host must be public: not a single-label name, `localhost` or a name under `.localhost`, `.internal`, `.local`, `.home.arpa` or `.localdomain`, or a loopback, link-local, private, shared, reserved, multicast or unspecified IP address, including an IPv6 address that embeds one. The scheme is written in lower case."
+							},
+							"one_click": {
+								"type": "boolean",
+								"default": true,
+								"description": "Whether to also write `List-Unsubscribe-Post: List-Unsubscribe=One-Click`, which tells the receiver it may unsubscribe with a single POST to `url`. Set false when `url` needs the recipient to open a page and confirm."
+							},
+							"mailto": {
+								"type": "string",
+								"minLength": 3,
+								"maxLength": 254,
+								"pattern": "^[A-Za-z0-9!$'*+=_~-]+(?:\\.[A-Za-z0-9!$'*+=_~-]+)*@[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$",
+								"description": "An address to also offer as a `mailto:` unsubscribe, written after `url`. The address alone, without the `mailto:` prefix: at most 64 letters, digits and `.!$'*+=_~-` before the `@`, and a dotted domain after it. An `=` is written as `%3D` in the header."
+							}
+						}
+					},
 					"headers": {
 						"type": "object",
 						"maxProperties": 25,
@@ -50331,7 +51266,7 @@ const openapiDocument = {
 								},
 								"state": {
 									"type": "string",
-									"description": "Where it stands now: enabled, disabled, deleted or replaced (endpoints and routes), enabled or disabled (filters, wake schedules), live, suspended or deleted (Functions), active, paused or ended (repeating sends), scheduled (scheduled sends), active, suspended, expired or revoked (API keys), pending, claimed, connected or revoked (agents), draft, observe or active (email rules), pending, accepted, declined or withdrawn (rule requests and objections), and for a coverage notice what it told: started (a rule began covering your mailbox), new_version, or baseline (it already covered you when notices began). pending: a rule started covering your mailbox and the notices have not recorded that start yet (a restart within an hour of the last start notice is recorded without a new one); its id is then the rule's, and created_at when the rule last changed."
+									"description": "Where it stands now: enabled, disabled, deleted or replaced (endpoints and routes), enabled or disabled (filters, wake schedules), live, suspended or deleted (Functions), active, paused or ended (repeating sends), scheduled (scheduled sends), active, suspended, expired or revoked (API keys), pending, claimed, connected or revoked (agents), draft, observe or active (email rules), pending, accepted, declined or withdrawn (rule requests and objections), and for a coverage notice what it told: started (a rule was made or turned active over your mailboxes, or an active rule came to reach you; once per rule, not per mailbox), new_version, receivers_changed (who receives an active rule's matches changed: its keys, webhooks or share), or baseline (it already covered you when notices began). pending: a rule started covering your mailbox and the notices have not recorded that start yet (a restart within an hour of the last start notice is recorded without a new one); its id is then the rule's, and created_at when the rule last changed."
 								},
 								"created_at": {
 									"type": "string",
@@ -50340,7 +51275,7 @@ const openapiDocument = {
 								"ended_at": {
 									"type": ["string", "null"],
 									"format": "date-time",
-									"description": "When it was deleted, replaced or revoked, when an API key expired, when a repeating send stopped, or when a rule request or objection was decided (accepted, declined or withdrawn); null otherwise."
+									"description": "When it was deleted, replaced or revoked, when an API key expired, when a repeating send stopped, or when a rule request or objection was decided (accepted, declined or withdrawn); null otherwise, as on every coverage notice."
 								},
 								"owned_now": {
 									"type": "string",
@@ -50368,6 +51303,74 @@ const openapiDocument = {
 										"id",
 										"name"
 									]
+								},
+								"rule_id": {
+									"description": "For email_rule_coverage, always: the rule it is about, since names need not be unique (for pending, the same as id). GET /v1/email-rules/covering-me/{rule_id} shows the rule while it covers you, or as it last decided on your mail; otherwise it answers not_found.",
+									"type": "string",
+									"format": "uuid"
+								},
+								"receivers_change": {
+									"description": "For a receivers_changed notice: who received the rule's matches before and after, in totals. They can be equal when only an owner or a webhook site changed; covering-me shows them by owner. A rotated key counts once here while the old one still works; covering-me counts both.",
+									"type": "object",
+									"properties": {
+										"before": {
+											"type": "object",
+											"properties": {
+												"keys": {
+													"type": "integer",
+													"minimum": 0
+												},
+												"reads_in_full": {
+													"type": "integer",
+													"minimum": 0,
+													"description": "Of the keys, how many also read your own mail beyond the rule."
+												},
+												"webhooks": {
+													"type": "integer",
+													"minimum": 0
+												},
+												"shares": {
+													"type": "integer",
+													"minimum": 0
+												}
+											},
+											"required": [
+												"keys",
+												"reads_in_full",
+												"webhooks",
+												"shares"
+											]
+										},
+										"after": {
+											"type": "object",
+											"properties": {
+												"keys": {
+													"type": "integer",
+													"minimum": 0
+												},
+												"reads_in_full": {
+													"type": "integer",
+													"minimum": 0,
+													"description": "Of the keys, how many also read your own mail beyond the rule."
+												},
+												"webhooks": {
+													"type": "integer",
+													"minimum": 0
+												},
+												"shares": {
+													"type": "integer",
+													"minimum": 0
+												}
+											},
+											"required": [
+												"keys",
+												"reads_in_full",
+												"webhooks",
+												"shares"
+											]
+										}
+									},
+									"required": ["before", "after"]
 								}
 							},
 							"required": [
@@ -50618,7 +51621,7 @@ const openapiDocument = {
 					"checked": {
 						"type": "integer",
 						"minimum": 0,
-						"description": "Classified emails the conditions were decided for: of the newest 200 from the last 30 days in your own mailboxes (for a grant rule, those you may share), the ones you can still read."
+						"description": "Classified emails the conditions were decided for: of the newest 200 from the last 30 days in the scope counted (evaluation_scope as sent; by default your own mailboxes, for a grant rule those you may share), the ones you can still read."
 					},
 					"matched": {
 						"type": "integer",
@@ -50628,6 +51631,33 @@ const openapiDocument = {
 				},
 				"required": ["checked", "matched"]
 			},
+			"EmailRuleScopeSelection": {
+				"type": "object",
+				"properties": {
+					"addresses": {
+						"maxItems": 100,
+						"type": "array",
+						"items": {
+							"type": "string",
+							"minLength": 3,
+							"maxLength": 320,
+							"pattern": "^[^\\s@]+@[^\\s@]+$"
+						}
+					},
+					"domains": {
+						"maxItems": 50,
+						"type": "array",
+						"items": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 253,
+							"pattern": "^[^\\s@]+\\.[^\\s@]+$"
+						}
+					}
+				},
+				"additionalProperties": false,
+				"description": "For a selected rule: inboxes, and domains (each address at them the author reads); each one you can read."
+			},
 			"CompileEmailRuleRequest": {
 				"type": "object",
 				"properties": {
@@ -50645,7 +51675,17 @@ const openapiDocument = {
 					"include_sql": {
 						"description": "Also return the SQL the rule renders to. Off by default.",
 						"type": "boolean"
-					}
+					},
+					"evaluation_scope": {
+						"description": "The scope breadth is counted over, as a test of the tree runs it: send the one you will save the rule with. Nothing is saved. own_mailboxes (the default): mail to your own addresses and agents (for a rule that shares, those mail:share_own lets you share). author: all you can read, inboxes added later included. selected: what scope_selection names.",
+						"type": "string",
+						"enum": [
+							"author",
+							"own_mailboxes",
+							"selected"
+						]
+					},
+					"scope_selection": { "$ref": "#/components/schemas/EmailRuleScopeSelection" }
 				},
 				"required": ["english"],
 				"additionalProperties": false
@@ -50678,7 +51718,7 @@ const openapiDocument = {
 						"enum": ["grant", "do_not_share"]
 					},
 					"breadth": {
-						"description": "How many of your recent emails its conditions hold for, counted over your own mailboxes whatever scope you save it with, warning or not. Null when not counted in full: a rule with questions, headers-only access, no test of it possible as you, or a count that failed or ran out of time. Writes ignore it, so a compile answer (without include_sql) can be sent back unchanged.",
+						"description": "How many recent emails its conditions hold for, warning or not, counted over evaluation_scope as sent (by default your own mailboxes, whatever scope you save it with). Null when not counted in full: a rule with questions, headers-only access, no test of it possible as you, a count that failed or ran out of time, or, with no scope sent, a rule that holds only for mail to To or Cc addresses outside your own mailboxes (a warning says so). Writes ignore it, so a compile answer (without include_sql) can be sent back unchanged.",
 						"anyOf": [{ "$ref": "#/components/schemas/EmailRuleBreadth" }, { "type": "null" }]
 					},
 					"conditions_breadth": {
@@ -50855,33 +51895,6 @@ const openapiDocument = {
 				],
 				"additionalProperties": false
 			},
-			"EmailRuleScopeSelection": {
-				"type": "object",
-				"properties": {
-					"addresses": {
-						"maxItems": 100,
-						"type": "array",
-						"items": {
-							"type": "string",
-							"minLength": 3,
-							"maxLength": 320,
-							"pattern": "^[^\\s@]+@[^\\s@]+$"
-						}
-					},
-					"domains": {
-						"maxItems": 50,
-						"type": "array",
-						"items": {
-							"type": "string",
-							"minLength": 1,
-							"maxLength": 253,
-							"pattern": "^[^\\s@]+\\.[^\\s@]+$"
-						}
-					}
-				},
-				"additionalProperties": false,
-				"description": "For a selected rule: inboxes, and domains (each address at them the author reads); each one you can read."
-			},
 			"EmailRuleExpectationSampleInput": {
 				"type": "object",
 				"properties": {
@@ -50968,6 +51981,16 @@ const openapiDocument = {
 							"pattern": "^[^\\u0000]*$"
 						}
 					},
+					"attachment_names": {
+						"maxItems": 10,
+						"type": "array",
+						"items": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 255,
+							"pattern": "^[^\\u0000-\\u001f\\u007f]*$"
+						}
+					},
 					"automated": { "type": "boolean" },
 					"from_mailing_list": { "type": "boolean" },
 					"spam_score": {
@@ -51306,6 +52329,11 @@ const openapiDocument = {
 								"minimum": 0,
 								"description": "Emails decided on their conditions: matched, near_miss and no_match, less any missing a fact the rule reads."
 							},
+							"conditions_held": {
+								"description": "Of decided, how many its conditions alone held for. Compile's breadth and conditions_breadth count this over recent mail in the scope sent to it, by default your own; here it is counted over the emails this test decided.",
+								"type": "integer",
+								"minimum": 0
+							},
 							"conditions": {
 								"type": "array",
 								"items": {
@@ -51373,7 +52401,7 @@ const openapiDocument = {
 							"warnings": {
 								"type": "array",
 								"items": { "type": "string" },
-								"description": "What to look at first, such as what stopped every email when nothing matched."
+								"description": "What to look at first, such as what stopped every email when nothing matched. On a test of the recent window, a grant rule whose conditions held for more than 20% of at least 20 emails checked (at least 90% if it has no questions), or for every one of fewer, gets a warning saying so, before those about what it decided."
 							}
 						},
 						"required": [
@@ -51529,6 +52557,10 @@ const openapiDocument = {
 								"type": "array",
 								"items": { "type": "string" }
 							},
+							"attachment_names": {
+								"type": "array",
+								"items": { "type": "string" }
+							},
 							"automated": { "type": "boolean" },
 							"from_mailing_list": { "type": "boolean" }
 						},
@@ -51539,6 +52571,7 @@ const openapiDocument = {
 							"subject",
 							"text",
 							"attachment_types",
+							"attachment_names",
 							"automated",
 							"from_mailing_list"
 						],
@@ -51614,7 +52647,7 @@ const openapiDocument = {
 					},
 					"scope_selection": { "$ref": "#/components/schemas/EmailRuleScopeSelection" },
 					"rule_id": {
-						"description": "A saved rule you can see: its current version and words.",
+						"description": "A saved rule you can see, or one that covers your mailboxes (as you, sent to one of them; dashboard or Primitive CLI only): its current version and words.",
 						"type": "string",
 						"format": "uuid"
 					},
@@ -51726,7 +52759,7 @@ const openapiDocument = {
 					},
 					"scope_selection": { "$ref": "#/components/schemas/EmailRuleScopeSelection" },
 					"rule_id": {
-						"description": "A saved rule you can see. Its current version is tested.",
+						"description": "A saved rule you can see, or one that covers your mailboxes (as you; dashboard or Primitive CLI only). Its current version is tested.",
 						"type": "string",
 						"format": "uuid"
 					},
@@ -51797,6 +52830,17 @@ const openapiDocument = {
 									"maxLength": 255
 								}
 							},
+							"attachment_names": {
+								"description": "File names of those attachments, which the classifier and the questions read. With attachment_types, the same number, paired in order.",
+								"maxItems": 20,
+								"type": "array",
+								"items": {
+									"type": "string",
+									"minLength": 1,
+									"maxLength": 255,
+									"pattern": "^[^\\u0000-\\u001f\\u007f]*$"
+								}
+							},
 							"automated": {
 								"description": "Whether the email was sent automatically, as its headers would show. Defaults to false.",
 								"type": "boolean"
@@ -52019,6 +53063,15 @@ const openapiDocument = {
 						"type": "boolean",
 						"description": "Whether you are its author, in your current membership. Only its author edits it."
 					},
+					"pending_objections": {
+						"description": "To its author, on the dashboard or the Primitive CLI: objections to it waiting for their answer (GET /email-rule-objections). A write's answer leaves it out when it could not be read in time: absent is not 0.",
+						"type": "integer",
+						"minimum": 0
+					},
+					"objection_notice": {
+						"description": "With pending_objections above 0: that members asked you to turn it off, and how to answer.",
+						"type": "string"
+					},
 					"created_at": {
 						"type": "string",
 						"format": "date-time"
@@ -52036,6 +53089,27 @@ const openapiDocument = {
 						"type": "array",
 						"items": { "$ref": "#/components/schemas/EmailRuleScopeWarning" }
 					},
+					"expectations": {
+						"description": "Its saved expectations, each list by email id, as stored: on every create, and on an update that set or removed them.",
+						"type": "object",
+						"properties": {
+							"match": {
+								"type": "array",
+								"items": {
+									"type": "string",
+									"format": "uuid"
+								}
+							},
+							"no_match": {
+								"type": "array",
+								"items": {
+									"type": "string",
+									"format": "uuid"
+								}
+							}
+						},
+						"required": ["match", "no_match"]
+					},
 					"expectation_samples": {
 						"description": "Its saved made-up emails, when this write set or added some.",
 						"type": "array",
@@ -52137,6 +53211,10 @@ const openapiDocument = {
 					"notice": {
 						"description": "After a write that saved a version of an active rule keys or webhooks read without checking it first: what it changes, and how to have the next one checked.",
 						"type": "string"
+					},
+					"share_notice": {
+						"description": "After a write that ended the rule's share: that it did, given even when affects is not, with whom it was with and the version they accepted when those can be read.",
+						"type": "string"
 					}
 				},
 				"required": [
@@ -52359,7 +53437,7 @@ const openapiDocument = {
 						}
 					},
 					"warnings": {
-						"description": "The compile response's warnings. Stored as sent, then any server note they lack on an address or domain the description names that the rule does not test (on a rule request, every compiler note on the rule).",
+						"description": "The compile response's warnings. Stored as sent, then any server note they lack on an address or domain the description names that the rule does not test, or on a grant rule that tests only who an email was sent to (on a rule request, every compiler note on the rule).",
 						"maxItems": 10,
 						"type": "array",
 						"items": {
@@ -52450,6 +53528,15 @@ const openapiDocument = {
 						"type": "boolean",
 						"description": "Whether you are its author, in your current membership. Only its author edits it."
 					},
+					"pending_objections": {
+						"description": "To its author, on the dashboard or the Primitive CLI: objections to it waiting for their answer (GET /email-rule-objections). A write's answer leaves it out when it could not be read in time: absent is not 0.",
+						"type": "integer",
+						"minimum": 0
+					},
+					"objection_notice": {
+						"description": "With pending_objections above 0: that members asked you to turn it off, and how to answer.",
+						"type": "string"
+					},
 					"created_at": {
 						"type": "string",
 						"format": "date-time"
@@ -52548,6 +53635,15 @@ const openapiDocument = {
 						"type": "boolean",
 						"description": "Whether you are its author, in your current membership. Only its author edits it."
 					},
+					"pending_objections": {
+						"description": "To its author, on the dashboard or the Primitive CLI: objections to it waiting for their answer (GET /email-rule-objections). A write's answer leaves it out when it could not be read in time: absent is not 0.",
+						"type": "integer",
+						"minimum": 0
+					},
+					"objection_notice": {
+						"description": "With pending_objections above 0: that members asked you to turn it off, and how to answer.",
+						"type": "string"
+					},
 					"created_at": {
 						"type": "string",
 						"format": "date-time"
@@ -52645,7 +53741,7 @@ const openapiDocument = {
 						}
 					},
 					"warnings": {
-						"description": "The compile response's warnings. Stored as sent, then any server note they lack on an address or domain the description names that the rule does not test (on a rule request, every compiler note on the rule).",
+						"description": "The compile response's warnings. Stored as sent, then any server note they lack on an address or domain the description names that the rule does not test, or on a grant rule that tests only who an email was sent to (on a rule request, every compiler note on the rule).",
 						"maxItems": 10,
 						"type": "array",
 						"items": {
@@ -52779,6 +53875,10 @@ const openapiDocument = {
 					"other_keys": {
 						"description": "How many more keys, not revoked, list the rule that you may not read. They are not named.",
 						"type": "integer"
+					},
+					"share_notice": {
+						"description": "When the delete ended a share: that it did, with whom it was with and the version they accepted when those can be read.",
+						"type": "string"
 					}
 				},
 				"required": ["deleted"]
@@ -52953,6 +54053,16 @@ const openapiDocument = {
 								"count": {
 									"type": "integer",
 									"exclusiveMinimum": 0
+								},
+								"reads_in_full": {
+									"description": "On a rule over your mail: how many of these keys also list one of your own mailboxes, or its domain, so they read your mail there beyond what this rule matches.",
+									"type": "integer",
+									"minimum": 0
+								},
+								"newest_at": {
+									"description": "When the newest of these was made, to the minute: a key, a webhook or the share, or the rule (the share, for what reaches it only through the share) if that was later. Not when a key was given access to this rule, or anything turned back on; a rotated key shows as newly made, and one key on two rules can show the same minute under both.",
+									"type": "string",
+									"format": "date-time"
 								}
 							},
 							"required": ["owner", "count"]
@@ -53000,7 +54110,7 @@ const openapiDocument = {
 									"exclusiveMinimum": 0
 								},
 								"hosts": {
-									"description": "Distinct sites they deliver to (a host's registrable domain, or a tunnel, preview or function service alone), sorted, at most 10; \"unknown host\" (last) for any that cannot be named.",
+									"description": "Distinct sites they deliver to (the domain a host is registered under, an app's own name on a known app platform, or a function URL service in its region), sorted, at most 10; \"unknown host\" (last) for any that cannot be named.",
 									"type": "array",
 									"items": { "type": "string" }
 								},
@@ -53008,6 +54118,11 @@ const openapiDocument = {
 									"description": "Hosts past those listed.",
 									"type": "integer",
 									"minimum": 0
+								},
+								"newest_at": {
+									"description": "When the newest of these was made, to the minute: a key, a webhook or the share, or the rule (the share, for what reaches it only through the share) if that was later. Not when a key was given access to this rule, or anything turned back on; a rotated key shows as newly made, and one key on two rules can show the same minute under both.",
+									"type": "string",
+									"format": "date-time"
 								}
 							},
 							"required": ["owner", "count"]
@@ -53045,6 +54160,11 @@ const openapiDocument = {
 								"count": {
 									"type": "integer",
 									"exclusiveMinimum": 0
+								},
+								"newest_at": {
+									"description": "When the newest of these was made, to the minute: a key, a webhook or the share, or the rule (the share, for what reaches it only through the share) if that was later. Not when a key was given access to this rule, or anything turned back on; a rotated key shows as newly made, and one key on two rules can show the same minute under both.",
+									"type": "string",
+									"format": "date-time"
 								}
 							},
 							"required": ["beneficiary", "count"]
@@ -53057,7 +54177,7 @@ const openapiDocument = {
 					"webhooks",
 					"shares"
 				],
-				"description": "Who receives what the rule shares now, by person and count; empty unless it is an active grant rule."
+				"description": "Who receives what the rule shares, by person and count. As receivers, empty unless it is an active grant rule."
 			},
 			"ListEmailRuleResultsResult": {
 				"type": "object",
@@ -53519,7 +54639,7 @@ const openapiDocument = {
 						}
 					},
 					"warnings": {
-						"description": "The compile response's warnings. Stored as sent, then any server note they lack on an address or domain the description names that the rule does not test (on a rule request, every compiler note on the rule).",
+						"description": "The compile response's warnings. Stored as sent, then any server note they lack on an address or domain the description names that the rule does not test, or on a grant rule that tests only who an email was sent to (on a rule request, every compiler note on the rule).",
 						"maxItems": 10,
 						"type": "array",
 						"items": {
@@ -53921,6 +55041,15 @@ const openapiDocument = {
 						"type": "boolean",
 						"description": "Whether you are its author, in your current membership. Only its author edits it."
 					},
+					"pending_objections": {
+						"description": "To its author, on the dashboard or the Primitive CLI: objections to it waiting for their answer (GET /email-rule-objections). A write's answer leaves it out when it could not be read in time: absent is not 0.",
+						"type": "integer",
+						"minimum": 0
+					},
+					"objection_notice": {
+						"description": "With pending_objections above 0: that members asked you to turn it off, and how to answer.",
+						"type": "string"
+					},
 					"created_at": {
 						"type": "string",
 						"format": "date-time"
@@ -54141,7 +55270,7 @@ const openapiDocument = {
 						}
 					},
 					"warnings": {
-						"description": "The compile response's warnings. Stored as sent, then any server note they lack on an address or domain the description names that the rule does not test (on a rule request, every compiler note on the rule).",
+						"description": "The compile response's warnings. Stored as sent, then any server note they lack on an address or domain the description names that the rule does not test, or on a grant rule that tests only who an email was sent to (on a rule request, every compiler note on the rule).",
 						"maxItems": 10,
 						"type": "array",
 						"items": {
@@ -54186,7 +55315,7 @@ const openapiDocument = {
 					"rule": { "$ref": "#/components/schemas/EmailRuleWithVersion" },
 					"share": { "$ref": "#/components/schemas/EmailRuleShare" },
 					"notice": {
-						"description": "What is now shared, in words.",
+						"description": "What is now shared, in words. When you changed the rule and it can now match mail the request left out by who it was sent to (such as mail where an address is only copied), that comes first.",
 						"type": "string"
 					}
 				},
@@ -54551,7 +55680,11 @@ const openapiDocument = {
 						"exclusiveMinimum": 0
 					},
 					"receivers": {
-						"description": "Null when it could not be read in time; try again.",
+						"description": "Null when it could not be read in time, or for a rule shown in draft or observe that turned active or was deleted after the page was read; try again.",
+						"anyOf": [{ "$ref": "#/components/schemas/EmailRuleReceivers" }, { "type": "null" }]
+					},
+					"receivers_once_active": {
+						"description": "For a grant rule in draft or observe: who would receive what it matches once it is turned active. None of them receives anything yet. Null for any other rule, and as receivers is null.",
 						"anyOf": [{ "$ref": "#/components/schemas/EmailRuleReceivers" }, { "type": "null" }]
 					},
 					"created_at": {
@@ -54569,6 +55702,7 @@ const openapiDocument = {
 					"covers",
 					"current_version",
 					"receivers",
+					"receivers_once_active",
 					"created_at"
 				]
 			},
@@ -54639,7 +55773,11 @@ const openapiDocument = {
 						"description": "Null when covers_now is false."
 					},
 					"receivers": {
-						"description": "Null when covers_now is false (who receives it now is not about your mail), or when it could not be read in time.",
+						"description": "Null when covers_now is false (who receives it now is not about your mail), when it could not be read in time, or for a rule shown in draft or observe that turned active or was deleted after it was read; try again.",
+						"anyOf": [{ "$ref": "#/components/schemas/EmailRuleReceivers" }, { "type": "null" }]
+					},
+					"receivers_once_active": {
+						"description": "As on the list; also null when covers_now is false.",
 						"anyOf": [{ "$ref": "#/components/schemas/EmailRuleReceivers" }, { "type": "null" }]
 					},
 					"created_at": {
@@ -54669,6 +55807,7 @@ const openapiDocument = {
 					"covers",
 					"current_version",
 					"receivers",
+					"receivers_once_active",
 					"created_at",
 					"covers_now",
 					"current"
@@ -54786,6 +55925,10 @@ const openapiDocument = {
 				"type": "array",
 				"items": { "$ref": "#/components/schemas/EmailRuleDecisionOnMyMail" }
 			},
+			"ListEmailRuleVersionsCoveringMeResult": {
+				"type": "array",
+				"items": { "$ref": "#/components/schemas/EmailRuleCoveringMeVersion" }
+			},
 			"EmailRuleObjection": {
 				"type": "object",
 				"properties": {
@@ -54826,8 +55969,14 @@ const openapiDocument = {
 						"description": "Who wrote the rule.",
 						"$ref": "#/components/schemas/EmailRuleObjectionPerson"
 					},
-					"is_objector": { "type": "boolean" },
-					"is_author": { "type": "boolean" },
+					"is_objector": {
+						"type": "boolean",
+						"description": "Whether you made it, in your current membership."
+					},
+					"is_author": {
+						"type": "boolean",
+						"description": "Whether it is to a rule you wrote, in your current membership."
+					},
 					"message": {
 						"description": "Why the objector objects; null when none was given, or once withdrawn.",
 						"type": ["string", "null"]
@@ -55045,6 +56194,82 @@ const openapiDocument = {
 					"outbound_ready"
 				]
 			},
+			"ImportGoogleMailMessageRequest": {
+				"type": "object",
+				"properties": { "message_id": {
+					"type": "string",
+					"pattern": "^[A-Za-z0-9_-]{1,128}$"
+				} },
+				"required": ["message_id"],
+				"additionalProperties": false
+			},
+			"ImportGoogleMailMessageResult": { "anyOf": [
+				{
+					"type": "object",
+					"properties": {
+						"status": {
+							"type": "string",
+							"enum": ["imported", "already_present"]
+						},
+						"email_id": {
+							"type": "string",
+							"format": "uuid",
+							"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+						}
+					},
+					"required": ["status", "email_id"]
+				},
+				{
+					"type": "object",
+					"properties": { "status": {
+						"type": "string",
+						"enum": [
+							"suppressed",
+							"in_progress",
+							"indeterminate"
+						]
+					} },
+					"required": ["status"]
+				},
+				{
+					"type": "object",
+					"properties": {
+						"status": {
+							"type": "string",
+							"const": "skipped"
+						},
+						"reason": {
+							"type": "string",
+							"enum": [
+								"excluded_label",
+								"out_of_window",
+								"too_large",
+								"provider_missing"
+							]
+						}
+					},
+					"required": ["status", "reason"]
+				}
+			] },
+			"ReconcileGoogleMailImportRequest": {
+				"type": "object",
+				"properties": {},
+				"additionalProperties": false
+			},
+			"ReconcileGoogleMailImportResult": {
+				"type": "object",
+				"properties": {
+					"cleaned": {
+						"type": "integer",
+						"minimum": 0
+					},
+					"unresolved": {
+						"type": "integer",
+						"minimum": 0
+					}
+				},
+				"required": ["cleaned", "unresolved"]
+			},
 			"ThreadMute": {
 				"type": "object",
 				"required": [
@@ -59266,6 +60491,14 @@ const openapiDocument = {
 							"additionalProperties": {}
 						}
 					},
+					"mail_limits_available": {
+						"description": "Whether a key limited to some mail (addresses, domains or email rules) would be created now. While false, creating one is refused, so a client offers neither the listed-address presets nor a listed mail reach for a custom key.",
+						"type": "boolean"
+					},
+					"org_reach_available": {
+						"description": "Whether the credential policy lets a new key reach every mailbox. While false, creating one is refused, so a client offers no preset that reaches every mailbox, and a custom key lists its addresses or domains. With mail_limits_available false as well, no key can be created and every preset is unavailable.",
+						"type": "boolean"
+					},
 					"matrix": {
 						"type": "array",
 						"items": {
@@ -59651,6 +60884,27 @@ const openapiDocument = {
 							"additionalProperties": {}
 						}
 					},
+					"rules_added": {
+						"description": "Each rule (or share) the edit put on a key that reads mail, with granted_emails, how many emails it has already shared, which the key can now read while it is active: counted up to 10,000, with more: true past that; null when not counted.",
+						"type": "array",
+						"items": {
+							"type": "object",
+							"properties": {
+								"id": { "type": "string" },
+								"granted_emails": {
+									"type": ["integer", "null"],
+									"minimum": 0,
+									"maximum": 9007199254740991
+								},
+								"more": {
+									"type": "boolean",
+									"const": true
+								}
+							},
+							"required": ["id", "granted_emails"],
+							"additionalProperties": {}
+						}
+					},
 					"grant_unguarded": {
 						"description": "Present, as true, when the grant was changed without expected_grant_ref, so the change was not checked against changes made since the key was read. Send grant.ref from GET /v1/keys/{id} as expected_grant_ref to have such a change refused instead (409 conflict, details.reason grant_changed).",
 						"type": "boolean",
@@ -60519,6 +61773,304 @@ const openapiDocument = {
 				"required": ["semantic_search_opt_in"],
 				"additionalProperties": false
 			},
+			"EmailNotifications_getEmailNotificationSettings_Result": {
+				"type": "object",
+				"properties": {
+					"entitled": { "type": "boolean" },
+					"kinds": {
+						"type": "array",
+						"items": {
+							"type": "object",
+							"properties": {
+								"kind": { "type": "string" },
+								"label": { "type": "string" },
+								"description": { "type": "string" },
+								"class": {
+									"type": "string",
+									"enum": [
+										"platform_required",
+										"org_requirable",
+										"optional"
+									]
+								},
+								"entitlement_required": { "type": "boolean" },
+								"entitled": { "type": "boolean" },
+								"org_mode": {
+									"type": ["string", "null"],
+									"enum": [
+										"off",
+										"optional_on",
+										"optional_off",
+										"required",
+										null
+									]
+								},
+								"org_mode_is_default": { "type": "boolean" },
+								"org_modes": {
+									"type": "array",
+									"items": {
+										"type": "string",
+										"enum": [
+											"off",
+											"optional_on",
+											"optional_off",
+											"required"
+										]
+									}
+								},
+								"member_enabled": { "type": "boolean" },
+								"member_can_change": { "type": "boolean" }
+							},
+							"required": [
+								"kind",
+								"label",
+								"description",
+								"class",
+								"entitlement_required",
+								"entitled",
+								"org_mode",
+								"org_mode_is_default",
+								"org_modes",
+								"member_enabled",
+								"member_can_change"
+							]
+						}
+					}
+				},
+				"required": ["entitled", "kinds"]
+			},
+			"EmailNotifications_updateEmailNotificationSettings_Result": {
+				"type": "object",
+				"properties": {
+					"entitled": { "type": "boolean" },
+					"kinds": {
+						"type": "array",
+						"items": {
+							"type": "object",
+							"properties": {
+								"kind": { "type": "string" },
+								"label": { "type": "string" },
+								"description": { "type": "string" },
+								"class": {
+									"type": "string",
+									"enum": [
+										"platform_required",
+										"org_requirable",
+										"optional"
+									]
+								},
+								"entitlement_required": { "type": "boolean" },
+								"entitled": { "type": "boolean" },
+								"org_mode": {
+									"type": ["string", "null"],
+									"enum": [
+										"off",
+										"optional_on",
+										"optional_off",
+										"required",
+										null
+									]
+								},
+								"org_mode_is_default": { "type": "boolean" },
+								"org_modes": {
+									"type": "array",
+									"items": {
+										"type": "string",
+										"enum": [
+											"off",
+											"optional_on",
+											"optional_off",
+											"required"
+										]
+									}
+								},
+								"member_enabled": { "type": "boolean" },
+								"member_can_change": { "type": "boolean" }
+							},
+							"required": [
+								"kind",
+								"label",
+								"description",
+								"class",
+								"entitlement_required",
+								"entitled",
+								"org_mode",
+								"org_mode_is_default",
+								"org_modes",
+								"member_enabled",
+								"member_can_change"
+							]
+						}
+					}
+				},
+				"required": ["entitled", "kinds"]
+			},
+			"EmailNotifications_updateEmailNotificationSettings_Input": {
+				"type": "object",
+				"properties": { "modes": {
+					"type": "object",
+					"propertyNames": {
+						"type": "string",
+						"pattern": "^[a-z][a-z0-9_]{0,63}$"
+					},
+					"additionalProperties": {
+						"type": "string",
+						"enum": [
+							"off",
+							"optional_on",
+							"optional_off",
+							"required"
+						]
+					}
+				} },
+				"required": ["modes"],
+				"additionalProperties": false
+			},
+			"EmailNotifications_getEmailNotificationPreferences_Result": {
+				"type": "object",
+				"properties": {
+					"entitled": { "type": "boolean" },
+					"kinds": {
+						"type": "array",
+						"items": {
+							"type": "object",
+							"properties": {
+								"kind": { "type": "string" },
+								"label": { "type": "string" },
+								"description": { "type": "string" },
+								"class": {
+									"type": "string",
+									"enum": [
+										"platform_required",
+										"org_requirable",
+										"optional"
+									]
+								},
+								"entitlement_required": { "type": "boolean" },
+								"entitled": { "type": "boolean" },
+								"org_mode": {
+									"type": ["string", "null"],
+									"enum": [
+										"off",
+										"optional_on",
+										"optional_off",
+										"required",
+										null
+									]
+								},
+								"org_mode_is_default": { "type": "boolean" },
+								"org_modes": {
+									"type": "array",
+									"items": {
+										"type": "string",
+										"enum": [
+											"off",
+											"optional_on",
+											"optional_off",
+											"required"
+										]
+									}
+								},
+								"member_enabled": { "type": "boolean" },
+								"member_can_change": { "type": "boolean" }
+							},
+							"required": [
+								"kind",
+								"label",
+								"description",
+								"class",
+								"entitlement_required",
+								"entitled",
+								"org_mode",
+								"org_mode_is_default",
+								"org_modes",
+								"member_enabled",
+								"member_can_change"
+							]
+						}
+					}
+				},
+				"required": ["entitled", "kinds"]
+			},
+			"EmailNotifications_updateEmailNotificationPreferences_Result": {
+				"type": "object",
+				"properties": {
+					"entitled": { "type": "boolean" },
+					"kinds": {
+						"type": "array",
+						"items": {
+							"type": "object",
+							"properties": {
+								"kind": { "type": "string" },
+								"label": { "type": "string" },
+								"description": { "type": "string" },
+								"class": {
+									"type": "string",
+									"enum": [
+										"platform_required",
+										"org_requirable",
+										"optional"
+									]
+								},
+								"entitlement_required": { "type": "boolean" },
+								"entitled": { "type": "boolean" },
+								"org_mode": {
+									"type": ["string", "null"],
+									"enum": [
+										"off",
+										"optional_on",
+										"optional_off",
+										"required",
+										null
+									]
+								},
+								"org_mode_is_default": { "type": "boolean" },
+								"org_modes": {
+									"type": "array",
+									"items": {
+										"type": "string",
+										"enum": [
+											"off",
+											"optional_on",
+											"optional_off",
+											"required"
+										]
+									}
+								},
+								"member_enabled": { "type": "boolean" },
+								"member_can_change": { "type": "boolean" }
+							},
+							"required": [
+								"kind",
+								"label",
+								"description",
+								"class",
+								"entitlement_required",
+								"entitled",
+								"org_mode",
+								"org_mode_is_default",
+								"org_modes",
+								"member_enabled",
+								"member_can_change"
+							]
+						}
+					}
+				},
+				"required": ["entitled", "kinds"]
+			},
+			"EmailNotifications_updateEmailNotificationPreferences_Input": {
+				"type": "object",
+				"properties": { "preferences": {
+					"type": "object",
+					"propertyNames": {
+						"type": "string",
+						"pattern": "^[a-z][a-z0-9_]{0,63}$"
+					},
+					"additionalProperties": { "type": "boolean" }
+				} },
+				"required": ["preferences"],
+				"additionalProperties": false
+			},
 			"ListRolesResult": {
 				"type": "object",
 				"properties": {
@@ -63416,8 +64968,21 @@ const KEY_WRITE_OPERATION_IDS = /* @__PURE__ */ new Set([
 	"credentials:update-key",
 	"credentials:revoke-credential"
 ]);
-/** The operations the CLI generates commands for: the manifest without the key writes. */
-const cliOperationManifest = operationManifest.filter((operation) => !KEY_WRITE_OPERATION_IDS.has(`${operation.tagCommand}:${operation.command}`));
+const CREDENTIAL_HEADER_OPERATION_IDS = /* @__PURE__ */ new Set(["emails:import-google-mail-message"]);
+const NOT_YET_OFFERED_OPERATION_IDS = /* @__PURE__ */ new Set([
+	"email-notifications:get-email-notification-preferences",
+	"email-notifications:update-email-notification-preferences",
+	"email-notifications:get-email-notification-settings",
+	"email-notifications:update-email-notification-settings"
+]);
+/** Every operation id the CLI generates no command for. */
+const CLI_OMITTED_OPERATION_IDS = /* @__PURE__ */ new Set([
+	...KEY_WRITE_OPERATION_IDS,
+	...CREDENTIAL_HEADER_OPERATION_IDS,
+	...NOT_YET_OFFERED_OPERATION_IDS
+]);
+/** The operations the CLI generates commands for: the manifest without CLI_OMITTED_OPERATION_IDS. */
+const cliOperationManifest = operationManifest.filter((operation) => !CLI_OMITTED_OPERATION_IDS.has(`${operation.tagCommand}:${operation.command}`));
 // src/oclif/commands/activity.ts
 const API_KEY_FLAG$3 = Flags.string({
 	description: "Primitive API key override (defaults to PRIMITIVE_API_KEY or saved OAuth login credentials)",
@@ -63429,16 +64994,79 @@ const API_BASE_URL_FLAG$4 = Flags.string({
 	hidden: true
 });
 const DEFAULT_LIMIT$3 = 50;
-async function call$1(request) {
+/** How long a read of the feed keeps retrying a transient failure. */
+const ACTIVITY_RETRY_MS = 15e3;
+/** The message printed when Primitive could not be reached at all. */
+const NETWORK_ERROR_MESSAGE = "Could not reach Primitive (network error). Try again in a moment.";
+/**
+* The error for a read that got no answer at all: always a plain object, so
+* it prints the same with and without --json. The transport's own code (a
+* host that does not resolve, say) is kept as `cause`, as a word, with no
+* local detail.
+*/
+function networkErrorPayload(error) {
+	const cause = error instanceof Error ? error.cause : void 0;
+	const code = cause && typeof cause === "object" ? cause.code : void 0;
+	return {
+		code: "network_error",
+		message: NETWORK_ERROR_MESSAGE,
+		...typeof code === "string" && /^[A-Z0-9_]+$/.test(code) ? { cause: code } : {}
+	};
+}
+/**
+* One page read, retried as the CLI's waits retry a read: a rate limit, a
+* 502, 503 or 504, or a network error is tried again with backoff, up to
+* ACTIVITY_ATTEMPTS times within ACTIVITY_RETRY_MS. A read that throws is
+* taken as the network error it is. A wait (a Retry-After, or the backoff)
+* longer than the time left is not slept on: the failure is returned at once.
+*/
+async function readWithRetry(read) {
+	const deadline = Date.now() + ACTIVITY_RETRY_MS;
+	for (let attempt = 0;; attempt += 1) {
+		let result;
+		try {
+			result = await read();
+		} catch (error) {
+			result = { error };
+		}
+		const failure = transientFailure(result);
+		if (!failure || attempt + 1 >= 4) return result;
+		const wait = failure.retryAfterMs ?? backoffDelay(attempt);
+		if (wait > deadline - Date.now()) return result;
+		if (!await pauseForTransientFailure({
+			...failure,
+			retryAfterMs: wait
+		}, attempt, { deadline })) return result;
+	}
+}
+async function call$1(read) {
 	try {
-		const result = await request;
-		if (result.error !== void 0 || !result.response?.ok) return {
+		const result = await readWithRetry(read);
+		if (transientFailure(result)?.reason === "network") return {
 			ok: false,
-			payload: result.error === void 0 || result.error === null || typeof result.error === "string" ? {
-				code: "http_error",
-				message: typeof result.error === "string" && result.error.trim() || `HTTP ${result.response?.status ?? ""}`.trim()
-			} : extractErrorPayload(result.error)
+			payload: networkErrorPayload(result.error)
 		};
+		if (result.error !== void 0 || !result.response?.ok) {
+			const status = result.response?.status;
+			if (result.error instanceof Error) return {
+				ok: false,
+				response: result.response,
+				payload: {
+					code: "response_error",
+					message: `The answer could not be read${status ? ` (HTTP ${status})` : ""}. Try again in a moment.`
+				}
+			};
+			const extracted = result.error === void 0 || result.error === null || typeof result.error === "string" ? void 0 : extractErrorPayload(result.error);
+			const coded = extracted !== null && typeof extracted === "object" && typeof extracted.code === "string";
+			return {
+				ok: false,
+				response: result.response,
+				payload: coded ? extracted : {
+					code: "http_error",
+					message: typeof result.error === "string" && result.error.trim() || `HTTP ${status ?? ""}`.trim()
+				}
+			};
+		}
 		const data = result.data;
 		return {
 			ok: true,
@@ -63447,7 +65075,7 @@ async function call$1(request) {
 	} catch (error) {
 		return {
 			ok: false,
-			payload: extractErrorPayload(error)
+			payload: networkErrorPayload(error)
 		};
 	}
 }
@@ -63513,40 +65141,92 @@ function formatAskedRows(items, complete = false) {
 	const line = (cells) => cells.map((cell, i) => i === cells.length - 1 ? cell : cell.padEnd(widths[i] ?? 0)).join("  ");
 	return [line(header), ...rows.map(line)].join("\n");
 }
+const TOTAL_KEYS = [
+	"keys",
+	"reads_in_full",
+	"webhooks",
+	"shares"
+];
+/** `value` as receiver totals: an object whose four counts are all non-negative integers. */
+function receiverTotals(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+	const totals = value;
+	return TOTAL_KEYS.every((key) => {
+		const count = totals[key];
+		return typeof count === "number" && Number.isInteger(count) && count >= 0;
+	}) ? totals : null;
+}
+/**
+* What a receivers_changed notice says changed, from its totals before and
+* after: "keys 3 to 2 (1 to 0 also reading your mail beyond the rule),
+* webhooks 2 to 1",
+* or, when the totals are equal (an owner or a webhook site changed), that
+* they are. Null for any other notice, and for one whose totals are missing
+* or not counts (an older server).
+*/
+function receiversChangeText(item) {
+	if (item.state !== "receivers_changed") return null;
+	const change = item.receivers_change;
+	const before = receiverTotals(change?.before);
+	const after = receiverTotals(change?.after);
+	if (!before || !after) return null;
+	const moved = (key) => before[key] !== after[key];
+	const span = (key) => `${before[key]} to ${after[key]}`;
+	const full = moved("reads_in_full") ? ` (${span("reads_in_full")} also reading your mail beyond the rule)` : "";
+	const changed = [
+		...moved("keys") ? [`keys ${span("keys")}${full}`] : full ? [`keys ${after.keys}${full}`] : [],
+		...moved("webhooks") ? [`webhooks ${span("webhooks")}`] : [],
+		...moved("shares") ? [`shares ${span("shares")}`] : []
+	];
+	return changed.length > 0 ? changed.join(", ") : "same totals, an owner or webhook site changed";
+}
 /** Where to see what covers you now, whatever the notices have caught up with. */
 const COVERING_NOW = `\`primitive email-rule-oversight list-email-rules-covering-me\` shows what covers you now.`;
 /**
-* One line per coverage notice: what it told (started, new_version, or
-* baseline for a rule that already covered you when notices began), when, the
-* rule's name then, and its author; and, first, each rule that covers you now
-* whose notice is not written yet (pending, dated when the rule last
-* changed). No id: a notice's id is not a rule's, and no command takes it.
+* One line per coverage notice: what it told (started, new_version,
+* receivers_changed, or baseline for a rule that already covered you when
+* notices began), when, the rule's name then, and its author; and, first,
+* each rule that covers you now whose notice is not written yet (pending,
+* dated when the rule last changed), then the rule's id (rule_id; a pending
+* row's own id is the rule's), never the notice's own id, which no command
+* takes; and, when any row is a receivers_changed notice with its totals,
+* what changed in them (CHANGE).
 * `complete` says the listing is the whole of it (from the first page to the
 * last, nothing withheld). Even then an empty one is no promise that nothing
-* covers you: notices are written by a periodic job and can lag, so it
+* covers you: notices can lag, so it
 * says how far they go (`asOf`, when the server says) and where to look now.
 */
-function formatConcerningRows(items, complete = false, asOf) {
-	if (items.length === 0) return complete ? `${asOf ? `Nothing recorded for you as of ${minute(asOf)} UTC.` : "Nothing recorded for you yet."} A rule that starts covering your mail can take a few minutes to appear here. ${COVERING_NOW}` : "Nothing to show.";
+function formatConcerningRows(items, complete = false, asOf, pendingComplete) {
+	const unfinished = pendingComplete === false ? "The check for rules that cover you with no notice written yet did not finish, so some may be missing: run this again in a moment." : null;
+	if (items.length === 0) return complete ? `${asOf ? `Nothing recorded for you as of ${minute(asOf)} UTC.` : "Nothing recorded for you yet."} Notices can lag, so a rule that starts covering your mail may not appear here yet. ${COVERING_NOW}` : unfinished ? `${unfinished} ${COVERING_NOW}` : "Nothing to show.";
 	const rows = items.map((item) => [
 		item.state,
 		minute(item.created_at),
 		item.name ?? "(unnamed)",
-		item.created_through.name ?? item.created_through.id ?? ""
+		item.created_through.name ?? item.created_through.id ?? "",
+		item.rule_id ?? (item.state === "pending" ? item.id : "")
 	]);
+	const changes = items.map((item) => receiversChangeText(item));
+	const withChange = changes.some((change) => change !== null);
+	if (withChange) for (const [i, row] of rows.entries()) row.push(changes[i] ?? "");
 	const header = [
 		"NOTICE",
 		"WHEN (UTC)",
 		"RULE",
-		"AUTHOR"
+		"AUTHOR",
+		"RULE ID",
+		...withChange ? ["CHANGE"] : []
 	];
 	const widths = header.map((h, i) => Math.max(h.length, ...rows.map((row) => (row[i] ?? "").length)));
-	const line = (cells) => cells.map((cell, i) => i === cells.length - 1 ? cell : cell.padEnd(widths[i] ?? 0)).join("  ");
+	const line = (cells) => cells.map((cell, i) => i === cells.length - 1 ? cell : cell.padEnd(widths[i] ?? 0)).join("  ").trimEnd();
 	const pending = items.some((item) => item.state === "pending") ? ["", `pending: the rule covers you now and its notice is not written yet. ${COVERING_NOW}`] : [];
+	const receivers = items.some((item) => item.state === "receivers_changed") ? ["", "receivers_changed: who receives the rule's matches changed, with the totals before and after where the server sends them. `primitive email-rule-oversight get-email-rule-covering-me <rule-id>` shows who receives them now, by owner, while the rule covers you."] : [];
 	return [
 		line(header),
 		...rows.map(line),
-		...pending
+		...pending,
+		...receivers,
+		...unfinished ? ["", pending.length > 0 ? unfinished : `${unfinished} ${COVERING_NOW}`] : []
 	].join("\n");
 }
 /** What was left out, and why: no counts, only the kinds and what would show them. */
@@ -63580,9 +65260,10 @@ async function runActivityList(command, flags, relation) {
 	let covers = "";
 	let withheld = [];
 	let asOf;
+	let pendingComplete;
 	let cursor = flags.cursor;
 	for (let page = 0; page < (flags.all ? 50 : 1); page += 1) {
-		const result = await call$1(listActivityObjects({
+		const result = await call$1(() => listActivityObjects({
 			client: auth.apiClient.client,
 			query: {
 				...relation !== "created" ? { relation } : {},
@@ -63594,7 +65275,12 @@ async function runActivityList(command, flags, relation) {
 		}));
 		if (!result.ok) {
 			if (flags.json) process.stderr.write(`${JSON.stringify(result.payload)}\n`);
-			else writeErrorWithHints(result.payload);
+			else {
+				writeErrorWithHints(result.payload, result.response);
+				const cause = result.payload?.cause;
+				const hint = typeof cause === "string" ? networkErrorHint(cause) : void 0;
+				if (hint) process.stderr.write(`${hint}\n`);
+			}
 			surfaceUnauthorizedHint({
 				auth: auth.auth,
 				baseUrlOverridden: auth.baseUrlOverridden,
@@ -63606,7 +65292,11 @@ async function runActivityList(command, flags, relation) {
 		}
 		covers = result.data.covers;
 		withheld = result.data.withheld;
-		if (page === 0) asOf = result.data.as_of;
+		if (page === 0) {
+			const first = result.data;
+			asOf = first.as_of;
+			pendingComplete = first.pending_complete;
+		}
 		items.push(...result.data.items);
 		cursor = result.data.next_cursor ?? void 0;
 		if (!cursor) break;
@@ -63617,12 +65307,13 @@ async function runActivityList(command, flags, relation) {
 			items,
 			withheld,
 			next_cursor: cursor ?? null,
-			...asOf !== void 0 ? { as_of: asOf } : {}
+			...asOf !== void 0 ? { as_of: asOf } : {},
+			...pendingComplete !== void 0 ? { pending_complete: pendingComplete } : {}
 		}, null, 2));
 		return;
 	}
-	const complete = flags.state === "all" && !flags.cursor && !cursor && withheld.length === 0;
-	command.log(relation === "asked" ? formatAskedRows(items, complete) : relation === "concerning" ? formatConcerningRows(items, complete, asOf) : formatActivityRows(covers, items));
+	const complete = flags.state === "all" && !flags.cursor && !cursor && withheld.length === 0 && pendingComplete !== false;
+	command.log(relation === "asked" ? formatAskedRows(items, complete) : relation === "concerning" ? formatConcerningRows(items, complete, asOf, pendingComplete) : formatActivityRows(covers, items));
 	const notShown = formatWithheld(withheld);
 	if (notShown) command.log(`\n${notShown}`);
 	if (cursor) command.log(`\nMore: ${resumeCommand(command.config.bin, flags, cursor, relation)}`);
@@ -63705,11 +65396,11 @@ var ActivityAskedCommand = class ActivityAskedCommand extends Command {
 	}
 };
 var ActivityConcerningCommand = class ActivityConcerningCommand extends Command {
-	static description = `List what other members did that concerns your own mail, newest first: each time another member's rule started covering one of your mailboxes (started), or saved a new version while covering it (new_version), named as the rule was then, with its author. A rule that already covered you when these notices began is listed once as baseline.
+	static description = `List what other members did that concerns your own mail, newest first: each time another member's rule started covering your mailboxes, that is, it was made or turned active over them or an active rule came to reach you, once per rule, not per mailbox (started), saved a new version while covering it (new_version), or changed who receives its matches: its keys, webhooks or share (receivers_changed, with the totals before and after in the table, and under receivers_change with --json, at most once every 15 minutes for a rule), named as the rule was then, with its author. A rule that already covered you when these notices began is listed once as baseline. A rule in draft or observe grants and blocks nothing and gets no notice while it stays there, though \`primitive email-rule-oversight list-email-rules-covering-me\` lists it; turning it active is what is listed, and a rule that covers you again within an hour of its last started or baseline notice gets no new one, though a version it saved meanwhile is listed as new_version, and a change in who receives its matches as receivers_changed. A rule that stops covering you and a rename are not listed.
 
-  Notices are written by a job that runs every minute or so and can lag. Until a rule's notice is written, a rule that covers you now is listed first as pending, dated when the rule last changed, and with --json its id is the rule's.
+  Notices can lag. Until a start is written, a rule that now covers you is listed first as pending, dated when the rule last changed, and with --json its id is the rule's. When the check for such rules did not finish, the listing says so and --json carries pending_complete: false; run it again in a moment.
 
-  Signed in with \`primitive login\`, you see the notices about your own mail under your current membership. A key, an app or an agent has none. The rules that cover you now, with their ids, are listed by \`primitive email-rule-oversight list-email-rules-covering-me\`; ask a rule's author to turn it off with \`primitive email-rule-oversight create-email-rule-objection --rule-id <rule-id>\`. With --json each notice's id is the notice's, not the rule's.`;
+  Signed in with \`primitive login\`, you see the notices about your own mail under your current membership. A key, an app or an agent has none. The rules that cover you now, with their ids, are listed by \`primitive email-rule-oversight list-email-rules-covering-me\`; ask a rule's author to turn it off with \`primitive email-rule-oversight create-email-rule-objection --rule-id <rule-id>\`. The table's RULE ID, and rule_id with --json, is the rule's id, which \`primitive email-rule-oversight get-email-rule-covering-me <rule-id>\` and create-email-rule-objection --rule-id take; with --json each notice's own id is the notice's, not the rule's.`;
 	static summary = "List rules that started covering your mail or changed";
 	static examples = ["<%= config.bin %> activity concerning", "<%= config.bin %> activity concerning --all --json"];
 	static flags = {
@@ -68088,11 +69779,12 @@ async function sendFromAnswer(apiClient, authFailureContext, purpose) {
 		const missing = await missingSendPermission(apiClient);
 		if (missing) throw new MissingSendPermissionError(missing);
 	}
-	const parts = [typeof data.reason === "string" && data.reason.trim() ? data.reason.trim().replace(/\.?$/, ".") : "This credential has no single address to send from, so --from has no default."];
+	const nothingListed = addresses.length === 0 && domains.length === 0;
+	const parts = [typeof data.reason === "string" && data.reason.trim() ? data.reason.trim().replace(/\.?$/, ".") : nothingListed ? "This credential lists no address or domain it can send from, so it cannot send." : "This credential has no single address to send from, so --from has no default."];
 	if (addresses.length > 0) parts.push(`Addresses you may send from: ${addresses.join(", ")}.`);
 	if (domains.length > 0) parts.push(`${addresses.length > 0 ? "Also any" : "Any"} address at: ${domains.join(", ")}.`);
 	parts.push(await claimHint(apiClient));
-	parts.push("Pass the address to use with --from <address>.");
+	if (!nothingListed) parts.push("Pass the address to use with --from <address>.");
 	throw new Errors.CLIError(parts.filter((part) => part).join(" "), { exit: 1 });
 }
 /** The address of resolveDefaultFrom. */
@@ -70879,7 +72571,7 @@ async function checkAskedOfYou(client, now = Date.now()) {
 	const waiting = asked.more ? [`at least ${requests + objections} rule requests and objections`] : [...requests > 0 ? [plural$1(requests, "rule request")] : [], ...objections > 0 ? [plural$1(objections, "objection")] : []];
 	const items = concerning?.items ?? [];
 	const pending = items.filter((item) => item.state === "pending").length;
-	const notices = items.filter((item) => (item.state === "started" || item.state === "new_version") && Date.parse(item.created_at) >= since).length;
+	const notices = items.filter((item) => (item.state === "started" || item.state === "new_version" || item.state === "receivers_changed") && Date.parse(item.created_at) >= since).length;
 	const parts = [
 		...waiting.length > 0 ? [`${waiting.join(" and ")} waiting for you`] : [],
 		...ASKED_KINDS.filter((kind) => hidden.has(kind)).map((kind) => `${kind === "email_rule_request" ? "rule requests" : "objections"} not shown to this credential`),
@@ -70891,7 +72583,7 @@ async function checkAskedOfYou(client, now = Date.now()) {
 		const asOf = concerning?.first.as_of;
 		return {
 			status: "ok",
-			message: `nothing waiting for you; ${asOf ? `coverage notices as of ${minute(asOf)} UTC` : "coverage notices can take a few minutes to appear"}`
+			message: `nothing waiting for you; ${asOf ? `coverage notices as of ${minute(asOf)} UTC` : "coverage notices can lag"}`
 		};
 	}
 	const commands = [...waiting.length > 0 ? ["`primitive activity asked --state live`"] : [], ...pending > 0 || notices > 0 || !concerning || coverageUnfinished ? ["`primitive activity concerning`"] : []];
@@ -70929,7 +72621,7 @@ function checkReceiverStart(configDir, profileName) {
 	}
 }
 var DoctorCommand = class DoctorCommand extends Command {
-	static description = `Run a one-shot environment health check: Node version, proxy env, CLI auth resolution, /account reachability, verified-domain status, and, signed in as yourself, the rule requests and objections waiting for you and the rules that recently started covering your mail. With PRIMITIVE_AGENT_PROFILE selected, reports saved identity offline and points to whoami and exact listener status instead of account-only checks. Prints actionable hints for each warning or failure.`;
+	static description = `Run a one-shot environment health check: Node version, proxy env, CLI auth resolution, /account reachability, verified-domain status, and, signed in as yourself, the rule requests and objections waiting for you and the rules over your mail that recently started covering it or changed. With PRIMITIVE_AGENT_PROFILE selected, reports saved identity offline and points to whoami and exact listener status instead of account-only checks. Prints actionable hints for each warning or failure.`;
 	static summary = "Check the local environment and live API for common problems";
 	static examples = ["<%= config.bin %> doctor", "<%= config.bin %> doctor --api-key prim_..."];
 	static flags = {
@@ -71022,9 +72714,10 @@ var DoctorCommand = class DoctorCommand extends Command {
 	}
 };
 // src/oclif/commands/domains-zone-file.ts
-function zoneFileUrl(baseUrl, domainId, outboundOnly) {
+function zoneFileUrl(baseUrl, domainId, outboundOnly, inboundOnly = false) {
 	const url = new URL(`${baseUrl.replace(/\/$/, "")}/domains/${encodeURIComponent(domainId)}/zone-file`);
 	if (outboundOnly) url.searchParams.set("outbound_only", "true");
+	if (inboundOnly) url.searchParams.set("inbound_only", "true");
 	return url.toString();
 }
 function contentDispositionFilename(value) {
@@ -71064,7 +72757,8 @@ var DomainsZoneFileCommand = class DomainsZoneFileCommand extends Command {
 		"<%= config.bin %> domains zone-file --id <domain-id>",
 		"<%= config.bin %> domains zone-file --id <domain-id> --output example.com.zone",
 		"<%= config.bin %> domains zone-file --domain example.com --output example.com.zone",
-		"<%= config.bin %> domains zone-file --id <domain-id> --outbound-only"
+		"<%= config.bin %> domains zone-file --id <domain-id> --outbound-only",
+		"<%= config.bin %> domains zone-file --id <domain-id> --inbound-only"
 	];
 	static flags = {
 		"api-key": Flags.string({
@@ -71082,7 +72776,14 @@ var DomainsZoneFileCommand = class DomainsZoneFileCommand extends Command {
 			char: "o",
 			description: "Write the zone file to this path instead of stdout. Defaults to stdout."
 		}),
-		"outbound-only": Flags.boolean({ description: "Include only outbound DNS records. Verified domains default to outbound-only at the API; this flag is explicit for agents and scripts." }),
+		"outbound-only": Flags.boolean({
+			description: "Include only the outbound DNS records. Without it or --inbound-only, the file has every record. Not with --inbound-only.",
+			exclusive: ["inbound-only"]
+		}),
+		"inbound-only": Flags.boolean({
+			description: "Include only the inbound records: MX and the ownership TXT record. Not with --outbound-only.",
+			exclusive: ["outbound-only"]
+		}),
 		time: Flags.boolean({ description: TIME_FLAG_DESCRIPTION })
 	};
 	async run() {
@@ -71119,7 +72820,7 @@ var DomainsZoneFileCommand = class DomainsZoneFileCommand extends Command {
 			if (!domainId) throw new Errors.CLIError("Could not resolve a domain id.", { exit: 1 });
 			let response;
 			try {
-				response = await fetch(zoneFileUrl(requestConfig.resolvedApiBaseUrl, domainId, flags["outbound-only"]), { headers: {
+				response = await fetch(zoneFileUrl(requestConfig.resolvedApiBaseUrl, domainId, flags["outbound-only"], flags["inbound-only"]), { headers: {
 					...requestConfig.headers ?? {},
 					...auth.apiKey ? { authorization: `Bearer ${auth.apiKey}` } : {}
 				} });
@@ -74020,8 +75721,8 @@ const PRIMITIVE_TEAM_AUTHOR = {
 	name: "Primitive Team",
 	url: "https://primitive.dev"
 };
-const SDK_VERSION_RANGE = "^3.0.0-preview.12";
-const CLI_VERSION_RANGE = "^3.0.0-preview.12";
+const SDK_VERSION_RANGE = "^3.0.0-preview.14";
+const CLI_VERSION_RANGE = "^3.0.0-preview.14";
 const ESBUILD_VERSION_RANGE = "^0.27.0";
 function renderHandler() {
 	return `// env.PRIMITIVE_API_KEY, env.PRIMITIVE_WEBHOOK_SECRET, and
@@ -77409,6 +79110,39 @@ function keyNotes(key) {
 		return typeof description === "string" ? [description] : [];
 	});
 }
+/** Whether a note says the key reads a whole mailbox beside its email rules. */
+function isWholeMailboxNote(note) {
+	return note !== null && typeof note === "object" && note.reason === "whole_mailbox";
+}
+/**
+* The addresses and domains a key reads in full beside its email rules: the
+* whole_mailbox notes of its address_warnings, read loosely.
+*/
+function wholeMailboxAddresses(notes) {
+	if (!Array.isArray(notes)) return [];
+	return notes.flatMap((note) => {
+		if (!isWholeMailboxNote(note)) return [];
+		const address = note.address;
+		return typeof address === "string" && address ? [address] : [];
+	});
+}
+/**
+* What a key create or update says when the key reads whole mailboxes beside
+* its email rules: on stderr as a Warning line, or under --json in the
+* document's whole_mailbox_warning (the JSON guard keeps stderr empty, and the
+* answer's warnings are the server's objects). Null when it does not. The
+* exit code is not changed: the key is made or changed as asked.
+*/
+function wholeMailboxWarning(keyId, notes) {
+	if (!Array.isArray(notes) || !notes.some(isWholeMailboxNote)) return null;
+	const addresses = wholeMailboxAddresses(notes);
+	return `This key reads ${addresses.length > 0 ? `every email at ${addresses.join(", ")}` : "every email at an address or domain it lists"}, not only the emails its rules grant. An address or domain listed beside a rule is read in full. To limit a key to the rules' emails, create one with the same permissions and only --rule for its mail (no --address or --domain), then revoke this one with \`primitive keys revoke ${keyId}\`.`;
+}
+/** The notes other than whole_mailbox, which wholeMailboxWarning says instead. */
+function otherNotes(notes) {
+	if (!Array.isArray(notes)) return [];
+	return notes.filter((note) => note !== null && typeof note === "object" && !isWholeMailboxNote(note));
+}
 function formatKeyRows(rows, options = {}) {
 	if (rows.length === 0) return options.includeRevoked ? "No API keys, revoked or not." : "No API keys. Revoked keys are left out; pass --include-revoked to list them too.";
 	return rows.map((row) => {
@@ -77416,9 +79150,16 @@ function formatKeyRows(rows, options = {}) {
 		const revoked = row.status === "revoked" ? ` [revoked${row.revoked_at ? ` ${row.revoked_at}` : ""}]` : "";
 		const count = keyNotes(row).length;
 		const notes = count > 0 ? ` [${count} ${count === 1 ? "note" : "notes"}: primitive keys get ${row.id}]` : "";
-		return `${row.id}  ${row.key_prefix}  ${row.name ?? "(unnamed)"}  ${describePermissions(row.grant)}  mail: ${describeMailScope(row.grant)}  expires ${row.expires_at ?? "never"}  last used ${row.last_used_at ?? "never"}${suspended}${revoked}${notes}`;
+		const inFull = wholeMailboxAddresses(row.address_warnings);
+		const whole = inFull.length > 0 ? ` [reads all mail at ${inFull.join(", ")}, not only its rules' emails]` : "";
+		return `${row.id}  ${row.key_prefix}  ${row.name ?? "(unnamed)"}  ${describePermissions(row.grant)}  mail: ${describeMailScope(row.grant)}  expires ${row.expires_at ?? "never"}  last used ${row.last_used_at ?? "never"}${suspended}${revoked}${whole}${notes}`;
 	}).join("\n");
 }
+/** The detail line for the mailboxes a key reads in full beside its rules. */
+function wholeMailboxLines(key) {
+	const inFull = wholeMailboxAddresses(key.address_warnings);
+	return inFull.length > 0 ? [`In full:      ${inFull.join(", ")} (listed beside its rules, so every email there is read, not only what the rules grant)`] : [];
+}
 function formatKeyDetail(key) {
 	const lines = [
 		`Name:         ${key.name ?? "(unnamed)"}`,
@@ -77426,6 +79167,7 @@ function formatKeyDetail(key) {
 		`Prefix:       ${key.key_prefix}`,
 		`Kind:         ${key.kind}`,
 		`Mail:         ${describeMailScope(key.grant)}`,
+		...wholeMailboxLines(key),
 		`Created:      ${key.created_at ?? "unknown"}`,
 		`Expires:      ${key.expires_at ?? "never"}`,
 		`Last used:    ${key.last_used_at ?? "never"}`,
@@ -77525,13 +79267,16 @@ function buildCreateGrant(choice) {
 * The mail scope fields a change can restate. `ended_rules` (rules the key
 * lists that read nothing any more: a deleted rule, or a share that ended) is
 * read only: a change never sends it back, so the key is saved without them.
+* `rule_versions` (each listed rule's current version, its state and when
+* that version was saved) is read only too, and is never sent back.
 */
 const RESTATABLE_SCOPE_FIELDS = /* @__PURE__ */ new Set([
 	"addresses",
 	"domains",
 	"rules",
 	"depth",
-	"ended_rules"
+	"ended_rules",
+	"rule_versions"
 ]);
 /** Whether a change touches the key's email rules at all. */
 function changesRules(change) {
@@ -77628,7 +79373,7 @@ function buildUpdatedGrant(current, change) {
 	}
 	if (!scope || typeof scope !== "object" || Array.isArray(scope)) return {
 		ok: false,
-		message: "This key's mail scope could not be read. Change it in the dashboard."
+		message: "This key's mail scope could not be read. Change the key in the dashboard, or create a key with what you need and revoke this one."
 	};
 	const record = scope;
 	const addresses = stringList(record.addresses ?? []);
@@ -77641,9 +79386,21 @@ function buildUpdatedGrant(current, change) {
 		message: `${readdedEnded.id} reads nothing any more (${readdedEnded.reason}), so it cannot be added back to the key.`
 	};
 	const rules = heldRules ? nextRules(heldRules, change) : null;
-	if (!addresses || !domains || !rules || Object.keys(record).some((field) => !RESTATABLE_SCOPE_FIELDS.has(field))) return {
+	const unknownFields = Object.keys(record).filter((field) => !RESTATABLE_SCOPE_FIELDS.has(field));
+	if (unknownFields.length > 0) {
+		const one = unknownFields.length === 1;
+		return {
+			ok: false,
+			message: `This key's mail scope has ${one ? "a setting" : "settings"} the CLI cannot restate (${unknownFields.join(", ")}), and a change here could drop ${one ? "it" : "them"}. Change the key in the dashboard, or create a key with what you need and revoke this one.`
+		};
+	}
+	if (!addresses || !domains || !rules) return {
 		ok: false,
-		message: "This key's mail scope has settings the CLI cannot restate. Change it in the dashboard."
+		message: `This key's mail scope has ${[
+			...addresses ? [] : ["addresses"],
+			...domains ? [] : ["domains"],
+			...rules ? [] : ["rules"]
+		].join(" and ")} the CLI could not read. Change the key in the dashboard, or create a key with what you need and revoke this one.`
 	};
 	if (addresses.length === 0 && domains.length === 0 && rules.length === 0) {
 		if ((heldRules?.length ?? 0) === 0 && ended.length > 0) return {
@@ -77786,7 +79543,7 @@ var KeysCreateCommand = class KeysCreateCommand extends Command {
 
   The secret is printed once, on its own line on stdout (in the JSON with --json). Store it right away: it is not shown again and the CLI does not save it.
 
-  A key limited to email rules (--rule, repeatable) reaches only the mail those rules match. Give it mail:read with --permission, or use --preset own_addresses_read_only.
+  A key limited to email rules (--rule, repeatable) reaches only the mail those rules match. Give it mail:read with --permission, or use --preset own_addresses_read_only. An --address or --domain given beside --rule is read in full, every email there and not only what the rules match: the key is still made, and the command warns on stderr, or in whole_mailbox_warning with --json.
 
   ${keyPermissionsHelp()}`;
 	static summary = "Create an API key";
@@ -77866,9 +79623,13 @@ var KeysCreateCommand = class KeysCreateCommand extends Command {
 		const key = result.data;
 		if (!flags.json) {
 			writeWarnings(key.warnings);
-			writeWarnings(key.address_warnings);
+			writeWarnings(otherNotes(key.address_warnings));
 		}
-		printSecret(this, Boolean(flags.json), key, key.key, [
+		const whole = wholeMailboxWarning(key.id, key.address_warnings);
+		printSecret(this, Boolean(flags.json), whole ? {
+			...key,
+			whole_mailbox_warning: whole
+		} : key, key.key, [
 			`Created API key ${key.name ?? "(unnamed)"} (${key.id}), prefix ${key.key_prefix}.`,
 			`Permissions: ${describePermissions({
 				template: key.grant.template,
@@ -77882,6 +79643,7 @@ var KeysCreateCommand = class KeysCreateCommand extends Command {
 			})}`,
 			`Expires: ${key.expires_at ?? "never"}`
 		].join("\n"));
+		if (whole && !flags.json) process.stderr.write(`Warning: ${whole}\n`);
 	}
 };
 var KeysRotateCommand = class KeysRotateCommand extends Command {
@@ -77944,11 +79706,11 @@ var KeysRotateCommand = class KeysRotateCommand extends Command {
 var KeysUpdateCommand = class KeysUpdateCommand extends Command {
 	static description = `Change an API key's permissions, email rules, name or expiry. It keeps its id and secret.
 
-  --add and --remove take permissions (repeatable, or comma-separated); \`primitive keys create --help-full\` lists the permissions a key can hold. --add-rule and --remove-rule add email rules to the key or take them off, and keep its other rules. --rule replaces every rule the key has with the ones given, so pass all the rules it should keep; it cannot be combined with --add-rule or --remove-rule. --expires-at gives it a new expiry: a later one extends it, within your organization's credential policy, and is how to keep a key working past its expiry (rotating keeps the expiry). --no-expiry removes it where the policy allows. An expired key cannot be extended. Everything else about the key stays as it is, and the output lists any rules a change took off.
+  --add and --remove take permissions (repeatable, or comma-separated); \`primitive keys create --help-full\` lists the permissions a key can hold. --add-rule and --remove-rule add email rules to the key or take them off, and keep its other rules. --rule replaces every rule the key has with the ones given, so pass all the rules it should keep; it cannot be combined with --add-rule or --remove-rule. --expires-at gives it a new expiry: a later one extends it, within your organization's credential policy, and is how to keep a key working past its expiry (rotating keeps the expiry). --no-expiry removes it where the policy allows. An expired key cannot be extended. Everything else about the key stays as it is, and the output lists any rules a change took off. When the key's grant is written and it lists an address or domain beside its rules, which it reads in full, the command warns on stderr, or in whole_mailbox_warning with --json.
 
   The change runs directly; if your organization requires approval, the command prints the approval link and takes --step-up-token, as for a new key. A key never holds more than you do.
 
-  With --json it prints the key as it is now, in the shape keys get prints, with changed, warnings and address_warnings alongside, notice when its permissions or mail changed, rules_removed when a change took rules off, and rules_not_on_key for rules asked to be taken off that it did not have. A permission or rule change that leaves the grant as it is, with no --name, --expires-at or --no-expiry, sends nothing and prints the key with changed: []. If the key cannot be read back after the change, key_error says why and only the change's fields are printed.`;
+  With --json it prints the key as it is now, in the shape keys get prints, with changed, warnings and address_warnings alongside, notice when its permissions or mail changed, rules_added when a change put rules on it (each with granted_emails, how many emails the rule has already shared), rules_removed when a change took rules off, rules_not_on_key for rules asked to be taken off that it did not have, and whole_mailbox_warning when the grant written reads a whole mailbox beside its rules. A permission or rule change that leaves the grant as it is, with no --name, --expires-at or --no-expiry, sends nothing and prints the key with changed: []. If the key cannot be read back after the change, key_error says why and only the change's fields are printed.`;
 	static summary = "Change an API key";
 	static examples = [
 		"<%= config.bin %> keys update 0f0e0d0c-0b0a-4908-8706-050403020100 --add mail:send,mail:reply",
@@ -78082,6 +79844,7 @@ var KeysUpdateCommand = class KeysUpdateCommand extends Command {
 			path: { id: args.id }
 		})) : null;
 		const standingNotes = after?.ok ? after.data.address_warnings : void 0;
+		const whole = grantChanged ? wholeMailboxWarning(args.id, result.data.address_warnings) : null;
 		if (flags.json) {
 			this.log(JSON.stringify({
 				...after?.ok ? after.data : {},
@@ -78090,12 +79853,13 @@ var KeysUpdateCommand = class KeysUpdateCommand extends Command {
 				...grantChanged ? { notice: HELD_REQUEST_NOTICE } : {},
 				...grantChanged && rulesRemoved.length > 0 ? { rules_removed: rulesRemoved } : {},
 				...rulesNotOnKey.length > 0 ? { rules_not_on_key: rulesNotOnKey } : {},
-				...after && !after.ok ? { key_error: after.payload } : {}
+				...after && !after.ok ? { key_error: after.payload } : {},
+				...whole ? { whole_mailbox_warning: whole } : {}
 			}, null, 2));
 			return;
 		}
 		writeWarnings(result.data.warnings);
-		writeWarnings(result.data.address_warnings);
+		writeWarnings(whole ? otherNotes(result.data.address_warnings) : result.data.address_warnings);
 		const changed = result.data.changed;
 		this.log(changed.length > 0 ? `Updated key ${args.id}: ${changed.join(", ")}.` : `Key ${args.id} already matched; nothing changed.`);
 		if (after?.ok) {
@@ -78105,6 +79869,7 @@ var KeysUpdateCommand = class KeysUpdateCommand extends Command {
 		if (grantChanged && rulesRemoved.length > 0) this.log(`Rules taken off: ${rulesRemoved.join(", ")}`);
 		if (changed.includes("expires_at")) this.log(`Expires: ${expiry.expiresAt ?? "never"}`);
 		if (grantChanged) process.stderr.write(`${HELD_REQUEST_NOTICE}\n`);
+		if (whole) process.stderr.write(`Warning: ${whole}\n`);
 	}
 };
 /**
@@ -82558,9 +84323,51 @@ function compareVersions(a, b) {
 	}
 	return 0;
 }
-async function npmLatestVersion(fetchImpl) {
+function parseVersion(value) {
+	const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/.exec(value.trim());
+	if (!match) return null;
+	return {
+		core: match.slice(1, 4).map(Number),
+		prerelease: match[4] ? match[4].split(".") : []
+	};
+}
+/** Whether a version is a prerelease, such as 3.0.0-preview.12. */
+function isPrerelease(version) {
+	return (parseVersion(version)?.prerelease.length ?? 0) > 0;
+}
+/**
+* Compare two versions in semver order, prereleases included: 3.0.0-preview.9
+* is older than 3.0.0-preview.12, which is older than 3.0.0. Null when either
+* is not a version.
+*/
+function compareReleaseVersions(a, b) {
+	const left = parseVersion(a);
+	const right = parseVersion(b);
+	if (!left || !right) return null;
+	for (let index = 0; index < 3; index++) {
+		const difference = (left.core[index] ?? 0) - (right.core[index] ?? 0);
+		if (difference) return Math.sign(difference);
+	}
+	if (left.prerelease.length === 0 || right.prerelease.length === 0) return Math.sign(right.prerelease.length - left.prerelease.length);
+	const length = Math.max(left.prerelease.length, right.prerelease.length);
+	for (let index = 0; index < length; index++) {
+		const l = left.prerelease[index];
+		const r = right.prerelease[index];
+		if (l === void 0) return -1;
+		if (r === void 0) return 1;
+		const ln = /^\d+$/.test(l) ? Number(l) : null;
+		const rn = /^\d+$/.test(r) ? Number(r) : null;
+		if (ln !== null && rn !== null) {
+			if (ln !== rn) return Math.sign(ln - rn);
+		} else if (ln !== null) return -1;
+		else if (rn !== null) return 1;
+		else if (l !== r) return l < r ? -1 : 1;
+	}
+	return 0;
+}
+async function npmLatestVersion(fetchImpl, tag = "latest") {
 	try {
-		const response = await fetchImpl("https://registry.npmjs.org/primitive/latest", {
+		const response = await fetchImpl(`https://registry.npmjs.org/primitive/${tag}`, {
 			headers: { accept: "application/json" },
 			redirect: "follow",
 			signal: AbortSignal.timeout(3e3)
@@ -83237,11 +85044,23 @@ async function runMachineDoctor(options) {
 		"cli.version": { inspect: async () => {
 			const version = options.cliVersion;
 			if (options.minCliVersion) {
-				const compared = compareVersions(version, options.minCliVersion);
+				const compared = isPrerelease(version) ? compareReleaseVersions(version, options.minCliVersion) : compareVersions(version, options.minCliVersion);
 				if (compared === null) return check("cli.version", "warn", `Cannot compare ${version} with the required ${options.minCliVersion}.`);
 				if (compared < 0) return check("cli.version", "fail", `${version} is older than the required ${options.minCliVersion}.`, { action: "update_cli" });
 			}
-			const latest = await (options.latestVersion ?? (() => npmLatestVersion(fetchImpl)))();
+			const readLatest = options.latestVersion ?? (() => npmLatestVersion(fetchImpl));
+			if (isPrerelease(version)) {
+				const [latest, preview] = await Promise.all([readLatest(), (options.previewVersion ?? (() => npmLatestVersion(fetchImpl, "preview")))()]);
+				const released = latest ? compareReleaseVersions(version, latest) : null;
+				if (released !== null && released < 0) return check("cli.version", "warn", `${version} is a preview older than the latest release ${latest}. Install it with \`npm install -g primitive@latest\`.`, { action: "update_cli" });
+				const previewBehind = preview ? compareReleaseVersions(version, preview) : null;
+				if (previewBehind !== null && previewBehind < 0) return check("cli.version", "warn", `${version} is older than the newest preview ${preview}. Install it with \`npm install -g primitive@preview\`.`, { action: "update_cli" });
+				if (previewBehind === 0) return check("cli.version", "ok", `${version} is the newest preview.`);
+				if (previewBehind !== null) return check("cli.version", "ok", `${version} is not older than the newest preview ${preview}.`);
+				const met = options.minCliVersion ? ` meets the required ${options.minCliVersion};` : ";";
+				return check("cli.version", released !== null || options.minCliVersion ? "ok" : "skip", preview ? `${version}; the newest preview could not be compared with it (the tag is not a version).` : released !== null ? `${version} is not older than the latest release ${latest}; the newest preview could not be checked.` : `${version}${met} neither the latest release nor the newest preview could be checked.`);
+			}
+			const latest = await readLatest();
 			if (!latest) return options.minCliVersion ? check("cli.version", "ok", `${version} meets the required ${options.minCliVersion}; the latest release could not be checked.`) : check("cli.version", "skip", `${version}; the latest release could not be checked.`);
 			const behind = compareVersions(version, latest);
 			if (behind !== null && behind < 0) return check("cli.version", "warn", `${version} is older than the latest release ${latest}.`, { action: "update_cli" });
@@ -85525,7 +87344,10 @@ var ReplyCommand = class ReplyCommand extends Command {
 			description: "Reply to everyone on the email: the sender (or Reply-To) as To, every other To and Cc address as Cc, minus your own address. Bcc is never included.",
 			exclusive: ["fyi"]
 		}),
-		body: Flags.string({ description: "Plain-text reply body. Either --body or --html (or both) is required, except with --fyi." }),
+		body: Flags.string({
+			aliases: ["text"],
+			description: "Plain-text reply body (--text is the same flag). Either --body or --html (or both) is required, except with --fyi."
+		}),
 		"body-file": Flags.string({ description: "Read the plain-text reply body from a UTF-8 file; this does not attach the file. Use --attachment for attachments. Mutually exclusive with --body and --body-stdin." }),
 		"body-stdin": Flags.boolean({ description: "Read the plain-text reply body from stdin. Mutually exclusive with --body and --body-file. Stdin can only be consumed once." }),
 		html: Flags.string({ description: "HTML reply body. Either --body or --html (or both) is required." }),
@@ -86862,7 +88684,10 @@ var SendCommand = class SendCommand extends Command {
 		}),
 		from: Flags.string({ description: "Sender address. Without it: a connected agent's own address, your member address on your own login, or a key's one granted address; otherwise the command asks for --from, except that a credential without mail:send is refused by that permission." }),
 		subject: Flags.string({ description: "Subject line. Defaults to the first line of --body / --html when omitted." }),
-		body: Flags.string({ description: "Plain-text message body. Either --body or --html (or both) is required." }),
+		body: Flags.string({
+			aliases: ["text"],
+			description: "Plain-text message body (--text is the same flag). Either --body or --html (or both) is required."
+		}),
 		"body-file": Flags.string({ description: "Read the plain-text message body from a UTF-8 file. This does not attach the file; use --attachment for file attachments. Mutually exclusive with --body and --body-stdin." }),
 		"body-stdin": Flags.boolean({ description: "Read the plain-text message body from stdin. Mutually exclusive with --body and --body-file. Stdin can only be consumed once." }),
 		html: Flags.string({ description: "HTML message body. Either --body or --html (or both) is required." }),