@primitivedotdev/sdk 1.26.1 → 1.29.0

package/dist/{operations.generated-DVHnicf5.js → operations.generated-Dra-xGtu.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",
@@ -1483,7 +1610,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 +5464,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 +6438,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,
@@ -8667,14 +8944,16 @@ const openapiDocument = {
 				"oneOf": [
 					{ "$ref": "#/components/schemas/CompleteWebhookHttpInput" },
 					{ "$ref": "#/components/schemas/CompleteWebhookExecInput" },
-					{ "$ref": "#/components/schemas/CompleteWebhookStdoutInput" }
+					{ "$ref": "#/components/schemas/CompleteWebhookStdoutInput" },
+					{ "$ref": "#/components/schemas/CompleteWebhookSdkInput" }
 				],
 				"discriminator": {
 					"propertyName": "mode",
 					"mapping": {
 						"http": "#/components/schemas/CompleteWebhookHttpInput",
 						"exec": "#/components/schemas/CompleteWebhookExecInput",
-						"stdout": "#/components/schemas/CompleteWebhookStdoutInput"
+						"stdout": "#/components/schemas/CompleteWebhookStdoutInput",
+						"sdk": "#/components/schemas/CompleteWebhookSdkInput"
 					}
 				}
 			},
@@ -8828,6 +9107,49 @@ const openapiDocument = {
 				],
 				"additionalProperties": false
 			},
+			"CompleteWebhookSdkInput": {
+				"type": "object",
+				"properties": {
+					"queue_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)$"
+					},
+					"delivery_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)$"
+					},
+					"lease_token": {
+						"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)$"
+					},
+					"duration_ms": {
+						"type": "integer",
+						"minimum": 0,
+						"maximum": 3e4
+					},
+					"mode": {
+						"type": "string",
+						"enum": ["sdk"]
+					},
+					"accepted": { "type": "boolean" },
+					"transport_error": {
+						"type": "string",
+						"enum": ["timeout", "io"]
+					}
+				},
+				"required": [
+					"queue_id",
+					"delivery_id",
+					"lease_token",
+					"duration_ms",
+					"mode",
+					"accepted"
+				],
+				"additionalProperties": false
+			},
 			"CompleteWebhookResponse": {
 				"type": "object",
 				"properties": {
@@ -8861,6 +9183,35 @@ 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": {
+							"completion_modes": {
+								"type": "array",
+								"items": {
+									"type": "string",
+									"enum": [
+										"http",
+										"exec",
+										"stdout",
+										"sdk"
+									]
+								}
+							},
+							"stream_protocols": {
+								"type": "array",
+								"items": {
+									"type": "string",
+									"enum": ["primitive.events.v1"]
+								}
+							}
+						},
+						"required": ["completion_modes", "stream_protocols"]
+					},
 					"id": {
 						"type": "string",
 						"format": "uuid"
@@ -12671,6 +13022,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,
@@ -15170,6 +15696,49 @@ const operationManifest = [
 						"write_succeeded"
 					],
 					"additionalProperties": false
+				},
+				{
+					"type": "object",
+					"properties": {
+						"queue_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)$"
+						},
+						"delivery_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)$"
+						},
+						"lease_token": {
+							"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)$"
+						},
+						"duration_ms": {
+							"type": "integer",
+							"minimum": 0,
+							"maximum": 3e4
+						},
+						"mode": {
+							"type": "string",
+							"enum": ["sdk"]
+						},
+						"accepted": { "type": "boolean" },
+						"transport_error": {
+							"type": "string",
+							"enum": ["timeout", "io"]
+						}
+					},
+					"required": [
+						"queue_id",
+						"delivery_id",
+						"lease_token",
+						"duration_ms",
+						"mode",
+						"accepted"
+					],
+					"additionalProperties": false
 				}
 			],
 			"discriminator": {
@@ -15177,7 +15746,8 @@ const operationManifest = [
 				"mapping": {
 					"http": "#/components/schemas/CompleteWebhookHttpInput",
 					"exec": "#/components/schemas/CompleteWebhookExecInput",
-					"stdout": "#/components/schemas/CompleteWebhookStdoutInput"
+					"stdout": "#/components/schemas/CompleteWebhookStdoutInput",
+					"sdk": "#/components/schemas/CompleteWebhookSdkInput"
 				}
 			}
 		},
@@ -15220,7 +15790,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",
@@ -15288,6 +15858,35 @@ 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": {
+						"completion_modes": {
+							"type": "array",
+							"items": {
+								"type": "string",
+								"enum": [
+									"http",
+									"exec",
+									"stdout",
+									"sdk"
+								]
+							}
+						},
+						"stream_protocols": {
+							"type": "array",
+							"items": {
+								"type": "string",
+								"enum": ["primitive.events.v1"]
+							}
+						}
+					},
+					"required": ["completion_modes", "stream_protocols"]
+				},
 				"id": {
 					"type": "string",
 					"format": "uuid"
@@ -15439,6 +16038,35 @@ 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": {
+							"completion_modes": {
+								"type": "array",
+								"items": {
+									"type": "string",
+									"enum": [
+										"http",
+										"exec",
+										"stdout",
+										"sdk"
+									]
+								}
+							},
+							"stream_protocols": {
+								"type": "array",
+								"items": {
+									"type": "string",
+									"enum": ["primitive.events.v1"]
+								}
+							}
+						},
+						"required": ["completion_modes", "stream_protocols"]
+					},
 					"id": {
 						"type": "string",
 						"format": "uuid"
@@ -15880,6 +16508,35 @@ 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": {
+						"completion_modes": {
+							"type": "array",
+							"items": {
+								"type": "string",
+								"enum": [
+									"http",
+									"exec",
+									"stdout",
+									"sdk"
+								]
+							}
+						},
+						"stream_protocols": {
+							"type": "array",
+							"items": {
+								"type": "string",
+								"enum": ["primitive.events.v1"]
+							}
+						}
+					},
+					"required": ["completion_modes", "stream_protocols"]
+				},
 				"id": {
 					"type": "string",
 					"format": "uuid"