@primitivedotdev/sdk 1.27.0 → 1.30.0

package/dist/{operations.generated-CoVn-Rb6.js → operations.generated-CKeVL_i2.js}

@@ -45,6 +45,10 @@ const openapiDocument = {
 			"name": "Account",
 			"description": "Manage your account settings, storage, and webhook secret"
 		},
+		{
+			"name": "Credits",
+			"description": "Redeem credit codes and read the organization credit balance"
+		},
 		{
 			"name": "Domains",
 			"description": "Claim, verify, and manage email domains"
@@ -649,6 +653,129 @@ const openapiDocument = {
 				"429": { "$ref": "#/components/responses/RateLimited" }
 			}
 		} },
+		"/credits/redeem": { "post": {
+			"operationId": "redeemCreditCode",
+			"summary": "Redeem a credit code",
+			"description": "Redeem a credit code for the authenticated organization. The credit is\nadded to the organization prepaid credit and shows in\n`GET /credits/balance` under `prepaid_credit`.\n\nRedeeming requires an organization owner or admin. An API key redeems\nwith the authority of the user who created it, based on that user's\ncurrent role; a key without that authority gets the same\n`credit_code_invalid` refusal as an unknown code.\n\nThe `Idempotency-Key` header is required. Retrying with the same key\nand code returns the original grant with `replayed: true` and grants\nnothing new; the same key with a different code is refused with\n`idempotency_key_reused`. Every refusal carries a human-readable\n`error.message` that can be shown to the user as is.\n",
+			"tags": ["Credits"],
+			"parameters": [{
+				"name": "Idempotency-Key",
+				"in": "header",
+				"required": true,
+				"description": "Required client-supplied key: 1 to 200 printable ASCII\ncharacters, without spaces. Use a new key for each code you\nredeem and reuse it only to retry the same request.\n",
+				"schema": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 200,
+					"pattern": "^[\\x21-\\x7E]{1,200}$"
+				}
+			}],
+			"requestBody": {
+				"required": true,
+				"content": { "application/json": {
+					"schema": { "$ref": "#/components/schemas/RedeemCreditCodeInput" },
+					"example": { "code": "LAUNCH50" }
+				} }
+			},
+			"responses": {
+				"200": {
+					"description": "The code was redeemed, or this request replayed an earlier\nredemption with the same Idempotency-Key.\n",
+					"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
+						"type": "object",
+						"properties": { "data": { "$ref": "#/components/schemas/CreditRedemption" } }
+					}] } } }
+				},
+				"400": {
+					"description": "`idempotency_key_required` means the Idempotency-Key header is\nmissing. `validation_error` means the header is empty, longer than\n200 characters or not printable non-space ASCII, or the body is\ninvalid.\n",
+					"content": { "application/json": {
+						"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+						"example": {
+							"success": false,
+							"error": {
+								"code": "idempotency_key_required",
+								"message": "an Idempotency-Key header is required"
+							}
+						}
+					} }
+				},
+				"401": { "$ref": "#/components/responses/Unauthorized" },
+				"403": { "$ref": "#/components/responses/Forbidden" },
+				"409": {
+					"description": "The organization or user already redeemed this code, or already\nredeemed another code in the same exclusive group (a set of codes\nof which each organization or user may redeem only one).\n`error.code` is `credit_code_already_redeemed`.\n",
+					"content": { "application/json": {
+						"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+						"example": {
+							"success": false,
+							"error": {
+								"code": "credit_code_already_redeemed",
+								"message": "Your organization has already redeemed this promotion."
+							}
+						}
+					} }
+				},
+				"422": {
+					"description": "The code cannot be redeemed. `credit_code_invalid` covers unknown,\nexpired and exhausted codes and callers without authority to\nredeem; `credit_code_not_eligible` means the organization does not\nmeet the promotion terms; `credit_code_balance_cap` means the\norganization already holds the most promotional credit it can;\n`idempotency_key_reused` means this Idempotency-Key already\nredeemed a different code.\n",
+					"content": { "application/json": {
+						"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+						"example": {
+							"success": false,
+							"error": {
+								"code": "credit_code_invalid",
+								"message": "That code isn't valid or is no longer available."
+							}
+						}
+					} }
+				},
+				"429": {
+					"description": "Too many requests or redemption attempts. `error.code` is\n`rate_limited`. Wait for `Retry-After` when present. Like other\nrate-limited responses, it also carries the `ratelimit-limit`,\n`ratelimit-remaining`, `ratelimit-reset` and `ratelimit-policy`\nquota headers when the limiter reports them.\n",
+					"headers": { "Retry-After": {
+						"schema": { "type": "integer" },
+						"description": "Seconds to wait before retrying"
+					} },
+					"content": { "application/json": {
+						"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+						"example": {
+							"success": false,
+							"error": {
+								"code": "rate_limited",
+								"message": "Rate limit exceeded. Try again shortly."
+							}
+						}
+					} }
+				},
+				"503": {
+					"description": "The code could not be redeemed right now. Retry later with the\nsame Idempotency-Key. `error.code` is `service_unavailable`.\n",
+					"content": { "application/json": {
+						"schema": { "$ref": "#/components/schemas/ErrorResponse" },
+						"example": {
+							"success": false,
+							"error": {
+								"code": "service_unavailable",
+								"message": "We couldn't redeem that code right now. Try again in a few minutes."
+							}
+						}
+					} }
+				}
+			}
+		} },
+		"/credits/balance": { "get": {
+			"operationId": "getCreditBalance",
+			"summary": "Get credit balance",
+			"description": "Read the organization credit position. `prepaid_credit` is the prepaid\nusage credit (paid top-ups, redeemed credit codes and granted credit)\nthat can still pay for usage. `budget` is the active agent spending\nbudget an operator funded for top-ups, or null when there is none.\nAmounts are strings of integer micros (1 USD = 1000000 micros).\n",
+			"tags": ["Credits"],
+			"responses": {
+				"200": {
+					"description": "The organization credit balance.",
+					"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
+						"type": "object",
+						"properties": { "data": { "$ref": "#/components/schemas/CreditBalance" } }
+					}] } } }
+				},
+				"401": { "$ref": "#/components/responses/Unauthorized" },
+				"403": { "$ref": "#/components/responses/Forbidden" },
+				"429": { "$ref": "#/components/responses/RateLimited" }
+			}
+		} },
 		"/domains": {
 			"get": {
 				"operationId": "listDomains",
@@ -953,7 +1080,7 @@ const openapiDocument = {
 		"/emails/search": { "get": {
 			"operationId": "searchEmails",
 			"summary": "Search inbound emails",
-			"description": "Searches inbound emails with structured filters and optional\nfull-text matching across parsed email fields. This endpoint is\noptimized for filtered inbox views and CLI polling workflows:\ncallers that only need new accepted mail can pass\n`sort=received_at_asc`, `snippet=false`, `include_facets=false`,\nand a `date_from` timestamp.\n\n`q`, `subject`, and `body` use the same English full-text index\nas the web inbox search. Structured filters such as `from`, `to`,\n`domain_id`, status, attachment presence, and spam score bounds\nare combined with the text query.\n",
+			"description": "Searches inbound emails with structured filters and optional\nfull-text matching across parsed email fields. This endpoint is\noptimized for filtered inbox views and CLI polling workflows:\ncallers that only need new accepted mail can pass\n`sort=received_at_asc`, `snippet=false`, `include_facets=false`,\nand a `date_from` timestamp.\n\n`q`, `subject`, and `body` use the same English full-text index\nas the web inbox search. Structured filters such as `from`, `to`,\n`domain_id`, status, attachment presence, and spam score bounds\nare combined with the text query.\n\nConnected-agent credentials search only mail received by their own\naddress. This applies to results, totals, facets, and every page;\nsearch filters cannot widen the credential's scope. When\n`reply_to_sent_email_id` is supplied, its parent send must belong\nto the connected address in the same organization. An unavailable\nparent returns 404. Sender filters are not authentication proof;\ninspect the email detail's authentication evidence before trusting it.\n",
 			"tags": ["Emails"],
 			"parameters": [
 				{
@@ -1126,6 +1253,7 @@ const openapiDocument = {
 				},
 				"400": { "$ref": "#/components/responses/ValidationError" },
 				"401": { "$ref": "#/components/responses/Unauthorized" },
+				"404": { "$ref": "#/components/responses/NotFound" },
 				"504": {
 					"description": "Search query timed out",
 					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }
@@ -1483,7 +1611,7 @@ const openapiDocument = {
 			"post": {
 				"operationId": "createEndpoint",
 				"summary": "Create a webhook endpoint",
-				"description": "Creates a new webhook endpoint. If a deactivated endpoint\nwith the same URL and domain exists, it is reactivated\ninstead. Subject to plan limits on the number of active\nendpoints.\n\n**Signing is account-scoped, not per-endpoint.** This call\ndoes not return any signing material; every endpoint on the\naccount uses the same webhook secret, fetched via\n`GET /account/webhook-secret`. See the API-level \"Webhook\nsigning\" section for the full wire format (header name,\nsigned string, hash algo, secret format, tolerance) and a\nlanguage-agnostic verification recipe.\n\nAfter creating the endpoint, fire a test delivery against\nit via `POST /endpoints/{id}/test` to confirm your verifier\naccepts the signature.\n\n\nFor local receiving, use kind=pull and a stable name, without url, function_id or domain_id. Named creation resumes the same active destination; omitted filters preserve its selection, while conflicting supplied configuration returns 409. New unfiltered destinations receive all subsequently ready eligible event types. Pull destinations do not occupy HTTP routing slots. Signing-secret setup and a test HTTP delivery are not required for pull receiving.",
+				"description": "Creates a new webhook endpoint. If a deactivated endpoint\nwith the same URL and domain exists, it is reactivated\ninstead. Subject to plan limits on the number of active\nendpoints.\n\n**Signing is account-scoped, not per-endpoint.** This call\ndoes not return any signing material; every endpoint on the\naccount uses the same webhook secret, fetched via\n`GET /account/webhook-secret`. See the API-level \"Webhook\nsigning\" section for the full wire format (header name,\nsigned string, hash algo, secret format, tolerance) and a\nlanguage-agnostic verification recipe.\n\nAfter creating the endpoint, fire a test delivery against\nit via `POST /endpoints/{id}/test` to confirm your verifier\naccepts the signature.\n\n\nFor local receiving, use kind=pull and a stable name, without url, function_id or domain_id. Named creation resumes the same active destination; omitted filters preserve its selection, while conflicting supplied configuration returns 409. New unfiltered destinations receive all subsequently ready eligible event types within their credential scope. Connected-agent credentials automatically create private subscriptions restricted to inbound email for their assigned address. Names are isolated per credential; revocation or replacement deletes its subscriptions. Address-scoped events contain parsed mail without raw MIME, signed download links, routing metadata, or sibling envelope recipients. Pull destinations do not occupy HTTP routing slots. Signing-secret setup and a test HTTP delivery are not required for pull receiving.",
 				"tags": ["Endpoints"],
 				"requestBody": {
 					"required": true,
@@ -5337,7 +5465,15 @@ const openapiDocument = {
 									"event_content_unavailable",
 									"event_preparation_failed",
 									"subscription_unavailable",
-									"stale_delivery"
+									"stale_delivery",
+									"idempotency_key_required",
+									"idempotency_key_reused",
+									"credit_code_invalid",
+									"credit_code_already_redeemed",
+									"credit_code_not_eligible",
+									"credit_code_balance_cap",
+									"rate_limited",
+									"service_unavailable"
 								]
 							},
 							"message": { "type": "string" },
@@ -6303,6 +6439,148 @@ const openapiDocument = {
 				} },
 				"required": ["secret"]
 			},
+			"RedeemCreditCodeInput": {
+				"type": "object",
+				"additionalProperties": false,
+				"required": ["code"],
+				"properties": { "code": {
+					"type": "string",
+					"pattern": "^\\s*\\S(?:[\\s\\S]{0,254}\\S)?\\s*$",
+					"description": "The credit code to redeem. Surrounding whitespace is ignored; the\nrest must be 1 to 256 characters.\n"
+				} }
+			},
+			"CreditRedemption": {
+				"type": "object",
+				"additionalProperties": false,
+				"required": [
+					"redemption_id",
+					"amount_micros",
+					"currency",
+					"granted_at",
+					"expires_at",
+					"label",
+					"replayed",
+					"message"
+				],
+				"properties": {
+					"redemption_id": {
+						"type": "string",
+						"description": "Identifier of the redemption."
+					},
+					"amount_micros": {
+						"type": "string",
+						"pattern": "^[0-9]+$",
+						"description": "Credit granted, in micros of `currency` (1 USD = 1000000 micros)."
+					},
+					"currency": {
+						"type": "string",
+						"description": "Currency of the granted credit, for example `usd`."
+					},
+					"granted_at": {
+						"type": "string",
+						"format": "date-time",
+						"description": "When the credit was granted."
+					},
+					"expires_at": {
+						"type": ["string", "null"],
+						"format": "date-time",
+						"description": "When the granted credit expires, or null when it does not expire."
+					},
+					"label": {
+						"type": ["string", "null"],
+						"description": "Customer-facing label of the promotion, when it has one."
+					},
+					"replayed": {
+						"type": "boolean",
+						"description": "True when this Idempotency-Key already redeemed this code and the\noriginal grant is returned. No second grant is made.\n"
+					},
+					"message": {
+						"type": "string",
+						"description": "Human-readable summary of the grant, suitable to show as is."
+					}
+				}
+			},
+			"CreditBalance": {
+				"type": "object",
+				"required": ["budget"],
+				"properties": {
+					"budget": {
+						"description": "The active agent spending budget an operator funded for top-ups,\nor null when there is none.\n",
+						"type": ["object", "null"],
+						"additionalProperties": false,
+						"required": [
+							"currency",
+							"max_amount_micros",
+							"spent_micros",
+							"remaining_micros",
+							"per_topup_cap_micros",
+							"expires_at",
+							"status"
+						],
+						"properties": {
+							"currency": {
+								"type": "string",
+								"description": "Currency of the budget, for example `usd`."
+							},
+							"max_amount_micros": {
+								"type": "string",
+								"pattern": "^[0-9]+$",
+								"description": "Total allowance the operator funded, in micros."
+							},
+							"spent_micros": {
+								"type": "string",
+								"pattern": "^[0-9]+$",
+								"description": "How much of the allowance has been drawn down, in micros."
+							},
+							"remaining_micros": {
+								"type": "string",
+								"pattern": "^[0-9]+$",
+								"description": "`max_amount_micros - spent_micros`, floored at zero."
+							},
+							"per_topup_cap_micros": {
+								"type": ["string", "null"],
+								"pattern": "^[0-9]+$",
+								"description": "Largest single top-up allowed, in micros, or null for no per-top-up cap."
+							},
+							"expires_at": {
+								"type": ["string", "null"],
+								"format": "date-time",
+								"description": "When the allowance expires, or null for no expiry."
+							},
+							"status": {
+								"type": "string",
+								"description": "Budget status. An active budget reads `active`."
+							}
+						}
+					},
+					"prepaid_credit": {
+						"description": "Prepaid usage credit (top-ups, redeemed credit codes and granted\ncredit) that can still pay for usage, or null when there is none.\nOmitted when an exact figure cannot be given right now; the budget\nis still returned.\n",
+						"type": ["object", "null"],
+						"additionalProperties": false,
+						"required": [
+							"currency",
+							"remaining_micros",
+							"next_expires_at"
+						],
+						"properties": {
+							"currency": {
+								"type": "string",
+								"description": "Currency of the credit, which is the organization billing currency."
+							},
+							"remaining_micros": {
+								"type": "string",
+								"pattern": "^[0-9]+$",
+								"description": "What the credit can still pay for, in micros."
+							},
+							"next_expires_at": {
+								"type": ["string", "null"],
+								"format": "date-time",
+								"description": "Earliest expiry among credits with a balance, or null when none of them expires."
+							}
+						}
+					}
+				}
+			},
 			"InboxStatus": {
 				"type": "object",
 				"additionalProperties": false,
@@ -8906,6 +9184,10 @@ const openapiDocument = {
 			"Endpoint": {
 				"type": "object",
 				"properties": {
+					"recipient": {
+						"type": ["string", "null"],
+						"description": "Server-enforced recipient for an address-scoped pull subscription; null for account-wide receiving."
+					},
 					"receiver_capabilities": {
 						"type": "object",
 						"properties": {
@@ -12741,6 +13023,181 @@ const operationManifest = [
 		"tag": "CLI",
 		"tagCommand": "cli"
 	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": false,
+		"command": "get-credit-balance",
+		"description": "Read the organization credit position. `prepaid_credit` is the prepaid\nusage credit (paid top-ups, redeemed credit codes and granted credit)\nthat can still pay for usage. `budget` is the active agent spending\nbudget an operator funded for top-ups, or null when there is none.\nAmounts are strings of integer micros (1 USD = 1000000 micros).\n",
+		"hasJsonBody": false,
+		"method": "GET",
+		"operationId": "getCreditBalance",
+		"path": "/credits/balance",
+		"pathParams": [],
+		"queryParams": [],
+		"requestSchema": null,
+		"responseSchema": {
+			"type": "object",
+			"required": ["budget"],
+			"properties": {
+				"budget": {
+					"description": "The active agent spending budget an operator funded for top-ups,\nor null when there is none.\n",
+					"type": ["object", "null"],
+					"additionalProperties": false,
+					"required": [
+						"currency",
+						"max_amount_micros",
+						"spent_micros",
+						"remaining_micros",
+						"per_topup_cap_micros",
+						"expires_at",
+						"status"
+					],
+					"properties": {
+						"currency": {
+							"type": "string",
+							"description": "Currency of the budget, for example `usd`."
+						},
+						"max_amount_micros": {
+							"type": "string",
+							"pattern": "^[0-9]+$",
+							"description": "Total allowance the operator funded, in micros."
+						},
+						"spent_micros": {
+							"type": "string",
+							"pattern": "^[0-9]+$",
+							"description": "How much of the allowance has been drawn down, in micros."
+						},
+						"remaining_micros": {
+							"type": "string",
+							"pattern": "^[0-9]+$",
+							"description": "`max_amount_micros - spent_micros`, floored at zero."
+						},
+						"per_topup_cap_micros": {
+							"type": ["string", "null"],
+							"pattern": "^[0-9]+$",
+							"description": "Largest single top-up allowed, in micros, or null for no per-top-up cap."
+						},
+						"expires_at": {
+							"type": ["string", "null"],
+							"format": "date-time",
+							"description": "When the allowance expires, or null for no expiry."
+						},
+						"status": {
+							"type": "string",
+							"description": "Budget status. An active budget reads `active`."
+						}
+					}
+				},
+				"prepaid_credit": {
+					"description": "Prepaid usage credit (top-ups, redeemed credit codes and granted\ncredit) that can still pay for usage, or null when there is none.\nOmitted when an exact figure cannot be given right now; the budget\nis still returned.\n",
+					"type": ["object", "null"],
+					"additionalProperties": false,
+					"required": [
+						"currency",
+						"remaining_micros",
+						"next_expires_at"
+					],
+					"properties": {
+						"currency": {
+							"type": "string",
+							"description": "Currency of the credit, which is the organization billing currency."
+						},
+						"remaining_micros": {
+							"type": "string",
+							"pattern": "^[0-9]+$",
+							"description": "What the credit can still pay for, in micros."
+						},
+						"next_expires_at": {
+							"type": ["string", "null"],
+							"format": "date-time",
+							"description": "Earliest expiry among credits with a balance, or null when none of them expires."
+						}
+					}
+				}
+			}
+		},
+		"sdkName": "getCreditBalance",
+		"summary": "Get credit balance",
+		"tag": "Credits",
+		"tagCommand": "credits"
+	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": true,
+		"command": "redeem-credit-code",
+		"description": "Redeem a credit code for the authenticated organization. The credit is\nadded to the organization prepaid credit and shows in\n`GET /credits/balance` under `prepaid_credit`.\n\nRedeeming requires an organization owner or admin. An API key redeems\nwith the authority of the user who created it, based on that user's\ncurrent role; a key without that authority gets the same\n`credit_code_invalid` refusal as an unknown code.\n\nThe `Idempotency-Key` header is required. Retrying with the same key\nand code returns the original grant with `replayed: true` and grants\nnothing new; the same key with a different code is refused with\n`idempotency_key_reused`. Every refusal carries a human-readable\n`error.message` that can be shown to the user as is.\n",
+		"hasJsonBody": true,
+		"method": "POST",
+		"operationId": "redeemCreditCode",
+		"path": "/credits/redeem",
+		"pathParams": [],
+		"queryParams": [],
+		"requestSchema": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["code"],
+			"properties": { "code": {
+				"type": "string",
+				"pattern": "^\\s*\\S(?:[\\s\\S]{0,254}\\S)?\\s*$",
+				"description": "The credit code to redeem. Surrounding whitespace is ignored; the\nrest must be 1 to 256 characters.\n"
+			} }
+		},
+		"responseSchema": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": [
+				"redemption_id",
+				"amount_micros",
+				"currency",
+				"granted_at",
+				"expires_at",
+				"label",
+				"replayed",
+				"message"
+			],
+			"properties": {
+				"redemption_id": {
+					"type": "string",
+					"description": "Identifier of the redemption."
+				},
+				"amount_micros": {
+					"type": "string",
+					"pattern": "^[0-9]+$",
+					"description": "Credit granted, in micros of `currency` (1 USD = 1000000 micros)."
+				},
+				"currency": {
+					"type": "string",
+					"description": "Currency of the granted credit, for example `usd`."
+				},
+				"granted_at": {
+					"type": "string",
+					"format": "date-time",
+					"description": "When the credit was granted."
+				},
+				"expires_at": {
+					"type": ["string", "null"],
+					"format": "date-time",
+					"description": "When the granted credit expires, or null when it does not expire."
+				},
+				"label": {
+					"type": ["string", "null"],
+					"description": "Customer-facing label of the promotion, when it has one."
+				},
+				"replayed": {
+					"type": "boolean",
+					"description": "True when this Idempotency-Key already redeemed this code and the\noriginal grant is returned. No second grant is made.\n"
+				},
+				"message": {
+					"type": "string",
+					"description": "Human-readable summary of the grant, suitable to show as is."
+				}
+			}
+		},
+		"sdkName": "redeemCreditCode",
+		"summary": "Redeem a credit code",
+		"tag": "Credits",
+		"tagCommand": "credits"
+	},
 	{
 		"binaryResponse": false,
 		"bodyRequired": true,
@@ -14814,7 +15271,7 @@ const operationManifest = [
 		"binaryResponse": false,
 		"bodyRequired": false,
 		"command": "search-emails",
-		"description": "Searches inbound emails with structured filters and optional\nfull-text matching across parsed email fields. This endpoint is\noptimized for filtered inbox views and CLI polling workflows:\ncallers that only need new accepted mail can pass\n`sort=received_at_asc`, `snippet=false`, `include_facets=false`,\nand a `date_from` timestamp.\n\n`q`, `subject`, and `body` use the same English full-text index\nas the web inbox search. Structured filters such as `from`, `to`,\n`domain_id`, status, attachment presence, and spam score bounds\nare combined with the text query.\n",
+		"description": "Searches inbound emails with structured filters and optional\nfull-text matching across parsed email fields. This endpoint is\noptimized for filtered inbox views and CLI polling workflows:\ncallers that only need new accepted mail can pass\n`sort=received_at_asc`, `snippet=false`, `include_facets=false`,\nand a `date_from` timestamp.\n\n`q`, `subject`, and `body` use the same English full-text index\nas the web inbox search. Structured filters such as `from`, `to`,\n`domain_id`, status, attachment presence, and spam score bounds\nare combined with the text query.\n\nConnected-agent credentials search only mail received by their own\naddress. This applies to results, totals, facets, and every page;\nsearch filters cannot widen the credential's scope. When\n`reply_to_sent_email_id` is supplied, its parent send must belong\nto the connected address in the same organization. An unavailable\nparent returns 404. Sender filters are not authentication proof;\ninspect the email detail's authentication evidence before trusting it.\n",
 		"hasJsonBody": false,
 		"method": "GET",
 		"operationId": "searchEmails",
@@ -15334,7 +15791,7 @@ const operationManifest = [
 		"binaryResponse": false,
 		"bodyRequired": true,
 		"command": "create-endpoint",
-		"description": "Creates a new webhook endpoint. If a deactivated endpoint\nwith the same URL and domain exists, it is reactivated\ninstead. Subject to plan limits on the number of active\nendpoints.\n\n**Signing is account-scoped, not per-endpoint.** This call\ndoes not return any signing material; every endpoint on the\naccount uses the same webhook secret, fetched via\n`GET /account/webhook-secret`. See the API-level \"Webhook\nsigning\" section for the full wire format (header name,\nsigned string, hash algo, secret format, tolerance) and a\nlanguage-agnostic verification recipe.\n\nAfter creating the endpoint, fire a test delivery against\nit via `POST /endpoints/{id}/test` to confirm your verifier\naccepts the signature.\n\n\nFor local receiving, use kind=pull and a stable name, without url, function_id or domain_id. Named creation resumes the same active destination; omitted filters preserve its selection, while conflicting supplied configuration returns 409. New unfiltered destinations receive all subsequently ready eligible event types. Pull destinations do not occupy HTTP routing slots. Signing-secret setup and a test HTTP delivery are not required for pull receiving.",
+		"description": "Creates a new webhook endpoint. If a deactivated endpoint\nwith the same URL and domain exists, it is reactivated\ninstead. Subject to plan limits on the number of active\nendpoints.\n\n**Signing is account-scoped, not per-endpoint.** This call\ndoes not return any signing material; every endpoint on the\naccount uses the same webhook secret, fetched via\n`GET /account/webhook-secret`. See the API-level \"Webhook\nsigning\" section for the full wire format (header name,\nsigned string, hash algo, secret format, tolerance) and a\nlanguage-agnostic verification recipe.\n\nAfter creating the endpoint, fire a test delivery against\nit via `POST /endpoints/{id}/test` to confirm your verifier\naccepts the signature.\n\n\nFor local receiving, use kind=pull and a stable name, without url, function_id or domain_id. Named creation resumes the same active destination; omitted filters preserve its selection, while conflicting supplied configuration returns 409. New unfiltered destinations receive all subsequently ready eligible event types within their credential scope. Connected-agent credentials automatically create private subscriptions restricted to inbound email for their assigned address. Names are isolated per credential; revocation or replacement deletes its subscriptions. Address-scoped events contain parsed mail without raw MIME, signed download links, routing metadata, or sibling envelope recipients. Pull destinations do not occupy HTTP routing slots. Signing-secret setup and a test HTTP delivery are not required for pull receiving.",
 		"hasJsonBody": true,
 		"method": "POST",
 		"operationId": "createEndpoint",
@@ -15402,6 +15859,10 @@ const operationManifest = [
 		"responseSchema": {
 			"type": "object",
 			"properties": {
+				"recipient": {
+					"type": ["string", "null"],
+					"description": "Server-enforced recipient for an address-scoped pull subscription; null for account-wide receiving."
+				},
 				"receiver_capabilities": {
 					"type": "object",
 					"properties": {
@@ -15578,6 +16039,10 @@ const operationManifest = [
 			"items": {
 				"type": "object",
 				"properties": {
+					"recipient": {
+						"type": ["string", "null"],
+						"description": "Server-enforced recipient for an address-scoped pull subscription; null for account-wide receiving."
+					},
 					"receiver_capabilities": {
 						"type": "object",
 						"properties": {
@@ -16044,6 +16509,10 @@ const operationManifest = [
 		"responseSchema": {
 			"type": "object",
 			"properties": {
+				"recipient": {
+					"type": ["string", "null"],
+					"description": "Server-enforced recipient for an address-scoped pull subscription; null for account-wide receiving."
+				},
 				"receiver_capabilities": {
 					"type": "object",
 					"properties": {

package/dist/parser/index.d.ts

@@ -1,4 +1,4 @@
-import { I as WebhookAttachment, l as EmailAddress, w as ParsedDataComplete } from "../types-DcXtFARL.js";
+import { I as WebhookAttachment, l as EmailAddress, w as ParsedDataComplete } from "../types-Rn4qu5Q7.js";
 import { a as parseFromHeader, i as ValidatedAddress, n as ParseFromHeaderResult, o as parseFromHeaderLoose, r as ParsedAddress, t as ParseFromHeaderFailureReason } from "../address-parser-B7L4E0zP.js";
 
 //#region src/parser/attachment-parser.d.ts