primcli 3.0.0-preview.12 → 3.0.0-preview.13

package/dist/{api-command-CNCsVNk0.js → api-command-D5Tj9C-K.js}

@@ -1,4 +1,4 @@
-import { B as ensureSearchReportsReplyState, Gn as sdk_gen_exports, J as EMAIL_RULE_REQUEST_EVENT_TYPES, K as replyStateSurfaceForOperation, L as ReplyStateUnsupportedError, Qt as getOwnGrant, R as assertAwaitingFilterRows, Ut as getEmail, W as isAwaitingRejectedError, X as WEBHOOK_EVENT_TYPES, Y as SENT_EMAIL_EVENT_TYPES, _n as listEndpoints, at as assertAutomatedVerdict, ct as ensureSearchReportsAutomated, dt as isAutomatedRejectedError, it as AutomatedFilterUnsupportedError, lt as expectedAutomatedVerdicts, nn as getThread, ot as automatedRejectedError, q as EMAIL_RULE_OBJECTION_EVENT_TYPES, st as automatedSurfaceForOperation, v as parseRetryAfter, z as awaitingRejectedError } from "./repeats-Dj_o6c-X-wjmw2Jbx.js";
+import { B as ensureSearchReportsReplyState, Gn as sdk_gen_exports, J as EMAIL_RULE_REQUEST_EVENT_TYPES, K as replyStateSurfaceForOperation, L as ReplyStateUnsupportedError, Qt as getOwnGrant, R as assertAwaitingFilterRows, Ut as getEmail, W as isAwaitingRejectedError, X as WEBHOOK_EVENT_TYPES, Y as SENT_EMAIL_EVENT_TYPES, _n as listEndpoints, at as assertAutomatedVerdict, ct as ensureSearchReportsAutomated, dt as isAutomatedRejectedError, it as AutomatedFilterUnsupportedError, lt as expectedAutomatedVerdicts, nn as getThread, ot as automatedRejectedError, q as EMAIL_RULE_OBJECTION_EVENT_TYPES, st as automatedSurfaceForOperation, v as parseRetryAfter, z as awaitingRejectedError } from "./repeats-Dj_o6c-X-ykfsraq6.js";
 import { C as saveCliCredentials, F as agentProfilesDirectory, H as requireDefaultLoginProfile, N as agentProfileDirectory, R as loadConnectedAgentProfile, S as resolveCliAuth, W as PrimitiveApiClient, _ as deleteCliCredentials, b as loadCliCredentials, c as resolveConfigEnvironment, d as validateCliHeaderName, f as validateCliHeaderValue, i as loadCliConfig, j as AGENT_PROFILE_ENV, m as cliAccessTokenExpiresAt, p as acquireCliCredentialsLock, w as saveSignupCredentials, x as normalizeApiBaseUrl, y as detectPrimitiveKeyEnvMisname } from "./cli-config-Ms_0vNjq.js";
 import "./oclif/global-org-flag.js";
 import { a as thrownErrorBody } from "./json-output-ch756TXV.js";
@@ -863,7 +863,7 @@ const operationManifest = [
 							},
 							"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, 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",
@@ -872,7 +872,7 @@ const operationManifest = [
 							"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",
@@ -900,6 +900,11 @@ const operationManifest = [
 									"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"
 							}
 						},
 						"required": [
@@ -11227,6 +11232,27 @@ const operationManifest = [
 						"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",
@@ -12344,11 +12370,17 @@ const operationManifest = [
 			"type": "string"
 		}],
 		"queryParams": [{
-			"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.",
 			"enum": null,
 			"name": "outbound_only",
 			"required": false,
 			"type": "boolean"
+		}, {
+			"description": "When true, include only inbound MX and ownership TXT records. Cannot be combined with outbound_only=true.",
+			"enum": null,
+			"name": "inbound_only",
+			"required": false,
+			"type": "boolean"
 		}],
 		"headerParams": [],
 		"permissions": ["domains:read"],
@@ -13141,8 +13173,14 @@ const operationManifest = [
 						"email"
 					]
 				},
-				"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"]
@@ -13289,8 +13327,14 @@ const operationManifest = [
 						"email"
 					]
 				},
-				"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"]
@@ -13435,8 +13479,14 @@ const operationManifest = [
 						"email"
 					]
 				},
-				"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"]
@@ -13576,7 +13626,163 @@ const operationManifest = [
 					"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": [{
+						"type": "object",
+						"properties": {
+							"keys": {
+								"type": "array",
+								"items": {
+									"type": "object",
+									"properties": {
+										"owner": { "anyOf": [{
+											"type": "object",
+											"properties": {
+												"kind": {
+													"type": "string",
+													"const": "member"
+												},
+												"user_id": {
+													"type": "string",
+													"description": "The member's user id.",
+													"format": "uuid"
+												},
+												"name": {
+													"description": "Their name; null when they have none set.",
+													"type": ["string", "null"]
+												}
+											},
+											"required": [
+												"kind",
+												"user_id",
+												"name"
+											]
+										}, {
+											"type": "object",
+											"properties": { "kind": {
+												"type": "string",
+												"const": "organization",
+												"description": "Held by no member: an organization key, or one whose holder has left."
+											} },
+											"required": ["kind"]
+										}] },
+										"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
+										}
+									},
+									"required": ["owner", "count"]
+								},
+								"description": "API keys that work now (not revoked, expired or suspended) and hold mail:read, whose access lists the rule or its live share. Owner: who holds each, or the organization."
+							},
+							"webhooks": {
+								"type": "array",
+								"items": {
+									"type": "object",
+									"properties": {
+										"owner": { "anyOf": [{
+											"type": "object",
+											"properties": {
+												"kind": {
+													"type": "string",
+													"const": "member"
+												},
+												"user_id": {
+													"type": "string",
+													"description": "The member's user id.",
+													"format": "uuid"
+												},
+												"name": {
+													"description": "Their name; null when they have none set.",
+													"type": ["string", "null"]
+												}
+											},
+											"required": [
+												"kind",
+												"user_id",
+												"name"
+											]
+										}, {
+											"type": "object",
+											"properties": { "kind": {
+												"type": "string",
+												"const": "organization",
+												"description": "Held by no member: an organization key, or one whose holder has left."
+											} },
+											"required": ["kind"]
+										}] },
+										"count": {
+											"type": "integer",
+											"exclusiveMinimum": 0
+										},
+										"hosts": {
+											"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" }
+										},
+										"hosts_not_listed": {
+											"description": "Hosts past those listed.",
+											"type": "integer",
+											"minimum": 0
+										}
+									},
+									"required": ["owner", "count"]
+								},
+								"description": "Webhooks taking received mail, bounces or reports that are sent what it matches: those of the key delivery acts as, when it lists the rule or its live share (owner: its holder, or the organization), and those of the member it is shared with (owner: that member)."
+							},
+							"shares": {
+								"type": "array",
+								"items": {
+									"type": "object",
+									"properties": {
+										"beneficiary": {
+											"type": "object",
+											"properties": {
+												"kind": {
+													"type": "string",
+													"const": "member"
+												},
+												"user_id": {
+													"type": "string",
+													"description": "The member's user id.",
+													"format": "uuid"
+												},
+												"name": {
+													"description": "Their name; null when they have none set.",
+													"type": ["string", "null"]
+												}
+											},
+											"required": [
+												"kind",
+												"user_id",
+												"name"
+											]
+										},
+										"count": {
+											"type": "integer",
+											"exclusiveMinimum": 0
+										}
+									},
+									"required": ["beneficiary", "count"]
+								},
+								"description": "The rule's live share (at most one), by its member, if they can read it and it is among their newest 20 shares."
+							}
+						},
+						"required": [
+							"keys",
+							"webhooks",
+							"shares"
+						],
+						"description": "Who receives what the rule shares, by person and count. As receivers, empty unless it is an active grant rule."
+					}, { "type": "null" }]
+				},
+				"receivers_once_active": {
+					"description": "As on the list; also null when covers_now is false.",
 					"anyOf": [{
 						"type": "object",
 						"properties": {
@@ -13619,6 +13825,11 @@ const operationManifest = [
 										"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
 										}
 									},
 									"required": ["owner", "count"]
@@ -13666,7 +13877,7 @@ const operationManifest = [
 											"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" }
 										},
@@ -13723,7 +13934,7 @@ const operationManifest = [
 							"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."
 					}, { "type": "null" }]
 				},
 				"created_at": {
@@ -13819,6 +14030,7 @@ const operationManifest = [
 				"covers",
 				"current_version",
 				"receivers",
+				"receivers_once_active",
 				"created_at",
 				"covers_now",
 				"current"
@@ -13920,8 +14132,14 @@ const operationManifest = [
 						"email"
 					]
 				},
-				"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"]
@@ -14087,7 +14305,7 @@ const operationManifest = [
 		"binaryResponse": false,
 		"bodyRequired": false,
 		"command": "list-email-rule-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.",
+		"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.",
 		"hasJsonBody": false,
 		"method": "GET",
 		"operationId": "listEmailRuleObjections",
@@ -14095,9 +14313,10 @@ const operationManifest = [
 		"pathParams": [],
 		"queryParams": [
 			{
-				"default": "outgoing",
-				"description": "outgoing (the default): objections you made. incoming: objections to rules you wrote. all: every objection you can see.",
+				"default": "mine",
+				"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.",
 				"enum": [
+					"mine",
 					"outgoing",
 					"incoming",
 					"all"
@@ -14212,8 +14431,14 @@ const operationManifest = [
 							"email"
 						]
 					},
-					"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"]
@@ -14253,6 +14478,126 @@ const operationManifest = [
 		"tag": "Email Rule Oversight",
 		"tagCommand": "email-rule-oversight"
 	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": false,
+		"command": "list-email-rule-versions-covering-me",
+		"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.",
+		"hasJsonBody": false,
+		"method": "GET",
+		"operationId": "listEmailRuleVersionsCoveringMe",
+		"path": "/email-rules/covering-me/{id}/versions",
+		"pathParams": [{
+			"description": "The rule id.",
+			"enum": null,
+			"name": "id",
+			"required": true,
+			"type": "string"
+		}],
+		"queryParams": [
+			{
+				"description": "Versions per page when versions is not given: 1 to 100, default 50.",
+				"enum": null,
+				"maximum": 100,
+				"minimum": 1,
+				"name": "limit",
+				"required": false,
+				"type": "integer"
+			},
+			{
+				"description": "meta.cursor from the preceding page. Omit for the first page. Not with versions.",
+				"enum": null,
+				"name": "cursor",
+				"required": false,
+				"type": "string"
+			},
+			{
+				"description": "Read only these version numbers, comma-separated, at most 100. Not with limit or cursor.",
+				"enum": null,
+				"name": "versions",
+				"required": false,
+				"type": "string"
+			}
+		],
+		"headerParams": [],
+		"permissions": ["mail:read"],
+		"access": null,
+		"requestSchema": null,
+		"responseSchema": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"properties": {
+					"version": {
+						"type": "integer",
+						"exclusiveMinimum": 0
+					},
+					"english": {
+						"type": "string",
+						"description": "What its author asked for, in their words."
+					},
+					"tree": {
+						"type": "object",
+						"properties": {
+							"version": {
+								"type": "number",
+								"const": 1
+							},
+							"vocabulary": {
+								"type": "string",
+								"description": "Vocabulary version, such as v1."
+							},
+							"when": {
+								"type": "object",
+								"propertyNames": { "type": "string" },
+								"additionalProperties": {},
+								"description": "A condition {column, op, value?, min_confidence?} (see GET /email-rules/vocabulary) or {all: [...]}, {any: [...]}, {not: ...}."
+							},
+							"questions": {
+								"type": "array",
+								"items": { "type": "string" },
+								"description": "Yes/no questions asked once the conditions match, over the email's text and attachment names, never attachment contents. A grant rule needs every one yes; a do_not_share rule matches on any yes."
+							}
+						},
+						"required": [
+							"version",
+							"vocabulary",
+							"when",
+							"questions"
+						]
+					},
+					"explanation": {
+						"type": "string",
+						"description": "What the rule matches, as compiled."
+					},
+					"assumptions": {
+						"type": "array",
+						"items": { "type": "string" }
+					},
+					"compiled_by": { "type": "string" },
+					"vocabulary": { "type": "string" },
+					"created_at": {
+						"type": "string",
+						"format": "date-time"
+					}
+				},
+				"required": [
+					"version",
+					"english",
+					"tree",
+					"explanation",
+					"assumptions",
+					"compiled_by",
+					"vocabulary",
+					"created_at"
+				]
+			}
+		},
+		"sdkName": "listEmailRuleVersionsCoveringMe",
+		"summary": "Read versions of a rule over your mail",
+		"tag": "Email Rule Oversight",
+		"tagCommand": "email-rule-oversight"
+	},
 	{
 		"binaryResponse": false,
 		"bodyRequired": false,
@@ -14358,7 +14703,7 @@ const operationManifest = [
 						"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": [{
 							"type": "object",
 							"properties": {
@@ -14401,6 +14746,167 @@ const operationManifest = [
 											"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
+											}
+										},
+										"required": ["owner", "count"]
+									},
+									"description": "API keys that work now (not revoked, expired or suspended) and hold mail:read, whose access lists the rule or its live share. Owner: who holds each, or the organization."
+								},
+								"webhooks": {
+									"type": "array",
+									"items": {
+										"type": "object",
+										"properties": {
+											"owner": { "anyOf": [{
+												"type": "object",
+												"properties": {
+													"kind": {
+														"type": "string",
+														"const": "member"
+													},
+													"user_id": {
+														"type": "string",
+														"description": "The member's user id.",
+														"format": "uuid"
+													},
+													"name": {
+														"description": "Their name; null when they have none set.",
+														"type": ["string", "null"]
+													}
+												},
+												"required": [
+													"kind",
+													"user_id",
+													"name"
+												]
+											}, {
+												"type": "object",
+												"properties": { "kind": {
+													"type": "string",
+													"const": "organization",
+													"description": "Held by no member: an organization key, or one whose holder has left."
+												} },
+												"required": ["kind"]
+											}] },
+											"count": {
+												"type": "integer",
+												"exclusiveMinimum": 0
+											},
+											"hosts": {
+												"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" }
+											},
+											"hosts_not_listed": {
+												"description": "Hosts past those listed.",
+												"type": "integer",
+												"minimum": 0
+											}
+										},
+										"required": ["owner", "count"]
+									},
+									"description": "Webhooks taking received mail, bounces or reports that are sent what it matches: those of the key delivery acts as, when it lists the rule or its live share (owner: its holder, or the organization), and those of the member it is shared with (owner: that member)."
+								},
+								"shares": {
+									"type": "array",
+									"items": {
+										"type": "object",
+										"properties": {
+											"beneficiary": {
+												"type": "object",
+												"properties": {
+													"kind": {
+														"type": "string",
+														"const": "member"
+													},
+													"user_id": {
+														"type": "string",
+														"description": "The member's user id.",
+														"format": "uuid"
+													},
+													"name": {
+														"description": "Their name; null when they have none set.",
+														"type": ["string", "null"]
+													}
+												},
+												"required": [
+													"kind",
+													"user_id",
+													"name"
+												]
+											},
+											"count": {
+												"type": "integer",
+												"exclusiveMinimum": 0
+											}
+										},
+										"required": ["beneficiary", "count"]
+									},
+									"description": "The rule's live share (at most one), by its member, if they can read it and it is among their newest 20 shares."
+								}
+							},
+							"required": [
+								"keys",
+								"webhooks",
+								"shares"
+							],
+							"description": "Who receives what the rule shares, by person and count. As receivers, empty unless it is an active grant rule."
+						}, { "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": [{
+							"type": "object",
+							"properties": {
+								"keys": {
+									"type": "array",
+									"items": {
+										"type": "object",
+										"properties": {
+											"owner": { "anyOf": [{
+												"type": "object",
+												"properties": {
+													"kind": {
+														"type": "string",
+														"const": "member"
+													},
+													"user_id": {
+														"type": "string",
+														"description": "The member's user id.",
+														"format": "uuid"
+													},
+													"name": {
+														"description": "Their name; null when they have none set.",
+														"type": ["string", "null"]
+													}
+												},
+												"required": [
+													"kind",
+													"user_id",
+													"name"
+												]
+											}, {
+												"type": "object",
+												"properties": { "kind": {
+													"type": "string",
+													"const": "organization",
+													"description": "Held by no member: an organization key, or one whose holder has left."
+												} },
+												"required": ["kind"]
+											}] },
+											"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
 											}
 										},
 										"required": ["owner", "count"]
@@ -14448,7 +14954,7 @@ const operationManifest = [
 												"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" }
 											},
@@ -14505,7 +15011,7 @@ const operationManifest = [
 								"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."
 						}, { "type": "null" }]
 					},
 					"created_at": {
@@ -14523,6 +15029,7 @@ const operationManifest = [
 					"covers",
 					"current_version",
 					"receivers",
+					"receivers_once_active",
 					"created_at"
 				]
 			}
@@ -14629,8 +15136,14 @@ const operationManifest = [
 						"email"
 					]
 				},
-				"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"]
@@ -14757,7 +15270,7 @@ const operationManifest = [
 					}
 				},
 				"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": {
@@ -14780,7 +15293,7 @@ const operationManifest = [
 							"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",
@@ -14799,7 +15312,7 @@ const operationManifest = [
 							"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",
@@ -14896,6 +15409,16 @@ const operationManifest = [
 											"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": {
@@ -15206,6 +15729,15 @@ const operationManifest = [
 							"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"
@@ -15473,7 +16005,7 @@ const operationManifest = [
 					]
 				},
 				"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"
 				}
 			},
@@ -15574,7 +16106,7 @@ const operationManifest = [
 		"binaryResponse": false,
 		"bodyRequired": true,
 		"command": "compile-email-rule",
-		"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).",
 		"hasJsonBody": true,
 		"method": "POST",
 		"operationId": "compileEmailRule",
@@ -15607,6 +16139,42 @@ const operationManifest = [
 				"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": {
+					"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."
 				}
 			},
 			"required": ["english"],
@@ -15669,14 +16237,14 @@ const operationManifest = [
 					"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": [{
 						"type": "object",
 						"properties": {
 							"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",
@@ -15695,7 +16263,7 @@ const operationManifest = [
 							"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",
@@ -15919,6 +16487,16 @@ const operationManifest = [
 											"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": {
@@ -15997,7 +16575,7 @@ const operationManifest = [
 					}
 				},
 				"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": {
@@ -16020,7 +16598,7 @@ const operationManifest = [
 							"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",
@@ -16039,7 +16617,7 @@ const operationManifest = [
 							"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",
@@ -16148,6 +16726,15 @@ const operationManifest = [
 					"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"
@@ -16274,6 +16861,27 @@ const operationManifest = [
 						]
 					}
 				},
+				"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",
@@ -16351,6 +16959,16 @@ const operationManifest = [
 											"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": {
@@ -16476,6 +17094,10 @@ const operationManifest = [
 				"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": [
@@ -16595,7 +17217,7 @@ const operationManifest = [
 					}
 				},
 				"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": {
@@ -16618,7 +17240,7 @@ const operationManifest = [
 							"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",
@@ -16637,7 +17259,7 @@ const operationManifest = [
 							"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",
@@ -17097,7 +17719,7 @@ const operationManifest = [
 		"binaryResponse": false,
 		"bodyRequired": false,
 		"command": "delete-email-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).",
 		"hasJsonBody": false,
 		"method": "DELETE",
 		"operationId": "deleteEmailRule",
@@ -17149,6 +17771,10 @@ const operationManifest = [
 				"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"]
@@ -17321,7 +17947,7 @@ const operationManifest = [
 					"description": "For a selected rule: inboxes, and domains (each address at them the author reads); each one you can read."
 				},
 				"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"
 				},
@@ -17447,6 +18073,10 @@ const operationManifest = [
 										"type": "array",
 										"items": { "type": "string" }
 									},
+									"attachment_names": {
+										"type": "array",
+										"items": { "type": "string" }
+									},
 									"automated": { "type": "boolean" },
 									"from_mailing_list": { "type": "boolean" }
 								},
@@ -17457,6 +18087,7 @@ const operationManifest = [
 									"subject",
 									"text",
 									"attachment_types",
+									"attachment_names",
 									"automated",
 									"from_mailing_list"
 								],
@@ -17671,6 +18302,15 @@ const operationManifest = [
 					"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"
@@ -17865,6 +18505,16 @@ const operationManifest = [
 											"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": {
@@ -19329,6 +19979,11 @@ const operationManifest = [
 													"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
 													}
 												},
 												"required": ["owner", "count"]
@@ -19376,7 +20031,7 @@ const operationManifest = [
 														"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" }
 													},
@@ -19433,7 +20088,7 @@ const operationManifest = [
 										"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."
 								}, { "type": "null" }]
 							}
 						},
@@ -20420,6 +21075,15 @@ const operationManifest = [
 						"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"
@@ -20867,6 +21531,16 @@ const operationManifest = [
 													"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": {
@@ -21177,6 +21851,11 @@ const operationManifest = [
 							"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": {
@@ -21244,7 +21923,7 @@ const operationManifest = [
 						"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": [
@@ -21447,7 +22126,7 @@ const operationManifest = [
 		"binaryResponse": false,
 		"bodyRequired": true,
 		"command": "test-email-rule-on-sample",
-		"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).",
 		"hasJsonBody": true,
 		"method": "POST",
 		"operationId": "testEmailRuleOnSample",
@@ -21533,7 +22212,7 @@ const operationManifest = [
 					"description": "For a selected rule: inboxes, and domains (each address at them the author reads); each one you can read."
 				},
 				"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"
 				},
@@ -21604,6 +22283,17 @@ const operationManifest = [
 								"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"
@@ -21890,7 +22580,7 @@ const operationManifest = [
 					}
 				},
 				"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": {
@@ -21913,7 +22603,7 @@ const operationManifest = [
 							"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",
@@ -21932,7 +22622,7 @@ const operationManifest = [
 							"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",
@@ -22091,6 +22781,16 @@ const operationManifest = [
 											"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": {
@@ -22198,6 +22898,16 @@ const operationManifest = [
 											"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": {
@@ -22332,6 +23042,15 @@ const operationManifest = [
 					"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"
@@ -22458,6 +23177,27 @@ const operationManifest = [
 						]
 					}
 				},
+				"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",
@@ -22535,6 +23275,16 @@ const operationManifest = [
 											"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": {
@@ -22660,6 +23410,10 @@ const operationManifest = [
 				"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": [
@@ -24272,6 +25026,29 @@ const operationManifest = [
 						}
 					}
 				},
+				"attachments": {
+					"type": "array",
+					"items": {
+						"type": "object",
+						"description": "Metadata for one attachment. The bytes are not inline; download\nall attachments for a message as a gzipped tarball via\n`/emails/{id}/attachments.tar.gz`. `sha256` lets you verify a\nspecific part after extraction.\n",
+						"properties": {
+							"filename": { "type": ["string", "null"] },
+							"content_type": { "type": ["string", "null"] },
+							"size_bytes": { "type": "integer" },
+							"sha256": { "type": ["string", "null"] },
+							"part_index": {
+								"type": "integer",
+								"description": "Zero-based index of this part within the message."
+							},
+							"tar_path": {
+								"type": "string",
+								"description": "This part's file name inside the message's attachments archive. Absent on attachments stored before it was recorded."
+							}
+						},
+						"required": ["size_bytes"]
+					},
+					"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.",
@@ -24330,6 +25107,7 @@ const operationManifest = [
 				"from_verified",
 				"from_header_email",
 				"from_name",
+				"attachments",
 				"imported",
 				"snippet"
 			]
@@ -24590,6 +25368,94 @@ const operationManifest = [
 		"tag": "Emails",
 		"tagCommand": "emails"
 	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": true,
+		"command": "import-google-mail-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.",
+		"hasJsonBody": true,
+		"method": "POST",
+		"operationId": "importGoogleMailMessage",
+		"path": "/mail-imports/google/messages",
+		"pathParams": [],
+		"queryParams": [],
+		"headerParams": [{
+			"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.",
+			"enum": null,
+			"name": "X-Primitive-Google-Access-Token",
+			"required": true,
+			"type": "string"
+		}, {
+			"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.",
+			"enum": null,
+			"name": "Idempotency-Key",
+			"required": false,
+			"type": "string"
+		}],
+		"permissions": ["mail:read"],
+		"access": null,
+		"requestSchema": {
+			"type": "object",
+			"properties": { "message_id": {
+				"type": "string",
+				"pattern": "^[A-Za-z0-9_-]{1,128}$"
+			} },
+			"required": ["message_id"],
+			"additionalProperties": false
+		},
+		"responseSchema": { "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"]
+			}
+		] },
+		"sdkName": "importGoogleMailMessage",
+		"summary": "Import one historical Google Workspace message",
+		"tag": "Emails",
+		"tagCommand": "emails"
+	},
 	{
 		"binaryResponse": false,
 		"bodyRequired": false,
@@ -25306,6 +26172,50 @@ const operationManifest = [
 		"tag": "Emails",
 		"tagCommand": "emails"
 	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": true,
+		"command": "reconcile-google-mail-import",
+		"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.",
+		"hasJsonBody": true,
+		"method": "POST",
+		"operationId": "reconcileGoogleMailImport",
+		"path": "/mail-imports/google/reconcile",
+		"pathParams": [],
+		"queryParams": [],
+		"headerParams": [{
+			"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.",
+			"enum": null,
+			"name": "Idempotency-Key",
+			"required": false,
+			"type": "string"
+		}],
+		"permissions": ["mail:read"],
+		"access": null,
+		"requestSchema": {
+			"type": "object",
+			"properties": {},
+			"additionalProperties": false
+		},
+		"responseSchema": {
+			"type": "object",
+			"properties": {
+				"cleaned": {
+					"type": "integer",
+					"minimum": 0
+				},
+				"unresolved": {
+					"type": "integer",
+					"minimum": 0
+				}
+			},
+			"required": ["cleaned", "unresolved"]
+		},
+		"sdkName": "reconcileGoogleMailImport",
+		"summary": "Reconcile scoped historical import attempts",
+		"tag": "Emails",
+		"tagCommand": "emails"
+	},
 	{
 		"binaryResponse": false,
 		"bodyRequired": false,
@@ -45776,6 +46686,33 @@ const operationManifest = [
 					"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,
@@ -46937,6 +47874,33 @@ const operationManifest = [
 						}
 					}
 				},
+				"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,
@@ -47417,6 +48381,33 @@ const operationManifest = [
 								}
 							}
 						},
+						"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,
@@ -52064,6 +53055,7 @@ const SAMPLE_EMAIL_KEYS = /* @__PURE__ */ new Set([
 	"subject",
 	"text",
 	"attachment_types",
+	"attachment_names",
 	"automated",
 	"from_mailing_list",
 	"spam_score"
@@ -52091,6 +53083,10 @@ function checkSampleEmail(email, at) {
 	list("to", 1);
 	list("cc", 0);
 	list("attachment_types", 0);
+	list("attachment_names", 0);
+	const types = email.attachment_types;
+	const names = email.attachment_names;
+	if (Array.isArray(types) && Array.isArray(names) && types.length > 0 && names.length > 0 && types.length !== names.length) fail("attachment_names pairs with attachment_types by position, so give the same number of each");
 	if (email.subject !== void 0 && (typeof email.subject !== "string" || email.subject.length > SAMPLE_SUBJECT_MAX)) fail(`subject must be a string of at most ${SAMPLE_SUBJECT_MAX} characters`);
 	if (typeof email.text !== "string" || email.text.length === 0 || email.text.length > SAMPLE_TEXT_MAX) fail(`text must be 1 to ${SAMPLE_TEXT_MAX} characters`);
 	for (const key of ["automated", "from_mailing_list"]) if (email[key] !== void 0 && typeof email[key] !== "boolean") fail(`${key} must be true or false`);
@@ -52647,7 +53643,9 @@ function answerText(answer) {
 function conditionLines(summary) {
 	const conditions = Array.isArray(summary?.conditions) ? summary.conditions : [];
 	if (conditions.length === 0) return [];
-	return [`Conditions (${summary?.decided ?? 0} decided):`, ...conditions.map((condition) => `  ${condition.index}. ${condition.text}: held on ${condition.held}, failed on ${condition.failed} (the only failure on ${condition.only_failure})`)];
+	const held = summary?.conditions_held;
+	const together = typeof held === "number" ? `; together they held on ${held}` : "";
+	return [`Conditions (${summary?.decided ?? 0} decided${together}):`, ...conditions.map((condition) => `  ${condition.index}. ${condition.text}: held on ${condition.held}, failed on ${condition.failed} (the only failure on ${condition.only_failure})`)];
 }
 function questionLines(summary, results) {
 	const questions = Array.isArray(summary?.questions) ? summary.questions : [];
@@ -52991,6 +53989,10 @@ function authorLine(author) {
 	if (name || email) return `Author: ${name ?? email}`;
 	return `Author: user ${author.user_id} (name and email not shown to you)`;
 }
+/** A note the server wrote on a rule answer, as a line, or undefined. */
+function noteLine(note) {
+	return typeof note === "string" && note.trim() ? note.trim() : void 0;
+}
 /** The stderr report of a rule written by create-email-rule or update-email-rule. */
 function writtenEmailRuleReport(data, request) {
 	if (!isRecord(data)) return { lines: [] };
@@ -53005,11 +54007,17 @@ function writtenEmailRuleReport(data, request) {
 	if (restored) lines.push(restored);
 	const reach = affectsLine(rule.affects);
 	if (reach) lines.push(reach);
+	for (const note of [rule.share_notice, rule.notice]) {
+		const line = noteLine(note);
+		if (line) lines.push(line);
+	}
 	const sentExpectations = sentExpectationsIn(request.body);
 	const name = writtenSampleNamer(request.body, request.flags, rule.expectation_samples);
 	const checked = expectationsCheckLine(rule.expectations_check, ruleId, name);
 	if (checked) lines.push(checked);
 	else if (sentExpectations) lines.push(`Expectations were not checked on this write. Test them with \`primitive email-rules test-email-rule --rule-id ${ruleId}\`.`);
+	const objections = noteLine(rule.objection_notice);
+	if (objections) lines.push(objections);
 	if (request.flags?.["fail-on-expectations"] !== true) return { lines };
 	return {
 		lines,
@@ -53060,7 +54068,9 @@ function deleteEmailRuleReport(data, request) {
 	const answer = data;
 	const lines = [];
 	const ended = Array.isArray(answer.ended_shares) ? answer.ended_shares.length : 0;
-	if (ended > 0) lines.push(`Ended ${ended === 1 ? "1 share" : `${ended} shares`} of this rule (end_reason rule_deleted). ${ended === 1 ? "It keeps its record" : "Each keeps its record"}.`);
+	const shareNotice = noteLine(answer.share_notice);
+	if (shareNotice) lines.push(shareNotice);
+	else if (ended > 0) lines.push(`Ended ${ended === 1 ? "1 share" : `${ended} shares`} of this rule (end_reason rule_deleted). ${ended === 1 ? "It keeps its record" : "Each keeps its record"}.`);
 	const keys = Array.isArray(answer.keys) ? answer.keys : [];
 	const others = typeof answer.other_keys === "number" && answer.other_keys > 0 ? answer.other_keys : 0;
 	const ruleId = typeof request.path.id === "string" ? request.path.id : "<rule-id>";
@@ -53097,16 +54107,37 @@ function readAgain(id) {
 	return `Read it again with \`primitive email-rules get-email-rule ${id}\` and send the write again`;
 }
 /**
+* Who reads an active rule, from a refusal's details.read_by: the server
+* sends it when it checked the write against the rule's expectations because
+* API keys or webhooks read the rule, whether or not the write asked.
+* Undefined without it.
+*/
+function readByText(details) {
+	const readBy = details.read_by;
+	if (!isRecord(readBy)) return void 0;
+	const { keys, webhooks } = readBy;
+	return typeof keys === "number" && typeof webhooks === "number" ? `${plural$1(keys, "API key", "API keys")} and ${plural$1(webhooks, "webhook", "webhooks")} read what it grants` : "API keys or webhooks may read what it grants (they could not be counted in time)";
+}
+/** How to save a write the default check refused, without the check. */
+function saveUncheckedText(flags) {
+	return flags?.["fail-on-expectations"] === true ? `send it again without --${FAIL_ON_EXPECTATIONS_FLAG} and with --no-if-expectations-pass` : "send it again with --no-if-expectations-pass";
+}
+/**
 * The hint for update-email-rule's refusals: an email_rule_conflict by its
 * details.reason (version_moved, revision_moved, expectations_moved,
-* rule_changed), and the expectations guard's expectations_failed,
-* expectations_undecided, expectations_unreadable and no_expectations.
-* Nothing was saved in any of them.
+* rule_changed, readers_changed), and the expectations guard's
+* expectations_failed, expectations_undecided, expectations_unreadable and
+* no_expectations. The guard runs when the write sends if_expectations_pass,
+* and by default (details.read_by) when it changes what an active rule that
+* API keys or webhooks read grants. Nothing was saved in any of them.
 */
 function updateEmailRuleErrorHint(code, payload, ruleId, body, flags) {
 	const id = typeof ruleId === "string" && ruleId ? ruleId : "<rule-id>";
 	const details = errorDetails(payload);
 	const guarded = isRecord(body) && body.if_expectations_pass === true;
+	const readBy = readByText(details);
+	const judged = readBy ? "was judged against its expectations before saving, as a write that changes what an active rule grants is by default while API keys or webhooks read it, and nothing was saved" : "was judged against its expectations before saving (if_expectations_pass), and nothing was saved";
+	const unchecked = readBy ? ` The rule is active and ${readBy}; to save the write without the check, ${saveUncheckedText(flags)}.` : "";
 	if (code === "email_rule_conflict") switch (details.reason) {
 		case "version_moved": return versionMovedHint(payload, ruleId);
 		case "revision_moved": {
@@ -53115,6 +54146,7 @@ function updateEmailRuleErrorHint(code, payload, ruleId, body, flags) {
 		}
 		case "expectations_moved": return `Hint: the rule's saved expectations changed while this write was checked against them, so nothing was saved. ${readAgain(id)}.`;
 		case "rule_changed": return guarded ? `Hint: the rule changed after this write was judged against its expectations and before it was saved, so saving it would have gone unchecked; nothing was saved. ${readAgain(id)}.` : `Hint: the rule changed while this write was being saved, so nothing was saved. ${readAgain(id)}.`;
+		case "readers_changed": return "Hint: API keys or webhooks started reading this rule while this write was being saved, and saving it would have changed what they receive without checking it against the rule's expectations, so nothing was saved. Send the write again: it is then checked first.";
 		default: return;
 	}
 	if (code === "expectations_failed" || code === "expectations_undecided") {
@@ -53131,16 +54163,16 @@ function updateEmailRuleErrorHint(code, payload, ruleId, body, flags) {
 		const reason = String(details.reason);
 		const samplesMayStay = undecidedSamplesMayStay(undecidedSamples.length, reason);
 		const byReason = reason !== "none" && Object.hasOwn(UNDECIDED_NEXT_STEP, reason) ? UNDECIDED_NEXT_STEP[reason] : UNDECIDED_NEXT_STEP.none;
-		return `Hint: the rule, as this write would leave it, was judged against its expectations before saving (if_expectations_pass), and nothing was saved.${which}${code === "expectations_failed" ? "" : samplesMayStay ? `${undecided.length > 0 ? ` ${byReason}` : ""} ${UNDECIDED_SAMPLES_NEXT_STEP} ${refusedSampleTest(body, id)}` : ` ${byReason}`} The command exits ${updateEmailRuleErrorExitCode(payload) ?? 1}.`;
+		return `Hint: the rule, as this write would leave it, ${judged}.${which}${code === "expectations_failed" ? "" : samplesMayStay ? `${undecided.length > 0 ? ` ${byReason}` : ""} ${UNDECIDED_SAMPLES_NEXT_STEP} ${refusedSampleTest(body, id)}` : ` ${byReason}`}${unchecked} The command exits ${updateEmailRuleErrorExitCode(payload) ?? 1}.`;
 	}
 	if (code === "expectations_unreadable") {
 		const unreadable = Array.isArray(details.unreadable) ? details.unreadable.filter((entry) => entry !== null && entry !== void 0 && entry !== "").map(String) : [];
 		const one = unreadable.length === 1;
 		const named = unreadable.length > 0 ? `: ${unreadable.join(", ")}` : "";
 		const them = one ? "it" : "them";
-		return `Hint: the rule, as this write would leave it, was judged against its expectations before saving (if_expectations_pass), and nothing was saved. ${one ? "An expectation names an email" : "Expectations name emails"} this rule cannot read (deleted, or outside its scope or its author's mail)${named}. Sending the write again will not decide ${them}: send --expectations-file without ${them}, or an evaluation_scope that reads ${them}. The command exits 1.`;
+		return `Hint: the rule, as this write would leave it, ${judged}. ${one ? "An expectation names an email" : "Expectations name emails"} this rule cannot read (deleted, or outside its scope or its author's mail)${named}. Sending the write again will not decide ${them}: send --expectations-file without ${them}, or an evaluation_scope that reads ${them}.${unchecked} The command exits 1.`;
 	}
-	if (code === "no_expectations") return "Hint: nothing was saved. Give the rule expectations with --expectations-file or made-up emails with --expectation-samples-file or --add-expectation-samples-file (in this write or before it), or send the write without if_expectations_pass (--fail-on-expectations or --if-expectations-pass).";
+	if (code === "no_expectations") return readBy ? `Hint: nothing was saved: this write removes the rule's expectations, and the rule is active and ${readBy}, so a write that changes what it grants is checked against them first. Keep some with --expectations-file, --expectation-samples-file or --add-expectation-samples-file, or, to save the write without the check, ${saveUncheckedText(flags)}.` : "Hint: nothing was saved. Give the rule expectations with --expectations-file or made-up emails with --expectation-samples-file or --add-expectation-samples-file (in this write or before it), or send the write without if_expectations_pass (--fail-on-expectations or --if-expectations-pass).";
 }
 /** The reasons a guard's undecided judgment can be decided by sending the write again. */
 const RETRYABLE_REASONS = /* @__PURE__ */ new Set([
@@ -53197,12 +54229,20 @@ function updateEmailRuleErrorExitCode(payload) {
 function undecidedSamplesMayStay(count, reason) {
 	return count > 0 && !RETRYABLE_REASONS.has(reason) && reason !== "author_unresolvable";
 }
+/** Where compile counted breadth, by the evaluation_scope it was sent. */
+const BREADTH_SCOPE = {
+	own_mailboxes: "in your own mailboxes",
+	author: "in all the mail you can read",
+	selected: "in the inboxes and domains the selected scope names"
+};
 /** The stderr report of compile-email-rule: how many recent emails it holds for. */
-function compileEmailRuleReport(data) {
+function compileEmailRuleReport(data, request) {
 	if (!isRecord(data)) return { lines: [] };
 	const lines = (Array.isArray(data.warnings) ? data.warnings : []).filter((warning) => typeof warning === "string" && warning.trim() !== "").map((warning) => `Warning: ${warning.trim()}`);
 	const breadth = data.breadth;
-	if (isRecord(breadth) && typeof breadth.checked === "number" && typeof breadth.matched === "number") lines.push(`Breadth: its conditions hold for ${breadth.matched} of ${plural$1(breadth.checked, "recent email", "recent emails")} checked in your own mailboxes, whatever scope you save it with.`);
+	const sent = isRecord(request?.body) && typeof request.body.evaluation_scope === "string" ? request.body.evaluation_scope : void 0;
+	const where = sent === void 0 ? "in your own mailboxes, the default; pass --evaluation-scope to count over the scope you will save it with" : BREADTH_SCOPE[sent] ?? `in evaluation_scope ${sent}`;
+	if (isRecord(breadth) && typeof breadth.checked === "number" && typeof breadth.matched === "number") lines.push(`Breadth: its conditions hold for ${breadth.matched} of ${plural$1(breadth.checked, "recent email", "recent emails")} checked ${where}.`);
 	return { lines };
 }
 /** The stderr report of get-email-rule: who wrote it, and its revision. */
@@ -53214,6 +54254,8 @@ function getEmailRuleReport(data) {
 	const protection = protectionLine(data);
 	if (protection) lines.push(protection);
 	if (typeof data.revision === "number") lines.push(`Revision ${data.revision}: pass --if-revision ${data.revision} to update-email-rule so a change made since is never replaced unseen.`);
+	const objections = noteLine(data.objection_notice);
+	if (objections) lines.push(objections);
 	return { lines };
 }
 /** The stderr report of list-email-rules: the protective rules that protect nothing yet, or less than they seem. */
@@ -53233,9 +54275,11 @@ function listEmailRulesReport(data) {
 /** create-email-rule's --fail-on-expectations: the exit code follows the check made after saving. */
 const FAIL_ON_EXPECTATIONS_HELP = "Exit 1 when an expectation in the answer's expectations_check failed, and 3 when none failed but one is undecided or the expectations this write sent were not checked (test the rule to decide). A create does not judge made-up emails, so with some it exits 3. Without it the command exits 0 whatever the check says.";
 /** update-email-rule's --fail-on-expectations: the server refuses the write. */
-const UPDATE_FAIL_ON_EXPECTATIONS_HELP = "Refuse the write unless the rule, as this write would leave it, passes its expectations. It sends if_expectations_pass (over any in --body-file or --raw-body), so the server judges a new version, a restored one, a new scope or turning the rule active before saving, on its emails by id and its made-up emails, and saves nothing when one failed (exit 1), one names an email the rule cannot read (exit 1, since sending again never decides it), one is undecided (exit 3, or 1 when the rule cannot run as its author or a made-up email is undecided for no reason the answer gives) or the rule has none (exit 1). It can take as long as a test of the rule; the command waits for it. Judging needs a credential that reads the mail's content. A write the server does not judge (one changing only expectations, say) is saved, and the exit code then follows the answer's expectations_check, as on create. With --json, a refused write's document holds the API's error alone; a saved write's holds the rule.";
+const UPDATE_FAIL_ON_EXPECTATIONS_HELP = "Refuse the write unless the rule, as this write would leave it, passes its expectations. It sends if_expectations_pass (over any in --body-file or --raw-body), so the server judges a new version, a restored one, a new scope or turning the rule active before saving, on its emails by id and its made-up emails, and saves nothing when one failed (exit 1), one names an email the rule cannot read (exit 1, since sending again never decides it), one is undecided (exit 3, or 1 when the rule cannot run as its author or a made-up email is undecided for no reason the answer gives) or the rule has none (exit 1). It can take as long as a test of the rule; the command waits for it. Judging needs a credential that reads the mail's content. A write the server does not judge (one changing only expectations, say) is saved, and the exit code then follows the answer's expectations_check, as on create. Without it, the server still judges, and refuses the same way, a write that saves a version or changes the scope of an active rule that API keys or webhooks read and that has expectations (the refusal's details.read_by counts them), unless --no-if-expectations-pass is sent. With --json, a refused write's document holds the API's error alone; a saved write's holds the rule.";
+/** When update-email-rule judges the made-up emails a samples flag sets. */
+const UPDATE_JUDGES_SAMPLES = `The write judges them before saving with --${FAIL_ON_EXPECTATIONS_FLAG}, when it saves a version or turns the rule active, and without it when it saves a version or changes the scope of an active rule that API keys or webhooks read, unless --no-if-expectations-pass is sent.`;
 /** What a samples file flag reads. */
-const SAMPLES_FILE_SHAPE = "A JSON file of made-up emails the rule must match or not: an array such as [{\"expected\": \"no_match\", \"label\": \"a personal bill\", \"email\": {...}}], with email as test-email-rule-on-sample takes it (text up to 4,000 characters, at most 10 each of to, cc and attachment_types), like the one generate-look-alikes --samples-file writes, or a generate-look-alikes answer saved as it printed it.";
+const SAMPLES_FILE_SHAPE = "A JSON file of made-up emails the rule must match or not: an array such as [{\"expected\": \"no_match\", \"label\": \"a personal bill\", \"email\": {...}}], with email as test-email-rule-on-sample takes it (text up to 4,000 characters, at most 10 each of to, cc, attachment_types and attachment_names), like the one generate-look-alikes --samples-file writes, or a generate-look-alikes answer saved as it printed it.";
 const EXPECTATION_FLAG_NOTE = "Replaces any expect in --body-file or --raw-body. The answer reports them in expectations (passed, counts, results) and the exit code follows it; see --help-full.";
 /**
 * update-email-rule's --fail-on-expectations sends if_expectations_pass, over
@@ -53313,11 +54357,11 @@ const EMAIL_RULE_OPERATION_EXTENSIONS = {
 		flags: {
 			"expectations-file": Flags.string({ description: "A JSON file holding the emails the rule must match and must not, such as {\"match\": [\"<email-id>\"], \"no_match\": [\"<email-id>\"]}, replacing its saved expectations; a file holding null removes them. Sets expectations, over any in --body-file or --raw-body; the answer judges them in expectations_check (passed, decided, failed, undecided); the report test-email-rule answers with is named expectations instead." }),
 			[SAMPLES_FILE_FLAG]: Flags.string({
-				description: `${SAMPLES_FILE_SHAPE} They replace the rule's saved ones, and a file holding [] removes them. Sets expectation_samples, over any in --body-file or --raw-body. Not with --${ADD_SAMPLES_FILE_FLAG}. The write judges them only with --${FAIL_ON_EXPECTATIONS_FLAG}, and only when it saves a version or turns the rule active.`,
+				description: `${SAMPLES_FILE_SHAPE} They replace the rule's saved ones, and a file holding [] removes them. Sets expectation_samples, over any in --body-file or --raw-body. Not with --${ADD_SAMPLES_FILE_FLAG}. ${UPDATE_JUDGES_SAMPLES}`,
 				exclusive: [ADD_SAMPLES_FILE_FLAG]
 			}),
 			[ADD_SAMPLES_FILE_FLAG]: Flags.string({
-				description: `${SAMPLES_FILE_SHAPE} They are added to the rule's saved ones, 20 at most in all. Sets add_expectation_samples, over any in --body-file or --raw-body. Not with --${SAMPLES_FILE_FLAG}. The write judges them only with --${FAIL_ON_EXPECTATIONS_FLAG}, and only when it saves a version or turns the rule active.`,
+				description: `${SAMPLES_FILE_SHAPE} They are added to the rule's saved ones, 20 at most in all. Sets add_expectation_samples, over any in --body-file or --raw-body. Not with --${SAMPLES_FILE_FLAG}. ${UPDATE_JUDGES_SAMPLES}`,
 				exclusive: [SAMPLES_FILE_FLAG]
 			}),
 			[PICK_FLAG]: Flags.string({ description: pickFlagHelp([SAMPLES_FILE_FLAG, ADD_SAMPLES_FILE_FLAG]) }),
@@ -53363,7 +54407,9 @@ const EMAIL_RULE_OPERATION_EXTENSIONS = {
 		bodyProperties: ["expectation_samples"]
 	},
 	compileEmailRule: {
-		flags: {},
+		flags: scopeSelectionFlags(),
+		bodyFields: scopeSelectionBodyFields,
+		bodyProperties: ["scope_selection"],
 		report: compileEmailRuleReport
 	},
 	endEmailRuleShare: {
@@ -55530,7 +56576,7 @@ function savedConnectedProfiles(configDir, exclude) {
 */
 async function otherProfiles(configDir, session, current) {
 	if (session) try {
-		const { connectedProfilesForSession } = await import("./machine-session-DkXYR62a.js").then((n) => n.s);
+		const { connectedProfilesForSession } = await import("./machine-session-BMr-zPLx.js").then((n) => n.s);
 		return {
 			inSession: true,
 			profiles: connectedProfilesForSession(configDir, session, current)
@@ -55604,6 +56650,96 @@ async function explainPendingMailNotFound(configDir, emailId, write = (line) =>
 		if (outcome.kind === "dropped") write(`Dropped the pending notice for ${id} from profile ${current.profile} after ${outcome.reads} consecutive not_found reads; the email is no longer visible to this profile.\n`);
 	} catch {}
 }
+// src/oclif/rule-list-defaults.ts
+/** The box the objection list asks for when --box is not given: objections you made and objections to rules you wrote. */
+const OBJECTION_BOX_DEFAULT = "mine";
+/** The box asked for instead when a server refuses OBJECTION_BOX_DEFAULT: objections you made. */
+const OBJECTION_BOX_FALLBACK = "outgoing";
+/** --box on `email-rule-oversight list-email-rule-objections`, with the CLI's default. */
+const OBJECTION_BOX_FLAG = {
+	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. On a server that does not take mine, the CLI lists only those you made by default, and says so.",
+	options: [
+		OBJECTION_BOX_DEFAULT,
+		"outgoing",
+		"incoming",
+		"all"
+	]
+};
+/**
+* The query to send: for the objection list read without --box, the CLI's
+* default box by name; any other query as it is.
+*/
+function withDefaultObjectionBox(sdkName, query) {
+	return sdkName === "listEmailRuleObjections" && query.box === void 0 ? {
+		...query,
+		box: OBJECTION_BOX_DEFAULT
+	} : query;
+}
+function errorBody(payload) {
+	if (payload === null || typeof payload !== "object") return {};
+	const inner = payload.error;
+	return inner !== null && typeof inner === "object" ? inner : payload;
+}
+/**
+* True when an API error is a server that predates box=mine refusing the
+* value: a validation error whose issue for box is an unknown option, not
+* any other refusal that happens to name box.
+*/
+function isObjectionBoxRefused(payload) {
+	const body = errorBody(payload);
+	return body.code === "validation_error" && typeof body.message === "string" && /(^|,\s*)box: Invalid (option|enum value)/.test(body.message);
+}
+/** The error line for `--box mine` given to a server that refuses it. */
+function objectionBoxErrorHint(payload, flags) {
+	if (flags?.box !== "mine" || !isObjectionBoxRefused(payload)) return void 0;
+	return "This server does not take --box mine: use --box outgoing for objections you made, and --box incoming for objections to rules you wrote.";
+}
+const widen = (flags) => `add \`${flags.join(" ")}\` to widen it`;
+/** The objection list's line: what its defaults left out, and how to see more. */
+function objectionsNote(box, status, refused) {
+	if (box && refused) return `By default this server lists only ${status ? "pending objections you made" : "objections you made"}: add \`--box incoming\` for objections to rules you wrote, or \`${["--box all", ...status ? ["--status any"] : []].join(" ")}\` for every one you can see.`;
+	const phrase = box && status ? "pending objections you made and those to rules you wrote" : box ? "objections you made and those to rules you wrote" : status ? "pending objections" : null;
+	if (phrase === null) return void 0;
+	return `By default this lists only ${phrase}: ${widen([...box ? ["--box all"] : [], ...status ? ["--status any"] : []])}.`;
+}
+/**
+* What a rule request, share or objection list read with `query` (the
+* flags as given) left out by its defaults, and the flags that show more.
+* Said on any page. Undefined for any other list, or when every default was
+* overridden.
+*/
+function ruleListDefaultsNote(sdkName, query, options = {}) {
+	const unset = (name) => query[name] === void 0;
+	const said = (phrase, flags) => phrase === null ? void 0 : `By default this lists only ${phrase}: ${widen(flags)}.`;
+	if (sdkName === "listEmailRuleRequests") {
+		const box = unset("box");
+		const status = unset("status");
+		return said(box && status ? "pending requests made to you" : box ? "requests made to you" : status ? "pending requests" : null, [...box ? ["--box all"] : [], ...status ? ["--status any"] : []]);
+	}
+	if (sdkName === "listEmailRuleShares") {
+		const box = unset("box");
+		const live = unset("live");
+		return said(box && live ? "live shares made with you" : box ? "shares made with you" : live ? "live shares" : null, [...box ? ["--box all"] : [], ...live ? ["--live any"] : []]);
+	}
+	if (sdkName === "listGivenEmailRuleShares") return said(unset("live") ? "live shares of your mail" : null, ["--live any"]);
+	if (sdkName === "listEmailRuleObjections") return objectionsNote(unset("box"), unset("status"), options.objectionBoxRefused === true);
+}
+const NOUNS = {
+	listEmailRuleRequests: "requests",
+	listEmailRuleShares: "shares",
+	listGivenEmailRuleShares: "shares",
+	listEmailRuleObjections: "objections"
+};
+/**
+* An empty first page of one of those lists: that nothing matched, then the
+* line above. Undefined for any other list, when every default was
+* overridden, or on a later page (--cursor), where the line alone is said.
+*/
+function emptyRuleListHint(sdkName, query, options = {}) {
+	if (query.cursor !== void 0) return void 0;
+	const note = ruleListDefaultsNote(sdkName, query, options);
+	return note ? `(no results) No ${NOUNS[sdkName]} match. ${note}` : void 0;
+}
 const RULE_REQUEST_WEBHOOK_CREATE_HINT = "Hint: a webhook for rule request or objection events is made by the person it is for, signed in as themself: after `primitive login`, run this without --api-key, PRIMITIVE_API_KEY or PRIMITIVE_AGENT_PROFILE set, or create it in the dashboard. An API key, another app or an agent cannot make one. If you are already signed in as yourself, try again. It is a route target whatever your access, so it never takes a domain's or the organization's default slot.";
 const RULE_REQUEST_WEBHOOK_HTTP_HINT = "Hint: rule request and objection events go only to an http webhook (kind http).";
 const RULE_REQUEST_WEBHOOK_SUBSCRIBE_HINT = "Hint: rule request and objection events go only to a webhook made for them. If this webhook does not list them yet, it cannot be given them: create a new one with `--event-types` naming them (such as 'email_rule_request.*' or 'email_rule_objection.*'), signed in as yourself. If it does, only its maker, signed in as themself, can change it.";
@@ -56013,6 +57149,7 @@ const OPERATION_PATH_FLAGS = {
 		flag: "email-id",
 		description: "The id of the email (from `primitive emails list`), not a rule id: lists what every rule you can see decided about this email, and why a rule did not run. --id is accepted too."
 	} },
+	listEmailRuleObjections: { box: OBJECTION_BOX_FLAG },
 	replyToEmail: { id: {
 		flag: "email-id",
 		description: EMAIL_ID_NOT_SENT
@@ -56205,7 +57342,7 @@ function flagForParameter(parameter, override) {
 	});
 	if (parameter.enum && parameter.enum.length > 0) return Flags.string({
 		...common,
-		options: parameter.enum
+		options: [...override?.options ?? parameter.enum]
 	});
 	return Flags.string(common);
 }
@@ -56461,7 +57598,7 @@ function buildFlags(operation) {
 		time: Flags.boolean({ description: TIME_FLAG_DESCRIPTION })
 	};
 	if (!operation.binaryResponse) {
-		flags.json = Flags.boolean({ description: "Print exactly one JSON document on stdout, on success and on failure, and nothing on stderr. Stdout keeps its usual shape: the data payload, or with --envelope the full response envelope (data plus meta, including meta.cursor, and empty-result hints in summary). The next-cursor line is not printed; use --envelope to page. A failure prints the error with exit_code. Without --json, the cursor and notices go to stderr." });
+		flags.json = Flags.boolean({ description: "Print exactly one JSON document on stdout, on success and on failure, and nothing on stderr. Stdout keeps its usual shape: the data payload, or with --envelope the full response envelope (data plus meta, including meta.cursor, and, in summary, empty-result hints and what a list's default filters left out). The next-cursor line is not printed; use --envelope to page. A failure prints the error with exit_code. Without --json, the cursor and notices go to stderr." });
 		flags.envelope = Flags.boolean({ description: "Print the full response envelope, including pagination metadata such as meta.cursor. Defaults to printing only the data payload for backward compatibility." });
 	}
 	const positional = positionalPathParameter(operation);
@@ -56640,6 +57777,7 @@ const OPERATION_ERROR_HINTS = {
 	createEndpoint: (code, body, payload) => createEndpointRuleRequestHint(code, body, payload),
 	updateEndpoint: (code, body, payload) => updateEndpointRuleRequestHint(code, body, payload),
 	updateEmailRule: (code, body, payload, path, flags) => updateEmailRuleErrorHint(code, payload, path?.id, body, flags),
+	listEmailRuleObjections: (_code, _body, payload, _path, flags) => objectionBoxErrorHint(payload, flags),
 	verifyDomain: (code, _body, payload) => code === "dns_verification_failed" ? domainVerificationFailedHint(payload) : void 0,
 	addDomain: (code, body) => {
 		if (code === "mail_relay_unavailable") return MAIL_RELAY_UNAVAILABLE_MESSAGE;
@@ -56752,7 +57890,9 @@ function createOperationCommand(operation) {
 				const replyStateSurface = replyStateSurfaceForOperation(operation.sdkName, query);
 				const automatedSurface = automatedSurfaceForOperation(operation.sdkName, query);
 				const fromVerified = fromVerifiedExpectation(operation.sdkName, query);
-				const callOperation = (stepUpToken, pageQuery = query) => {
+				let sentQuery = withDefaultObjectionBox(operation.sdkName, query);
+				let objectionBoxRefused = false;
+				const callOperation = (stepUpToken, pageQuery = sentQuery) => {
 					const sent = stepUpToken ? {
 						...headers,
 						[STEP_UP_HEADER]: stepUpToken
@@ -56797,7 +57937,7 @@ function createOperationCommand(operation) {
 					const rows = [];
 					let sentCursor = query.cursor;
 					let last = await callOperation(void 0, {
-						...query,
+						...sentQuery,
 						limit: Math.min(max, wanted)
 					});
 					const budget = Math.ceil(wanted / max) + 20;
@@ -56823,7 +57963,7 @@ function createOperationCommand(operation) {
 						};
 						sentCursor = cursor;
 						last = await callOperation(void 0, {
-							...query,
+							...sentQuery,
 							cursor,
 							limit: Math.min(max, wanted - rows.length)
 						});
@@ -56834,13 +57974,22 @@ function createOperationCommand(operation) {
 					const warning = typeof role === "string" ? roleReadsAllMailWarning(role, await readRoles(apiClient.client)) : null;
 					if (warning) process.stderr.write(`${warning}\n`);
 				}
-				const result = paged ? await callPaged() : takesStepUp(operation) ? await callWithApproval() : ATTACHMENT_WAIT_OPERATIONS.has(operation.sdkName) ? await withAttachmentWait(callOperation, {
+				const send = async () => paged ? await callPaged() : takesStepUp(operation) ? await callWithApproval() : ATTACHMENT_WAIT_OPERATIONS.has(operation.sdkName) ? await withAttachmentWait(callOperation, {
 					wait: parsedFlags.wait !== false,
 					errorCode: (error) => extractErrorCode(extractErrorPayload(error)),
 					onFirstWait: () => {
 						process.stderr.write(`Attachment content is not ready yet; waiting up to ${ATTACHMENT_WAIT_MAX_MS / 1e3}s. Pass --no-wait to return immediately.\n`);
 					}
 				}) : await callOperation();
+				let result = await send();
+				if (result.error && sentQuery !== query && isObjectionBoxRefused(extractErrorPayload(result.error))) {
+					sentQuery = {
+						...query,
+						box: OBJECTION_BOX_FALLBACK
+					};
+					objectionBoxRefused = true;
+					result = await send();
+				}
 				if (result.error) {
 					const errorPayload = extractErrorPayload(result.error);
 					const operationErrorHint = OPERATION_ERROR_HINTS[operation.sdkName]?.(extractErrorCode(errorPayload), body, errorPayload, collectValues(operation.pathParams, parsedFlags, operation.sdkName), parsedFlags);
@@ -56920,18 +58069,26 @@ function createOperationCommand(operation) {
 				if (cursor && !jsonOutput) process.stderr.write(`next cursor: ${cursor}\n`);
 				if (pagingNote && !jsonOutput) process.stderr.write(`${pagingNote}\n`);
 				const summary = [];
+				let ruleListHintSaid = false;
 				if (Array.isArray(envelope?.data) && envelope.data.length === 0 && (!jsonOutput || withEnvelope) && (jsonOutput || !metaExplainsEmptyList(envelope?.meta))) {
 					const tail = query.since !== void 0;
 					const more = envelope?.meta?.cursor ?? null;
+					const ruleListHint = emptyRuleListHint(operation.sdkName, query, { objectionBoxRefused });
+					ruleListHintSaid = ruleListHint !== void 0;
 					const hint = operation.sdkName === "listEmails" ? emptyEmailListHint({
 						filterFlags: listFilters(query).map((name) => `--${parameterFlagName(operation.sdkName, name)}`),
 						...tail ? { pastFlag: "--since" } : query.cursor !== void 0 ? { pastFlag: "--cursor" } : {},
 						nextCursor: tail ? null : more,
 						caller: tail || more ? null : await readCallerMailFor(auth, apiClient.client)
-					}) : emptyRuleListHint(operation.sdkName, query) ?? emptyDeliveriesHint(operation.sdkName, query) ?? EMPTY_RESULT_HINTS[operation.sdkName];
+					}) : ruleListHint ?? emptyDeliveriesHint(operation.sdkName, query) ?? EMPTY_RESULT_HINTS[operation.sdkName];
 					if (hint && jsonOutput) summary.push(hint);
 					else if (hint) process.stderr.write(`${hint}\n`);
 				}
+				if (Array.isArray(envelope?.data) && (!jsonOutput || withEnvelope)) {
+					const note = ruleListHintSaid ? void 0 : ruleListDefaultsNote(operation.sdkName, query, { objectionBoxRefused });
+					if (note && jsonOutput) summary.push(note);
+					else if (note) process.stderr.write(`${note}\n`);
+				}
 				if (!jsonOutput) for (const line of metaNoteLines(envelope?.meta)) process.stderr.write(`${line}\n`);
 				if (operation.sdkName === "listSentEmails") {
 					const note = sentListOtherSendersNote(envelope?.data, auth.connectedAgent?.agentAddress);
@@ -57007,35 +58164,6 @@ const EMPTY_RESULT_HINTS = {
 	listFunctions: "(no results) No Functions configured yet. Start with `primitive functions templates`, then `primitive functions init --template <template>` and `primitive functions deploy --name <name> --file <bundle>`."
 };
 /**
-* An empty rule request, share or objection list, read by the filters the
-* call left at their defaults: each list shows only part of what you can see
-* by default (pending requests made to you; live shares made with you;
-* pending objections you made), so an empty answer says which flags widen
-* it. Undefined for any other list, when every filter was given, or on a
-* later page (--cursor), which is empty only past the end.
-*/
-function emptyRuleListHint(sdkName, query) {
-	if (query.cursor !== void 0) return void 0;
-	const unset = (name) => query[name] === void 0;
-	const said = (noun, phrase, flags) => phrase === null ? void 0 : `(no results) No ${noun} match. By default this lists only ${phrase}: add \`${flags.join(" ")}\` to widen it.`;
-	if (sdkName === "listEmailRuleRequests") {
-		const box = unset("box");
-		const status = unset("status");
-		return said("requests", box && status ? "pending requests made to you" : box ? "requests made to you" : status ? "pending requests" : null, [...box ? ["--box all"] : [], ...status ? ["--status any"] : []]);
-	}
-	if (sdkName === "listEmailRuleShares") {
-		const box = unset("box");
-		const live = unset("live");
-		return said("shares", box && live ? "live shares made with you" : box ? "shares made with you" : live ? "live shares" : null, [...box ? ["--box all"] : [], ...live ? ["--live any"] : []]);
-	}
-	if (sdkName === "listGivenEmailRuleShares") return said("shares", unset("live") ? "live shares of your mail" : null, ["--live any"]);
-	if (sdkName === "listEmailRuleObjections") {
-		const box = unset("box");
-		const status = unset("status");
-		return said("objections", box && status ? "pending objections you made" : box ? "objections you made" : status ? "pending objections" : null, [...box ? ["--box all"] : [], ...status ? ["--status any"] : []]);
-	}
-}
-/**
 * An empty delivery list narrowed by a filter (--endpoint-id, --status,
 * --event-type and the rest) names the filters given, in place of the general
 * hint, which reads as if nothing was ever delivered, and keeps its point that