@primitivedotdev/sdk 1.8.0 → 1.9.0

package/dist/{operations.generated-Bu20uPOw.js → operations.generated-03WHPOSm.js}

@@ -84,6 +84,10 @@ const openapiDocument = {
 		{
 			"name": "Functions",
 			"description": "Deploy JavaScript handlers that run on inbound mail. Each function\nis a single ESM module whose default export is an object with an\nasync `fetch(request, env)` method, in the shape of a Workers-style\nhandler. Primitive signs each delivery and forwards the\n`Primitive-Signature` header to the handler; verify the raw request\nbody with `PRIMITIVE_WEBHOOK_SECRET` before trusting the parsed event.\nThe `event` field is `email.received` for normal inbound mail, or a\nmachine-mail type (`email.bounced`, `email.tls_report`,\n`email.dmarc_report`, `email.dmarc_failure`) for bounces and reports;\nthe payload shape is otherwise identical. Code runs on\nPrimitive's edge runtime; there is no infrastructure to manage.\nSecrets land in `env` as encrypted bindings and are refreshed on\nevery redeploy.\n"
+		},
+		{
+			"name": "Registries",
+			"description": "The Agent Registry: ownable directories of agents, addressable by a\nregistry-scoped handle. A registry's publish policy (owner_only, request,\nor open) decides whether a publish lists immediately or pends owner\napproval. An agent is defined once with a globally unique,\nreachability-verified address, then published into any registry under a\nhandle. Discovery reads (list, resolve, get) are public for public\nregistries; managing a registry and moderating requests use the owner's\nAPI key.\n"
 		}
 	],
 	"paths": {
@@ -2555,7 +2559,316 @@ const openapiDocument = {
 				"403": { "$ref": "#/components/responses/Forbidden" },
 				"429": { "$ref": "#/components/responses/RateLimited" }
 			}
-		} }
+		} },
+		"/registries": {
+			"get": {
+				"operationId": "listRegistries",
+				"summary": "List the registries you own",
+				"tags": ["Registries"],
+				"responses": {
+					"200": {
+						"description": "Registries owned by the caller",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, { "properties": { "data": {
+							"type": "array",
+							"items": { "$ref": "#/components/schemas/Registry" }
+						} } }] } } }
+					},
+					"401": { "$ref": "#/components/responses/Unauthorized" }
+				}
+			},
+			"post": {
+				"operationId": "createRegistry",
+				"summary": "Create a registry",
+				"tags": ["Registries"],
+				"requestBody": {
+					"required": true,
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateRegistryInput" } } }
+				},
+				"responses": {
+					"201": {
+						"description": "Registry created",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, { "properties": { "data": {
+							"type": "object",
+							"properties": {
+								"id": {
+									"type": "string",
+									"format": "uuid"
+								},
+								"slug": { "type": "string" }
+							},
+							"required": ["id", "slug"]
+						} } }] } } }
+					},
+					"401": { "$ref": "#/components/responses/Unauthorized" },
+					"403": { "$ref": "#/components/responses/Forbidden" },
+					"409": { "$ref": "#/components/responses/Conflict" },
+					"422": { "$ref": "#/components/responses/ValidationError" }
+				}
+			}
+		},
+		"/registries/{slug}": {
+			"parameters": [{
+				"name": "slug",
+				"in": "path",
+				"required": true,
+				"schema": { "type": "string" },
+				"description": "The registry slug"
+			}],
+			"get": {
+				"operationId": "getRegistry",
+				"summary": "Get a public registry's metadata",
+				"tags": ["Registries"],
+				"security": [],
+				"responses": {
+					"200": {
+						"description": "Registry metadata",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, { "properties": { "data": { "$ref": "#/components/schemas/Registry" } } }] } } }
+					},
+					"404": { "$ref": "#/components/responses/NotFound" }
+				}
+			},
+			"patch": {
+				"operationId": "updateRegistry",
+				"summary": "Update a registry you own",
+				"tags": ["Registries"],
+				"requestBody": {
+					"required": true,
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateRegistryInput" } } }
+				},
+				"responses": {
+					"200": {
+						"description": "Registry updated",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, { "properties": { "data": {
+							"type": "object",
+							"properties": { "id": {
+								"type": "string",
+								"format": "uuid"
+							} },
+							"required": ["id"]
+						} } }] } } }
+					},
+					"401": { "$ref": "#/components/responses/Unauthorized" },
+					"403": { "$ref": "#/components/responses/Forbidden" },
+					"404": { "$ref": "#/components/responses/NotFound" },
+					"422": { "$ref": "#/components/responses/ValidationError" }
+				}
+			}
+		},
+		"/registries/{slug}/agents": {
+			"parameters": [{
+				"name": "slug",
+				"in": "path",
+				"required": true,
+				"schema": { "type": "string" }
+			}],
+			"get": {
+				"operationId": "listRegistryAgents",
+				"summary": "List agents in a registry",
+				"tags": ["Registries"],
+				"security": [],
+				"parameters": [{
+					"name": "limit",
+					"in": "query",
+					"required": false,
+					"schema": {
+						"type": "integer",
+						"minimum": 1,
+						"maximum": 200
+					}
+				}, {
+					"name": "cursor",
+					"in": "query",
+					"required": false,
+					"schema": { "type": "string" },
+					"description": "The address of the last agent from the previous page."
+				}],
+				"responses": { "200": {
+					"description": "Approved, reachable agents. Empty for an unknown or private registry.",
+					"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/ListEnvelope" }, { "properties": { "data": {
+						"type": "array",
+						"items": { "$ref": "#/components/schemas/RegistryAgent" }
+					} } }] } } }
+				} }
+			},
+			"post": {
+				"operationId": "publishAgent",
+				"summary": "Publish an agent into a registry",
+				"tags": ["Registries"],
+				"requestBody": {
+					"required": true,
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishAgentInput" } } }
+				},
+				"responses": {
+					"200": {
+						"description": "Idempotent replay of an existing publication",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, { "properties": { "data": { "$ref": "#/components/schemas/PublishAgentResult" } } }] } } }
+					},
+					"201": {
+						"description": "Published (approved) or request created (requested)",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, { "properties": { "data": { "$ref": "#/components/schemas/PublishAgentResult" } } }] } } }
+					},
+					"401": { "$ref": "#/components/responses/Unauthorized" },
+					"403": { "$ref": "#/components/responses/Forbidden" },
+					"404": { "$ref": "#/components/responses/NotFound" },
+					"409": { "$ref": "#/components/responses/Conflict" },
+					"422": { "$ref": "#/components/responses/ValidationError" }
+				}
+			}
+		},
+		"/registries/{slug}/agents/{handle}": {
+			"parameters": [{
+				"name": "slug",
+				"in": "path",
+				"required": true,
+				"schema": { "type": "string" }
+			}, {
+				"name": "handle",
+				"in": "path",
+				"required": true,
+				"schema": { "type": "string" }
+			}],
+			"get": {
+				"operationId": "resolveRegistryHandle",
+				"summary": "Resolve a registry handle to its agent",
+				"tags": ["Registries"],
+				"security": [],
+				"responses": {
+					"200": {
+						"description": "The agent listing under the handle",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, { "properties": { "data": { "$ref": "#/components/schemas/RegistryAgent" } } }] } } }
+					},
+					"404": { "$ref": "#/components/responses/NotFound" }
+				}
+			},
+			"delete": {
+				"operationId": "unpublishAgent",
+				"summary": "Unpublish an agent from a registry",
+				"tags": ["Registries"],
+				"responses": {
+					"200": { "$ref": "#/components/responses/Deleted" },
+					"401": { "$ref": "#/components/responses/Unauthorized" },
+					"404": { "$ref": "#/components/responses/NotFound" }
+				}
+			}
+		},
+		"/registries/{slug}/requests": {
+			"parameters": [{
+				"name": "slug",
+				"in": "path",
+				"required": true,
+				"schema": { "type": "string" }
+			}],
+			"get": {
+				"operationId": "listRegistryRequests",
+				"summary": "List pending publication requests",
+				"tags": ["Registries"],
+				"parameters": [{
+					"name": "limit",
+					"in": "query",
+					"required": false,
+					"schema": {
+						"type": "integer",
+						"minimum": 1,
+						"maximum": 200
+					}
+				}],
+				"responses": {
+					"200": {
+						"description": "Pending requests for a registry you own",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, { "properties": { "data": {
+							"type": "array",
+							"items": { "$ref": "#/components/schemas/RegistryRequest" }
+						} } }] } } }
+					},
+					"401": { "$ref": "#/components/responses/Unauthorized" },
+					"404": { "$ref": "#/components/responses/NotFound" }
+				}
+			}
+		},
+		"/registries/{slug}/requests/{id}": {
+			"parameters": [{
+				"name": "slug",
+				"in": "path",
+				"required": true,
+				"schema": { "type": "string" }
+			}, { "$ref": "#/components/parameters/ResourceId" }],
+			"post": {
+				"operationId": "decideRegistryRequest",
+				"summary": "Approve or reject a publication request",
+				"tags": ["Registries"],
+				"requestBody": {
+					"required": true,
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/DecideRegistryRequestInput" } } }
+				},
+				"responses": {
+					"200": {
+						"description": "Decision applied",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, { "properties": { "data": {
+							"type": "object",
+							"properties": { "status": {
+								"type": "string",
+								"enum": ["approved", "rejected"]
+							} },
+							"required": ["status"]
+						} } }] } } }
+					},
+					"401": { "$ref": "#/components/responses/Unauthorized" },
+					"404": { "$ref": "#/components/responses/NotFound" },
+					"409": { "$ref": "#/components/responses/Conflict" },
+					"422": { "$ref": "#/components/responses/ValidationError" }
+				}
+			}
+		},
+		"/agents": { "post": {
+			"operationId": "defineAgent",
+			"summary": "Define an agent identity",
+			"tags": ["Registries"],
+			"requestBody": {
+				"required": true,
+				"content": { "application/json": { "schema": { "$ref": "#/components/schemas/DefineAgentInput" } } }
+			},
+			"responses": {
+				"201": {
+					"description": "Agent defined",
+					"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, { "properties": { "data": {
+						"type": "object",
+						"properties": {
+							"id": {
+								"type": "string",
+								"format": "uuid"
+							},
+							"address": { "type": "string" }
+						},
+						"required": ["id", "address"]
+					} } }] } } }
+				},
+				"401": { "$ref": "#/components/responses/Unauthorized" },
+				"409": { "$ref": "#/components/responses/Conflict" },
+				"422": { "$ref": "#/components/responses/ValidationError" }
+			}
+		} },
+		"/agents/{address}": {
+			"parameters": [{
+				"name": "address",
+				"in": "path",
+				"required": true,
+				"schema": { "type": "string" },
+				"description": "The agent's email address (URL-encoded)."
+			}],
+			"get": {
+				"operationId": "getAgent",
+				"summary": "Get an agent's public profile by address",
+				"tags": ["Registries"],
+				"security": [],
+				"responses": {
+					"200": {
+						"description": "The agent's public profile",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, { "properties": { "data": { "$ref": "#/components/schemas/RegistryAgent" } } }] } } }
+					},
+					"404": { "$ref": "#/components/responses/NotFound" }
+				}
+			}
+		}
 	},
 	"components": {
 		"securitySchemes": {
@@ -2774,57 +3087,255 @@ const openapiDocument = {
 			}
 		},
 		"schemas": {
-			"RegisterPayoutAddressInput": {
+			"PublishPolicy": {
+				"type": "string",
+				"enum": [
+					"owner_only",
+					"request",
+					"open"
+				],
+				"description": "Who may publish into a registry. owner_only: only the registry owner.\nrequest: anyone may request and the owner approves. open: anyone may\npublish and it lists immediately (no approval step).\n"
+			},
+			"Registry": {
 				"type": "object",
-				"additionalProperties": false,
 				"properties": {
-					"address": {
-						"type": "string",
-						"pattern": "^0x[0-9a-fA-F]{40}$",
-						"description": "The payout address (your signer's own EVM address), 0x-prefixed."
-					},
-					"network": {
-						"type": "string",
-						"enum": ["base", "base-sepolia"],
-						"description": "The chain the address receives on."
-					},
-					"signature": {
+					"id": {
 						"type": "string",
-						"pattern": "^0x[0-9a-fA-F]+$",
-						"description": "A `personal_sign` signature over the org-bound message produced by\nthe SDK helper `buildPayoutRegistrationMessage`. Recovered and\nchecked against `address`; the org id is bound into the signed bytes.\n"
+						"format": "uuid"
 					},
-					"issued_at": {
-						"type": "string",
-						"format": "date-time",
-						"description": "ISO-8601 timestamp embedded in the signed message. Must be within a\nshort freshness window (about 10 minutes) of server time.\n"
+					"slug": { "type": "string" },
+					"name": { "type": "string" },
+					"description": { "type": ["string", "null"] },
+					"is_public": { "type": "boolean" },
+					"publish_policy": { "$ref": "#/components/schemas/PublishPolicy" }
+				},
+				"required": [
+					"id",
+					"slug",
+					"name",
+					"description",
+					"is_public",
+					"publish_policy"
+				]
+			},
+			"RegistryAgent": {
+				"type": "object",
+				"description": "An agent's public directory profile.",
+				"properties": {
+					"address": { "type": "string" },
+					"display_name": { "type": "string" },
+					"title": { "type": ["string", "null"] },
+					"description": { "type": ["string", "null"] },
+					"tags": {
+						"type": "array",
+						"items": { "type": "string" }
 					},
-					"label": {
-						"type": "string",
-						"maxLength": 80,
-						"description": "Optional human-readable label."
+					"handle": {
+						"type": ["string", "null"],
+						"description": "The registry-scoped name. Null on the global by-address read."
 					}
 				},
 				"required": [
 					"address",
-					"network",
-					"signature",
-					"issued_at"
+					"display_name",
+					"title",
+					"description",
+					"tags",
+					"handle"
 				]
 			},
-			"X402PayoutAddress": {
+			"RegistryRequest": {
 				"type": "object",
+				"description": "A pending publication request, as the registry owner sees it.",
 				"properties": {
 					"id": {
 						"type": "string",
 						"format": "uuid"
 					},
-					"address": {
+					"address": { "type": "string" },
+					"display_name": { "type": "string" },
+					"handle": { "type": ["string", "null"] },
+					"requested_at": {
 						"type": "string",
-						"description": "The checksummed payout address."
+						"format": "date-time"
+					}
+				},
+				"required": [
+					"id",
+					"address",
+					"display_name",
+					"handle",
+					"requested_at"
+				]
+			},
+			"CreateRegistryInput": {
+				"type": "object",
+				"properties": {
+					"slug": {
+						"type": "string",
+						"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$",
+						"description": "Lowercase slug, unique across registries."
 					},
-					"network": {
+					"name": {
 						"type": "string",
-						"enum": ["base", "base-sepolia"]
+						"minLength": 1,
+						"maxLength": 120
+					},
+					"description": {
+						"type": ["string", "null"],
+						"maxLength": 2e3
+					},
+					"is_public": { "type": "boolean" },
+					"publish_policy": { "$ref": "#/components/schemas/PublishPolicy" }
+				},
+				"required": ["slug", "name"]
+			},
+			"UpdateRegistryInput": {
+				"type": "object",
+				"minProperties": 1,
+				"properties": {
+					"name": {
+						"type": "string",
+						"minLength": 1,
+						"maxLength": 120
+					},
+					"description": {
+						"type": ["string", "null"],
+						"maxLength": 2e3
+					},
+					"is_public": { "type": "boolean" },
+					"publish_policy": { "$ref": "#/components/schemas/PublishPolicy" }
+				}
+			},
+			"DefineAgentInput": {
+				"type": "object",
+				"properties": {
+					"address": {
+						"type": "string",
+						"description": "The agent's globally unique email address; must route to the endpoint."
+					},
+					"endpoint_id": {
+						"type": "string",
+						"format": "uuid"
+					},
+					"display_name": {
+						"type": "string",
+						"minLength": 1,
+						"maxLength": 120
+					},
+					"title": {
+						"type": ["string", "null"],
+						"maxLength": 120
+					},
+					"description": {
+						"type": ["string", "null"],
+						"maxLength": 2e3
+					},
+					"tags": {
+						"type": "array",
+						"items": {
+							"type": "string",
+							"maxLength": 40
+						},
+						"maxItems": 20
+					}
+				},
+				"required": [
+					"address",
+					"endpoint_id",
+					"display_name"
+				]
+			},
+			"PublishAgentInput": {
+				"type": "object",
+				"properties": {
+					"address": { "type": "string" },
+					"handle": {
+						"type": "string",
+						"description": "The registry-scoped name to list the agent under."
+					}
+				},
+				"required": ["address", "handle"]
+			},
+			"PublishAgentResult": {
+				"type": "object",
+				"properties": {
+					"status": {
+						"type": "string",
+						"enum": ["approved", "requested"],
+						"description": "approved lists immediately; requested pends owner approval."
+					},
+					"handle": { "type": "string" },
+					"idempotent_replay": {
+						"type": "boolean",
+						"description": "True when the publish matched an existing identical publication."
+					}
+				},
+				"required": [
+					"status",
+					"handle",
+					"idempotent_replay"
+				]
+			},
+			"DecideRegistryRequestInput": {
+				"type": "object",
+				"properties": { "decision": {
+					"type": "string",
+					"enum": ["approved", "rejected"]
+				} },
+				"required": ["decision"]
+			},
+			"RegisterPayoutAddressInput": {
+				"type": "object",
+				"additionalProperties": false,
+				"properties": {
+					"address": {
+						"type": "string",
+						"pattern": "^0x[0-9a-fA-F]{40}$",
+						"description": "The payout address (your signer's own EVM address), 0x-prefixed."
+					},
+					"network": {
+						"type": "string",
+						"enum": ["base", "base-sepolia"],
+						"description": "The chain the address receives on."
+					},
+					"signature": {
+						"type": "string",
+						"pattern": "^0x[0-9a-fA-F]+$",
+						"description": "A `personal_sign` signature over the org-bound message produced by\nthe SDK helper `buildPayoutRegistrationMessage`. Recovered and\nchecked against `address`; the org id is bound into the signed bytes.\n"
+					},
+					"issued_at": {
+						"type": "string",
+						"format": "date-time",
+						"description": "ISO-8601 timestamp embedded in the signed message. Must be within a\nshort freshness window (about 10 minutes) of server time.\n"
+					},
+					"label": {
+						"type": "string",
+						"maxLength": 80,
+						"description": "Optional human-readable label."
+					}
+				},
+				"required": [
+					"address",
+					"network",
+					"signature",
+					"issued_at"
+				]
+			},
+			"X402PayoutAddress": {
+				"type": "object",
+				"properties": {
+					"id": {
+						"type": "string",
+						"format": "uuid"
+					},
+					"address": {
+						"type": "string",
+						"description": "The checksummed payout address."
+					},
+					"network": {
+						"type": "string",
+						"enum": ["base", "base-sepolia"]
 					},
 					"label": { "type": ["string", "null"] },
 					"is_default": {
@@ -13744,6 +14255,642 @@ const operationManifest = [
 		"tag": "Payments",
 		"tagCommand": "payments"
 	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": true,
+		"command": "create-registry",
+		"description": null,
+		"hasJsonBody": true,
+		"method": "POST",
+		"operationId": "createRegistry",
+		"path": "/registries",
+		"pathParams": [],
+		"queryParams": [],
+		"requestSchema": {
+			"type": "object",
+			"properties": {
+				"slug": {
+					"type": "string",
+					"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$",
+					"description": "Lowercase slug, unique across registries."
+				},
+				"name": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 120
+				},
+				"description": {
+					"type": ["string", "null"],
+					"maxLength": 2e3
+				},
+				"is_public": { "type": "boolean" },
+				"publish_policy": {
+					"type": "string",
+					"enum": [
+						"owner_only",
+						"request",
+						"open"
+					],
+					"description": "Who may publish into a registry. owner_only: only the registry owner.\nrequest: anyone may request and the owner approves. open: anyone may\npublish and it lists immediately (no approval step).\n"
+				}
+			},
+			"required": ["slug", "name"]
+		},
+		"responseSchema": {
+			"type": "object",
+			"properties": {
+				"id": {
+					"type": "string",
+					"format": "uuid"
+				},
+				"slug": { "type": "string" }
+			},
+			"required": ["id", "slug"]
+		},
+		"sdkName": "createRegistry",
+		"summary": "Create a registry",
+		"tag": "Registries",
+		"tagCommand": "registries"
+	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": true,
+		"command": "decide-registry-request",
+		"description": null,
+		"hasJsonBody": true,
+		"method": "POST",
+		"operationId": "decideRegistryRequest",
+		"path": "/registries/{slug}/requests/{id}",
+		"pathParams": [{
+			"description": null,
+			"enum": null,
+			"name": "slug",
+			"required": true,
+			"type": "string"
+		}, {
+			"description": "Resource UUID",
+			"enum": null,
+			"name": "id",
+			"required": true,
+			"type": "string"
+		}],
+		"queryParams": [],
+		"requestSchema": {
+			"type": "object",
+			"properties": { "decision": {
+				"type": "string",
+				"enum": ["approved", "rejected"]
+			} },
+			"required": ["decision"]
+		},
+		"responseSchema": {
+			"type": "object",
+			"properties": { "status": {
+				"type": "string",
+				"enum": ["approved", "rejected"]
+			} },
+			"required": ["status"]
+		},
+		"sdkName": "decideRegistryRequest",
+		"summary": "Approve or reject a publication request",
+		"tag": "Registries",
+		"tagCommand": "registries"
+	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": true,
+		"command": "define-agent",
+		"description": null,
+		"hasJsonBody": true,
+		"method": "POST",
+		"operationId": "defineAgent",
+		"path": "/agents",
+		"pathParams": [],
+		"queryParams": [],
+		"requestSchema": {
+			"type": "object",
+			"properties": {
+				"address": {
+					"type": "string",
+					"description": "The agent's globally unique email address; must route to the endpoint."
+				},
+				"endpoint_id": {
+					"type": "string",
+					"format": "uuid"
+				},
+				"display_name": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 120
+				},
+				"title": {
+					"type": ["string", "null"],
+					"maxLength": 120
+				},
+				"description": {
+					"type": ["string", "null"],
+					"maxLength": 2e3
+				},
+				"tags": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"maxLength": 40
+					},
+					"maxItems": 20
+				}
+			},
+			"required": [
+				"address",
+				"endpoint_id",
+				"display_name"
+			]
+		},
+		"responseSchema": {
+			"type": "object",
+			"properties": {
+				"id": {
+					"type": "string",
+					"format": "uuid"
+				},
+				"address": { "type": "string" }
+			},
+			"required": ["id", "address"]
+		},
+		"sdkName": "defineAgent",
+		"summary": "Define an agent identity",
+		"tag": "Registries",
+		"tagCommand": "registries"
+	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": false,
+		"command": "get-agent",
+		"description": null,
+		"hasJsonBody": false,
+		"method": "GET",
+		"operationId": "getAgent",
+		"path": "/agents/{address}",
+		"pathParams": [{
+			"description": "The agent's email address (URL-encoded).",
+			"enum": null,
+			"name": "address",
+			"required": true,
+			"type": "string"
+		}],
+		"queryParams": [],
+		"requestSchema": null,
+		"responseSchema": {
+			"type": "object",
+			"description": "An agent's public directory profile.",
+			"properties": {
+				"address": { "type": "string" },
+				"display_name": { "type": "string" },
+				"title": { "type": ["string", "null"] },
+				"description": { "type": ["string", "null"] },
+				"tags": {
+					"type": "array",
+					"items": { "type": "string" }
+				},
+				"handle": {
+					"type": ["string", "null"],
+					"description": "The registry-scoped name. Null on the global by-address read."
+				}
+			},
+			"required": [
+				"address",
+				"display_name",
+				"title",
+				"description",
+				"tags",
+				"handle"
+			]
+		},
+		"sdkName": "getAgent",
+		"summary": "Get an agent's public profile by address",
+		"tag": "Registries",
+		"tagCommand": "registries"
+	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": false,
+		"command": "get-registry",
+		"description": null,
+		"hasJsonBody": false,
+		"method": "GET",
+		"operationId": "getRegistry",
+		"path": "/registries/{slug}",
+		"pathParams": [{
+			"description": "The registry slug",
+			"enum": null,
+			"name": "slug",
+			"required": true,
+			"type": "string"
+		}],
+		"queryParams": [],
+		"requestSchema": null,
+		"responseSchema": {
+			"type": "object",
+			"properties": {
+				"id": {
+					"type": "string",
+					"format": "uuid"
+				},
+				"slug": { "type": "string" },
+				"name": { "type": "string" },
+				"description": { "type": ["string", "null"] },
+				"is_public": { "type": "boolean" },
+				"publish_policy": {
+					"type": "string",
+					"enum": [
+						"owner_only",
+						"request",
+						"open"
+					],
+					"description": "Who may publish into a registry. owner_only: only the registry owner.\nrequest: anyone may request and the owner approves. open: anyone may\npublish and it lists immediately (no approval step).\n"
+				}
+			},
+			"required": [
+				"id",
+				"slug",
+				"name",
+				"description",
+				"is_public",
+				"publish_policy"
+			]
+		},
+		"sdkName": "getRegistry",
+		"summary": "Get a public registry's metadata",
+		"tag": "Registries",
+		"tagCommand": "registries"
+	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": false,
+		"command": "list-registries",
+		"description": null,
+		"hasJsonBody": false,
+		"method": "GET",
+		"operationId": "listRegistries",
+		"path": "/registries",
+		"pathParams": [],
+		"queryParams": [],
+		"requestSchema": null,
+		"responseSchema": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"properties": {
+					"id": {
+						"type": "string",
+						"format": "uuid"
+					},
+					"slug": { "type": "string" },
+					"name": { "type": "string" },
+					"description": { "type": ["string", "null"] },
+					"is_public": { "type": "boolean" },
+					"publish_policy": {
+						"type": "string",
+						"enum": [
+							"owner_only",
+							"request",
+							"open"
+						],
+						"description": "Who may publish into a registry. owner_only: only the registry owner.\nrequest: anyone may request and the owner approves. open: anyone may\npublish and it lists immediately (no approval step).\n"
+					}
+				},
+				"required": [
+					"id",
+					"slug",
+					"name",
+					"description",
+					"is_public",
+					"publish_policy"
+				]
+			}
+		},
+		"sdkName": "listRegistries",
+		"summary": "List the registries you own",
+		"tag": "Registries",
+		"tagCommand": "registries"
+	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": false,
+		"command": "list-registry-agents",
+		"description": null,
+		"hasJsonBody": false,
+		"method": "GET",
+		"operationId": "listRegistryAgents",
+		"path": "/registries/{slug}/agents",
+		"pathParams": [{
+			"description": null,
+			"enum": null,
+			"name": "slug",
+			"required": true,
+			"type": "string"
+		}],
+		"queryParams": [{
+			"description": null,
+			"enum": null,
+			"maximum": 200,
+			"minimum": 1,
+			"name": "limit",
+			"required": false,
+			"type": "integer"
+		}, {
+			"description": "The address of the last agent from the previous page.",
+			"enum": null,
+			"name": "cursor",
+			"required": false,
+			"type": "string"
+		}],
+		"requestSchema": null,
+		"responseSchema": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"description": "An agent's public directory profile.",
+				"properties": {
+					"address": { "type": "string" },
+					"display_name": { "type": "string" },
+					"title": { "type": ["string", "null"] },
+					"description": { "type": ["string", "null"] },
+					"tags": {
+						"type": "array",
+						"items": { "type": "string" }
+					},
+					"handle": {
+						"type": ["string", "null"],
+						"description": "The registry-scoped name. Null on the global by-address read."
+					}
+				},
+				"required": [
+					"address",
+					"display_name",
+					"title",
+					"description",
+					"tags",
+					"handle"
+				]
+			}
+		},
+		"sdkName": "listRegistryAgents",
+		"summary": "List agents in a registry",
+		"tag": "Registries",
+		"tagCommand": "registries"
+	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": false,
+		"command": "list-registry-requests",
+		"description": null,
+		"hasJsonBody": false,
+		"method": "GET",
+		"operationId": "listRegistryRequests",
+		"path": "/registries/{slug}/requests",
+		"pathParams": [{
+			"description": null,
+			"enum": null,
+			"name": "slug",
+			"required": true,
+			"type": "string"
+		}],
+		"queryParams": [{
+			"description": null,
+			"enum": null,
+			"maximum": 200,
+			"minimum": 1,
+			"name": "limit",
+			"required": false,
+			"type": "integer"
+		}],
+		"requestSchema": null,
+		"responseSchema": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"description": "A pending publication request, as the registry owner sees it.",
+				"properties": {
+					"id": {
+						"type": "string",
+						"format": "uuid"
+					},
+					"address": { "type": "string" },
+					"display_name": { "type": "string" },
+					"handle": { "type": ["string", "null"] },
+					"requested_at": {
+						"type": "string",
+						"format": "date-time"
+					}
+				},
+				"required": [
+					"id",
+					"address",
+					"display_name",
+					"handle",
+					"requested_at"
+				]
+			}
+		},
+		"sdkName": "listRegistryRequests",
+		"summary": "List pending publication requests",
+		"tag": "Registries",
+		"tagCommand": "registries"
+	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": true,
+		"command": "publish-agent",
+		"description": null,
+		"hasJsonBody": true,
+		"method": "POST",
+		"operationId": "publishAgent",
+		"path": "/registries/{slug}/agents",
+		"pathParams": [{
+			"description": null,
+			"enum": null,
+			"name": "slug",
+			"required": true,
+			"type": "string"
+		}],
+		"queryParams": [],
+		"requestSchema": {
+			"type": "object",
+			"properties": {
+				"address": { "type": "string" },
+				"handle": {
+					"type": "string",
+					"description": "The registry-scoped name to list the agent under."
+				}
+			},
+			"required": ["address", "handle"]
+		},
+		"responseSchema": {
+			"type": "object",
+			"properties": {
+				"status": {
+					"type": "string",
+					"enum": ["approved", "requested"],
+					"description": "approved lists immediately; requested pends owner approval."
+				},
+				"handle": { "type": "string" },
+				"idempotent_replay": {
+					"type": "boolean",
+					"description": "True when the publish matched an existing identical publication."
+				}
+			},
+			"required": [
+				"status",
+				"handle",
+				"idempotent_replay"
+			]
+		},
+		"sdkName": "publishAgent",
+		"summary": "Publish an agent into a registry",
+		"tag": "Registries",
+		"tagCommand": "registries"
+	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": false,
+		"command": "resolve-registry-handle",
+		"description": null,
+		"hasJsonBody": false,
+		"method": "GET",
+		"operationId": "resolveRegistryHandle",
+		"path": "/registries/{slug}/agents/{handle}",
+		"pathParams": [{
+			"description": null,
+			"enum": null,
+			"name": "slug",
+			"required": true,
+			"type": "string"
+		}, {
+			"description": null,
+			"enum": null,
+			"name": "handle",
+			"required": true,
+			"type": "string"
+		}],
+		"queryParams": [],
+		"requestSchema": null,
+		"responseSchema": {
+			"type": "object",
+			"description": "An agent's public directory profile.",
+			"properties": {
+				"address": { "type": "string" },
+				"display_name": { "type": "string" },
+				"title": { "type": ["string", "null"] },
+				"description": { "type": ["string", "null"] },
+				"tags": {
+					"type": "array",
+					"items": { "type": "string" }
+				},
+				"handle": {
+					"type": ["string", "null"],
+					"description": "The registry-scoped name. Null on the global by-address read."
+				}
+			},
+			"required": [
+				"address",
+				"display_name",
+				"title",
+				"description",
+				"tags",
+				"handle"
+			]
+		},
+		"sdkName": "resolveRegistryHandle",
+		"summary": "Resolve a registry handle to its agent",
+		"tag": "Registries",
+		"tagCommand": "registries"
+	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": false,
+		"command": "unpublish-agent",
+		"description": null,
+		"hasJsonBody": false,
+		"method": "DELETE",
+		"operationId": "unpublishAgent",
+		"path": "/registries/{slug}/agents/{handle}",
+		"pathParams": [{
+			"description": null,
+			"enum": null,
+			"name": "slug",
+			"required": true,
+			"type": "string"
+		}, {
+			"description": null,
+			"enum": null,
+			"name": "handle",
+			"required": true,
+			"type": "string"
+		}],
+		"queryParams": [],
+		"requestSchema": null,
+		"responseSchema": null,
+		"sdkName": "unpublishAgent",
+		"summary": "Unpublish an agent from a registry",
+		"tag": "Registries",
+		"tagCommand": "registries"
+	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": true,
+		"command": "update-registry",
+		"description": null,
+		"hasJsonBody": true,
+		"method": "PATCH",
+		"operationId": "updateRegistry",
+		"path": "/registries/{slug}",
+		"pathParams": [{
+			"description": "The registry slug",
+			"enum": null,
+			"name": "slug",
+			"required": true,
+			"type": "string"
+		}],
+		"queryParams": [],
+		"requestSchema": {
+			"type": "object",
+			"minProperties": 1,
+			"properties": {
+				"name": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 120
+				},
+				"description": {
+					"type": ["string", "null"],
+					"maxLength": 2e3
+				},
+				"is_public": { "type": "boolean" },
+				"publish_policy": {
+					"type": "string",
+					"enum": [
+						"owner_only",
+						"request",
+						"open"
+					],
+					"description": "Who may publish into a registry. owner_only: only the registry owner.\nrequest: anyone may request and the owner approves. open: anyone may\npublish and it lists immediately (no approval step).\n"
+				}
+			}
+		},
+		"responseSchema": {
+			"type": "object",
+			"properties": { "id": {
+				"type": "string",
+				"format": "uuid"
+			} },
+			"required": ["id"]
+		},
+		"sdkName": "updateRegistry",
+		"summary": "Update a registry you own",
+		"tag": "Registries",
+		"tagCommand": "registries"
+	},
 	{
 		"binaryResponse": false,
 		"bodyRequired": true,