@primitivedotdev/cli 1.3.0 → 1.5.0

package/dist/oclif/index.js

@@ -3,9 +3,9 @@ import { Args, Command, Errors, Flags, ux } from "@oclif/core";
 import { chmodSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, readdirSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
 import { randomUUID } from "node:crypto";
 import path, { basename, dirname, join, relative, resolve, sep } from "node:path";
-import { hostname } from "node:os";
 import process$1 from "node:process";
 import { createInterface } from "node:readline/promises";
+import { hostname } from "node:os";
 import { spawn } from "node:child_process";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
@@ -32,12 +32,14 @@ var sdk_gen_exports = /* @__PURE__ */ __exportAll({
 	createFilter: () => createFilter,
 	createFunction: () => createFunction,
 	createFunctionSecret: () => createFunctionSecret,
+	createOrgSecret: () => createOrgSecret,
 	deleteDomain: () => deleteDomain,
 	deleteEmail: () => deleteEmail,
 	deleteEndpoint: () => deleteEndpoint,
 	deleteFilter: () => deleteFilter,
 	deleteFunction: () => deleteFunction,
 	deleteFunctionSecret: () => deleteFunctionSecret,
+	deleteOrgSecret: () => deleteOrgSecret,
 	discardEmailContent: () => discardEmailContent,
 	downloadAttachments: () => downloadAttachments,
 	downloadDomainZoneFile: () => downloadDomainZoneFile,
@@ -63,6 +65,7 @@ var sdk_gen_exports = /* @__PURE__ */ __exportAll({
 	listFunctionLogs: () => listFunctionLogs,
 	listFunctionSecrets: () => listFunctionSecrets,
 	listFunctions: () => listFunctions,
+	listOrgSecrets: () => listOrgSecrets,
 	listSentEmails: () => listSentEmails,
 	pollCliLogin: () => pollCliLogin,
 	replayDelivery: () => replayDelivery,
@@ -76,6 +79,7 @@ var sdk_gen_exports = /* @__PURE__ */ __exportAll({
 	sendEmail: () => sendEmail,
 	setFunctionRoute: () => setFunctionRoute,
 	setFunctionSecret: () => setFunctionSecret,
+	setOrgSecret: () => setOrgSecret,
 	startAgentClaim: () => startAgentClaim,
 	startAgentSignup: () => startAgentSignup,
 	startCliLogin: () => startCliLogin,
@@ -1194,10 +1198,12 @@ const listFunctions = (options) => (options?.client ?? client).get({
 * each delivery and forwards the `Primitive-Signature` header to
 * the handler. Verify the raw request body with
 * `PRIMITIVE_WEBHOOK_SECRET` before parsing JSON; after verification
-* the request body parses to an `email.received` event (see
-* `EmailReceivedEvent` and the Webhook payload section for the full
-* schema). Code is bundled before being uploaded; ship a single
-* self-contained file rather than relying on external imports.
+* the request body parses to a webhook event whose `event` field is
+* `email.received` for normal inbound mail, or a machine-mail type
+* (`email.bounced`, `email.tls_report`, `email.dmarc_report`,
+* `email.dmarc_failure`) for bounces and reports. Code is bundled
+* before being uploaded; ship a single self-contained file rather
+* than relying on external imports.
 *
 * **Code limits.** `code` is capped at 1 MiB UTF-8. `sourceMap`
 * (optional) is capped at 5 MiB UTF-8, stored with each deployment
@@ -1515,6 +1521,85 @@ const setFunctionSecret = (options) => (options.client ?? client).put({
 	}
 });
 /**
+* List org-level (global) secrets
+*
+* Returns metadata for every org-level secret. Org secrets apply
+* to every function in the org and are read as `env.<KEY>` in
+* handlers. **Values are never returned.** Secret writes are
+* write-only. A function-level secret of the same name overrides
+* the org-level value for that function.
+*
+*/
+const listOrgSecrets = (options) => (options?.client ?? client).get({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/org/secrets",
+	...options
+});
+/**
+* Create or update an org secret
+*
+* Idempotent insert-or-update keyed on `(org_id, key)`. Returns
+* 201 the first time the key is set, 200 on subsequent updates.
+* Values are encrypted at rest. A changed value lands in a
+* function only on that function's next deploy.
+*
+* Keys must match `^[A-Z_][A-Z0-9_]*$` (uppercase letters,
+* digits, underscores; first character is a letter or
+* underscore). Values are at most 4096 UTF-8 bytes. System-
+* managed keys are reserved and rejected.
+*
+*/
+const createOrgSecret = (options) => (options.client ?? client).post({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/org/secrets",
+	...options,
+	headers: {
+		...options.body !== void 0 && { "Content-Type": "application/json" },
+		...options.headers
+	}
+});
+/**
+* Delete an org secret
+*
+* Removes the org secret. Functions keep the previous value until
+* each is redeployed. Returns 404 if the key did not exist.
+*
+*/
+const deleteOrgSecret = (options) => (options.client ?? client).delete({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/org/secrets/{key}",
+	...options
+});
+/**
+* Set an org secret by key
+*
+* Path-keyed companion to `POST /org/secrets`. Idempotent:
+* returns 201 the first time the key is set, 200 on subsequent
+* updates. Same validation and write-only guarantees as POST.
+*
+*/
+const setOrgSecret = (options) => (options.client ?? client).put({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/org/secrets/{key}",
+	...options,
+	headers: {
+		...options.body !== void 0 && { "Content-Type": "application/json" },
+		...options.headers
+	}
+});
+/**
 * List a function's execution logs
 *
 * Returns the most recent `function_logs` rows for the function,
@@ -1618,7 +1703,7 @@ 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\n`email.received` event (see `EmailReceivedEvent` and the Webhook\npayload section for the full schema). 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"
+			"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"
 		}
 	],
 	"paths": {
@@ -2390,6 +2475,25 @@ const openapiDocument = {
 						"format": "date-time"
 					},
 					"description": "Filter emails created on or before this timestamp"
+				},
+				{
+					"name": "since",
+					"in": "query",
+					"schema": {
+						"type": "string",
+						"maxLength": 200
+					},
+					"description": "Forward-tail cursor. Returns rows that became visible AFTER this\ncursor, oldest-first, so a caller can stream new inbound mail by\nre-passing the cursor from each response. Mutually exclusive with\n`cursor` (which pages history newest-first). Pass the `meta.cursor`\nfrom the previous `since` response; an empty page means caught up.\n"
+				},
+				{
+					"name": "wait",
+					"in": "query",
+					"schema": {
+						"type": "integer",
+						"minimum": 0,
+						"maximum": 30
+					},
+					"description": "Long-poll: hold the request up to this many seconds waiting for new\nmail past `since`, returning as soon as any arrives (or an empty\npage when the wait elapses). Requires `since`. Omitted means no wait\n(returns immediately); the server treats an absent value as 0. NOT\ngiven an OpenAPI `default` on purpose: a default makes some\ngenerators (e.g. openapi-python-client) send `wait=0` on every call,\nwhich then fails the `wait` requires `since` check for plain history\nlistings.\n"
 				}
 			],
 			"responses": {
@@ -3329,7 +3433,7 @@ const openapiDocument = {
 			"post": {
 				"operationId": "createFunction",
 				"summary": "Deploy a function",
-				"description": "Creates and deploys a new function. The handler must be a single\nESM module whose default export is an object with an async\n`fetch(request, env)` method (Workers-style). Primitive signs\neach delivery and forwards the `Primitive-Signature` header to\nthe handler. Verify the raw request body with\n`PRIMITIVE_WEBHOOK_SECRET` before parsing JSON; after verification\nthe request body parses to an `email.received` event (see\n`EmailReceivedEvent` and the Webhook payload section for the full\nschema). Code is bundled before being uploaded; ship a single\nself-contained file rather than relying on external imports.\n\n**Code limits.** `code` is capped at 1 MiB UTF-8. `sourceMap`\n(optional) is capped at 5 MiB UTF-8, stored with each deployment\nattempt, and sent to the runtime so stack traces can resolve to\noriginal source files.\n\n**Routing.** On successful deploy, the function code is live\nin the runtime, but inbound mail will not reach it until at\nleast one route is bound. Routes are managed from the Primitive\ndashboard. A `deploy_status` of `deployed` means the script is\ninstalled, not that the function is receiving mail. The\ninternal runtime URL is not returned by the API and is not a\ncustomer-facing integration surface.\n\n**Secrets.** New functions ship with the managed secrets\n(`PRIMITIVE_WEBHOOK_SECRET`, `PRIMITIVE_API_KEY`,\n`PRIMITIVE_API_BASE_URL`) already bound. Add user-set secrets via\n`POST /functions/{id}/secrets`; secret writes only land in the\nrunning handler on the next redeploy.\n",
+				"description": "Creates and deploys a new function. The handler must be a single\nESM module whose default export is an object with an async\n`fetch(request, env)` method (Workers-style). Primitive signs\neach delivery and forwards the `Primitive-Signature` header to\nthe handler. Verify the raw request body with\n`PRIMITIVE_WEBHOOK_SECRET` before parsing JSON; after verification\nthe request body parses to a webhook event whose `event` field is\n`email.received` for normal inbound mail, or a machine-mail type\n(`email.bounced`, `email.tls_report`, `email.dmarc_report`,\n`email.dmarc_failure`) for bounces and reports. Code is bundled\nbefore being uploaded; ship a single self-contained file rather\nthan relying on external imports.\n\n**Code limits.** `code` is capped at 1 MiB UTF-8. `sourceMap`\n(optional) is capped at 5 MiB UTF-8, stored with each deployment\nattempt, and sent to the runtime so stack traces can resolve to\noriginal source files.\n\n**Routing.** On successful deploy, the function code is live\nin the runtime, but inbound mail will not reach it until at\nleast one route is bound. Routes are managed from the Primitive\ndashboard. A `deploy_status` of `deployed` means the script is\ninstalled, not that the function is receiving mail. The\ninternal runtime URL is not returned by the API and is not a\ncustomer-facing integration surface.\n\n**Secrets.** New functions ship with the managed secrets\n(`PRIMITIVE_WEBHOOK_SECRET`, `PRIMITIVE_API_KEY`,\n`PRIMITIVE_API_BASE_URL`) already bound. Add user-set secrets via\n`POST /functions/{id}/secrets`; secret writes only land in the\nrunning handler on the next redeploy.\n",
 				"tags": ["Functions"],
 				"requestBody": {
 					"required": true,
@@ -3688,6 +3792,111 @@ const openapiDocument = {
 				}
 			}
 		},
+		"/org/secrets": {
+			"get": {
+				"operationId": "listOrgSecrets",
+				"summary": "List org-level (global) secrets",
+				"description": "Returns metadata for every org-level secret. Org secrets apply\nto every function in the org and are read as `env.<KEY>` in\nhandlers. **Values are never returned.** Secret writes are\nwrite-only. A function-level secret of the same name overrides\nthe org-level value for that function.\n",
+				"tags": ["Functions"],
+				"responses": {
+					"200": {
+						"description": "List of org secrets (metadata only, no values)",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
+							"type": "object",
+							"properties": { "data": {
+								"type": "object",
+								"properties": { "items": {
+									"type": "array",
+									"items": { "$ref": "#/components/schemas/OrgSecretListItem" }
+								} },
+								"required": ["items"]
+							} }
+						}] } } }
+					},
+					"401": { "$ref": "#/components/responses/Unauthorized" }
+				}
+			},
+			"post": {
+				"operationId": "createOrgSecret",
+				"summary": "Create or update an org secret",
+				"description": "Idempotent insert-or-update keyed on `(org_id, key)`. Returns\n201 the first time the key is set, 200 on subsequent updates.\nValues are encrypted at rest. A changed value lands in a\nfunction only on that function's next deploy.\n\nKeys must match `^[A-Z_][A-Z0-9_]*$` (uppercase letters,\ndigits, underscores; first character is a letter or\nunderscore). Values are at most 4096 UTF-8 bytes. System-\nmanaged keys are reserved and rejected.\n",
+				"tags": ["Functions"],
+				"requestBody": {
+					"required": true,
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateOrgSecretInput" } } }
+				},
+				"responses": {
+					"200": {
+						"description": "Secret updated",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
+							"type": "object",
+							"properties": { "data": { "$ref": "#/components/schemas/OrgSecretWriteResult" } }
+						}] } } }
+					},
+					"201": {
+						"description": "Secret created",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
+							"type": "object",
+							"properties": { "data": { "$ref": "#/components/schemas/OrgSecretWriteResult" } }
+						}] } } }
+					},
+					"400": { "$ref": "#/components/responses/ValidationError" },
+					"401": { "$ref": "#/components/responses/Unauthorized" }
+				}
+			}
+		},
+		"/org/secrets/{key}": {
+			"parameters": [{
+				"name": "key",
+				"in": "path",
+				"required": true,
+				"description": "Secret key. Must match `^[A-Z_][A-Z0-9_]*$`.",
+				"schema": {
+					"type": "string",
+					"pattern": "^[A-Z_][A-Z0-9_]*$"
+				}
+			}],
+			"put": {
+				"operationId": "setOrgSecret",
+				"summary": "Set an org secret by key",
+				"description": "Path-keyed companion to `POST /org/secrets`. Idempotent:\nreturns 201 the first time the key is set, 200 on subsequent\nupdates. Same validation and write-only guarantees as POST.\n",
+				"tags": ["Functions"],
+				"requestBody": {
+					"required": true,
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetOrgSecretInput" } } }
+				},
+				"responses": {
+					"200": {
+						"description": "Secret updated",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
+							"type": "object",
+							"properties": { "data": { "$ref": "#/components/schemas/OrgSecretWriteResult" } }
+						}] } } }
+					},
+					"201": {
+						"description": "Secret created",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
+							"type": "object",
+							"properties": { "data": { "$ref": "#/components/schemas/OrgSecretWriteResult" } }
+						}] } } }
+					},
+					"400": { "$ref": "#/components/responses/ValidationError" },
+					"401": { "$ref": "#/components/responses/Unauthorized" }
+				}
+			},
+			"delete": {
+				"operationId": "deleteOrgSecret",
+				"summary": "Delete an org secret",
+				"description": "Removes the org secret. Functions keep the previous value until\neach is redeployed. Returns 404 if the key did not exist.\n",
+				"tags": ["Functions"],
+				"responses": {
+					"204": { "description": "Secret deleted" },
+					"400": { "$ref": "#/components/responses/ValidationError" },
+					"401": { "$ref": "#/components/responses/Unauthorized" },
+					"404": { "$ref": "#/components/responses/NotFound" }
+				}
+			}
+		},
 		"/functions/{id}/logs": {
 			"parameters": [{ "$ref": "#/components/parameters/ResourceId" }],
 			"get": {
@@ -4849,6 +5058,16 @@ const openapiDocument = {
 					},
 					"email": { "type": "string" },
 					"plan": { "type": "string" },
+					"limits": { "$ref": "#/components/schemas/PlanLimits" },
+					"entitlements": {
+						"type": "array",
+						"items": { "type": "string" },
+						"description": "Granted org entitlement keys (sorted). A headless caller reads its\ncapabilities here — e.g. an emailless agent seeing only\n[\"send_mail\", \"send_to_known_addresses\"] knows it is reply-only.\n"
+					},
+					"managed_inbox_address": {
+						"type": ["string", "null"],
+						"description": "The managed inbox FQDN to reply as, or null if the org has no managed inbox."
+					},
 					"created_at": {
 						"type": "string",
 						"format": "date-time"
@@ -4876,6 +5095,9 @@ const openapiDocument = {
 					"id",
 					"email",
 					"plan",
+					"limits",
+					"entitlements",
+					"managed_inbox_address",
 					"created_at",
 					"discard_content_on_webhook_confirmed"
 				]
@@ -7886,6 +8108,81 @@ const openapiDocument = {
 					"updated_at",
 					"created"
 				]
+			},
+			"OrgSecretListItem": {
+				"type": "object",
+				"description": "One row from GET /org/secrets. Org secrets are always user-set\n(there are no managed org secrets), so `created_at` /\n`updated_at` are always present.\n",
+				"properties": {
+					"key": { "type": "string" },
+					"created_at": {
+						"type": "string",
+						"format": "date-time"
+					},
+					"updated_at": {
+						"type": "string",
+						"format": "date-time"
+					}
+				},
+				"required": [
+					"key",
+					"created_at",
+					"updated_at"
+				]
+			},
+			"CreateOrgSecretInput": {
+				"type": "object",
+				"additionalProperties": false,
+				"description": "Body for POST /org/secrets.",
+				"properties": {
+					"key": {
+						"type": "string",
+						"pattern": "^[A-Z_][A-Z0-9_]*$",
+						"description": "Uppercase letters, digits, and underscores. Must start with\na letter or underscore. System-managed keys are reserved.\n"
+					},
+					"value": {
+						"type": "string",
+						"minLength": 1,
+						"maxLength": 4096,
+						"description": "Secret value, up to 4096 UTF-8 bytes. Encrypted at rest.\nNever returned by any read endpoint.\n"
+					}
+				},
+				"required": ["key", "value"]
+			},
+			"SetOrgSecretInput": {
+				"type": "object",
+				"additionalProperties": false,
+				"description": "Body for PUT /org/secrets/{key}. Key comes from the path.",
+				"properties": { "value": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 4096
+				} },
+				"required": ["value"]
+			},
+			"OrgSecretWriteResult": {
+				"type": "object",
+				"description": "Returned by POST and PUT org secret routes.",
+				"properties": {
+					"key": { "type": "string" },
+					"created_at": {
+						"type": "string",
+						"format": "date-time"
+					},
+					"updated_at": {
+						"type": "string",
+						"format": "date-time"
+					},
+					"created": {
+						"type": "boolean",
+						"description": "True if this call inserted a new row, false if it updated an existing one."
+					}
+				},
+				"required": [
+					"key",
+					"created_at",
+					"updated_at",
+					"created"
+				]
 			}
 		}
 	}
@@ -7914,6 +8211,39 @@ const operationManifest = [
 				},
 				"email": { "type": "string" },
 				"plan": { "type": "string" },
+				"limits": {
+					"type": "object",
+					"description": "Plan-derived quota limits for an account.",
+					"properties": {
+						"storage_mb": { "type": "number" },
+						"send_per_hour": { "type": "number" },
+						"send_per_day": { "type": "number" },
+						"api_per_minute": { "type": "number" },
+						"webhooks_max_global": { "type": ["number", "null"] },
+						"webhooks_per_domain": { "type": "boolean" },
+						"filters_per_domain": { "type": "boolean" },
+						"spam_thresholds_per_domain": { "type": "boolean" }
+					},
+					"required": [
+						"storage_mb",
+						"send_per_hour",
+						"send_per_day",
+						"api_per_minute",
+						"webhooks_max_global",
+						"webhooks_per_domain",
+						"filters_per_domain",
+						"spam_thresholds_per_domain"
+					]
+				},
+				"entitlements": {
+					"type": "array",
+					"items": { "type": "string" },
+					"description": "Granted org entitlement keys (sorted). A headless caller reads its\ncapabilities here — e.g. an emailless agent seeing only\n[\"send_mail\", \"send_to_known_addresses\"] knows it is reply-only.\n"
+				},
+				"managed_inbox_address": {
+					"type": ["string", "null"],
+					"description": "The managed inbox FQDN to reply as, or null if the org has no managed inbox."
+				},
 				"created_at": {
 					"type": "string",
 					"format": "date-time"
@@ -7941,6 +8271,9 @@ const operationManifest = [
 				"id",
 				"email",
 				"plan",
+				"limits",
+				"entitlements",
+				"managed_inbox_address",
 				"created_at",
 				"discard_content_on_webhook_confirmed"
 			]
@@ -10397,7 +10730,23 @@ const operationManifest = [
 				"name": "date_to",
 				"required": false,
 				"type": "string"
-			}
+			},
+			{
+				"description": "Forward-tail cursor. Returns rows that became visible AFTER this\ncursor, oldest-first, so a caller can stream new inbound mail by\nre-passing the cursor from each response. Mutually exclusive with\n`cursor` (which pages history newest-first). Pass the `meta.cursor`\nfrom the previous `since` response; an empty page means caught up.\n",
+				"enum": null,
+				"name": "since",
+				"required": false,
+				"type": "string"
+			},
+			{
+				"description": "Long-poll: hold the request up to this many seconds waiting for new\nmail past `since`, returning as soon as any arrives (or an empty\npage when the wait elapses). Requires `since`. Omitted means no wait\n(returns immediately); the server treats an absent value as 0. NOT\ngiven an OpenAPI `default` on purpose: a default makes some\ngenerators (e.g. openapi-python-client) send `wait=0` on every call,\nwhich then fails the `wait` requires `since` check for plain history\nlistings.\n",
+				"enum": null,
+				"maximum": 30,
+				"minimum": 0,
+				"name": "wait",
+				"required": false,
+				"type": "integer"
+			}
 		],
 		"requestSchema": null,
 		"responseSchema": {
@@ -11406,7 +11755,7 @@ const operationManifest = [
 		"binaryResponse": false,
 		"bodyRequired": true,
 		"command": "create-function",
-		"description": "Creates and deploys a new function. The handler must be a single\nESM module whose default export is an object with an async\n`fetch(request, env)` method (Workers-style). Primitive signs\neach delivery and forwards the `Primitive-Signature` header to\nthe handler. Verify the raw request body with\n`PRIMITIVE_WEBHOOK_SECRET` before parsing JSON; after verification\nthe request body parses to an `email.received` event (see\n`EmailReceivedEvent` and the Webhook payload section for the full\nschema). Code is bundled before being uploaded; ship a single\nself-contained file rather than relying on external imports.\n\n**Code limits.** `code` is capped at 1 MiB UTF-8. `sourceMap`\n(optional) is capped at 5 MiB UTF-8, stored with each deployment\nattempt, and sent to the runtime so stack traces can resolve to\noriginal source files.\n\n**Routing.** On successful deploy, the function code is live\nin the runtime, but inbound mail will not reach it until at\nleast one route is bound. Routes are managed from the Primitive\ndashboard. A `deploy_status` of `deployed` means the script is\ninstalled, not that the function is receiving mail. The\ninternal runtime URL is not returned by the API and is not a\ncustomer-facing integration surface.\n\n**Secrets.** New functions ship with the managed secrets\n(`PRIMITIVE_WEBHOOK_SECRET`, `PRIMITIVE_API_KEY`,\n`PRIMITIVE_API_BASE_URL`) already bound. Add user-set secrets via\n`POST /functions/{id}/secrets`; secret writes only land in the\nrunning handler on the next redeploy.\n",
+		"description": "Creates and deploys a new function. The handler must be a single\nESM module whose default export is an object with an async\n`fetch(request, env)` method (Workers-style). Primitive signs\neach delivery and forwards the `Primitive-Signature` header to\nthe handler. Verify the raw request body with\n`PRIMITIVE_WEBHOOK_SECRET` before parsing JSON; after verification\nthe request body parses to a webhook event whose `event` field is\n`email.received` for normal inbound mail, or a machine-mail type\n(`email.bounced`, `email.tls_report`, `email.dmarc_report`,\n`email.dmarc_failure`) for bounces and reports. Code is bundled\nbefore being uploaded; ship a single self-contained file rather\nthan relying on external imports.\n\n**Code limits.** `code` is capped at 1 MiB UTF-8. `sourceMap`\n(optional) is capped at 5 MiB UTF-8, stored with each deployment\nattempt, and sent to the runtime so stack traces can resolve to\noriginal source files.\n\n**Routing.** On successful deploy, the function code is live\nin the runtime, but inbound mail will not reach it until at\nleast one route is bound. Routes are managed from the Primitive\ndashboard. A `deploy_status` of `deployed` means the script is\ninstalled, not that the function is receiving mail. The\ninternal runtime URL is not returned by the API and is not a\ncustomer-facing integration surface.\n\n**Secrets.** New functions ship with the managed secrets\n(`PRIMITIVE_WEBHOOK_SECRET`, `PRIMITIVE_API_KEY`,\n`PRIMITIVE_API_BASE_URL`) already bound. Add user-set secrets via\n`POST /functions/{id}/secrets`; secret writes only land in the\nrunning handler on the next redeploy.\n",
 		"hasJsonBody": true,
 		"method": "POST",
 		"operationId": "createFunction",
@@ -11538,6 +11887,66 @@ const operationManifest = [
 		"tag": "Functions",
 		"tagCommand": "functions"
 	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": true,
+		"command": "create-org-secret",
+		"description": "Idempotent insert-or-update keyed on `(org_id, key)`. Returns\n201 the first time the key is set, 200 on subsequent updates.\nValues are encrypted at rest. A changed value lands in a\nfunction only on that function's next deploy.\n\nKeys must match `^[A-Z_][A-Z0-9_]*$` (uppercase letters,\ndigits, underscores; first character is a letter or\nunderscore). Values are at most 4096 UTF-8 bytes. System-\nmanaged keys are reserved and rejected.\n",
+		"hasJsonBody": true,
+		"method": "POST",
+		"operationId": "createOrgSecret",
+		"path": "/org/secrets",
+		"pathParams": [],
+		"queryParams": [],
+		"requestSchema": {
+			"type": "object",
+			"additionalProperties": false,
+			"description": "Body for POST /org/secrets.",
+			"properties": {
+				"key": {
+					"type": "string",
+					"pattern": "^[A-Z_][A-Z0-9_]*$",
+					"description": "Uppercase letters, digits, and underscores. Must start with\na letter or underscore. System-managed keys are reserved.\n"
+				},
+				"value": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 4096,
+					"description": "Secret value, up to 4096 UTF-8 bytes. Encrypted at rest.\nNever returned by any read endpoint.\n"
+				}
+			},
+			"required": ["key", "value"]
+		},
+		"responseSchema": {
+			"type": "object",
+			"description": "Returned by POST and PUT org secret routes.",
+			"properties": {
+				"key": { "type": "string" },
+				"created_at": {
+					"type": "string",
+					"format": "date-time"
+				},
+				"updated_at": {
+					"type": "string",
+					"format": "date-time"
+				},
+				"created": {
+					"type": "boolean",
+					"description": "True if this call inserted a new row, false if it updated an existing one."
+				}
+			},
+			"required": [
+				"key",
+				"created_at",
+				"updated_at",
+				"created"
+			]
+		},
+		"sdkName": "createOrgSecret",
+		"summary": "Create or update an org secret",
+		"tag": "Functions",
+		"tagCommand": "functions"
+	},
 	{
 		"binaryResponse": false,
 		"bodyRequired": false,
@@ -11592,6 +12001,30 @@ const operationManifest = [
 		"tag": "Functions",
 		"tagCommand": "functions"
 	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": false,
+		"command": "delete-org-secret",
+		"description": "Removes the org secret. Functions keep the previous value until\neach is redeployed. Returns 404 if the key did not exist.\n",
+		"hasJsonBody": false,
+		"method": "DELETE",
+		"operationId": "deleteOrgSecret",
+		"path": "/org/secrets/{key}",
+		"pathParams": [{
+			"description": "Secret key. Must match `^[A-Z_][A-Z0-9_]*$`.",
+			"enum": null,
+			"name": "key",
+			"required": true,
+			"type": "string"
+		}],
+		"queryParams": [],
+		"requestSchema": null,
+		"responseSchema": null,
+		"sdkName": "deleteOrgSecret",
+		"summary": "Delete an org secret",
+		"tag": "Functions",
+		"tagCommand": "functions"
+	},
 	{
 		"binaryResponse": false,
 		"bodyRequired": false,
@@ -12472,6 +12905,50 @@ const operationManifest = [
 		"tag": "Functions",
 		"tagCommand": "functions"
 	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": false,
+		"command": "list-org-secrets",
+		"description": "Returns metadata for every org-level secret. Org secrets apply\nto every function in the org and are read as `env.<KEY>` in\nhandlers. **Values are never returned.** Secret writes are\nwrite-only. A function-level secret of the same name overrides\nthe org-level value for that function.\n",
+		"hasJsonBody": false,
+		"method": "GET",
+		"operationId": "listOrgSecrets",
+		"path": "/org/secrets",
+		"pathParams": [],
+		"queryParams": [],
+		"requestSchema": null,
+		"responseSchema": {
+			"type": "object",
+			"properties": { "items": {
+				"type": "array",
+				"items": {
+					"type": "object",
+					"description": "One row from GET /org/secrets. Org secrets are always user-set\n(there are no managed org secrets), so `created_at` /\n`updated_at` are always present.\n",
+					"properties": {
+						"key": { "type": "string" },
+						"created_at": {
+							"type": "string",
+							"format": "date-time"
+						},
+						"updated_at": {
+							"type": "string",
+							"format": "date-time"
+						}
+					},
+					"required": [
+						"key",
+						"created_at",
+						"updated_at"
+					]
+				}
+			} },
+			"required": ["items"]
+		},
+		"sdkName": "listOrgSecrets",
+		"summary": "List org-level (global) secrets",
+		"tag": "Functions",
+		"tagCommand": "functions"
+	},
 	{
 		"binaryResponse": false,
 		"bodyRequired": true,
@@ -12660,6 +13137,64 @@ const operationManifest = [
 		"tag": "Functions",
 		"tagCommand": "functions"
 	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": true,
+		"command": "set-org-secret",
+		"description": "Path-keyed companion to `POST /org/secrets`. Idempotent:\nreturns 201 the first time the key is set, 200 on subsequent\nupdates. Same validation and write-only guarantees as POST.\n",
+		"hasJsonBody": true,
+		"method": "PUT",
+		"operationId": "setOrgSecret",
+		"path": "/org/secrets/{key}",
+		"pathParams": [{
+			"description": "Secret key. Must match `^[A-Z_][A-Z0-9_]*$`.",
+			"enum": null,
+			"name": "key",
+			"required": true,
+			"type": "string"
+		}],
+		"queryParams": [],
+		"requestSchema": {
+			"type": "object",
+			"additionalProperties": false,
+			"description": "Body for PUT /org/secrets/{key}. Key comes from the path.",
+			"properties": { "value": {
+				"type": "string",
+				"minLength": 1,
+				"maxLength": 4096
+			} },
+			"required": ["value"]
+		},
+		"responseSchema": {
+			"type": "object",
+			"description": "Returned by POST and PUT org secret routes.",
+			"properties": {
+				"key": { "type": "string" },
+				"created_at": {
+					"type": "string",
+					"format": "date-time"
+				},
+				"updated_at": {
+					"type": "string",
+					"format": "date-time"
+				},
+				"created": {
+					"type": "boolean",
+					"description": "True if this call inserted a new row, false if it updated an existing one."
+				}
+			},
+			"required": [
+				"key",
+				"created_at",
+				"updated_at",
+				"created"
+			]
+		},
+		"sdkName": "setOrgSecret",
+		"summary": "Set an org secret by key",
+		"tag": "Functions",
+		"tagCommand": "functions"
+	},
 	{
 		"binaryResponse": false,
 		"bodyRequired": false,
@@ -15344,6 +15879,76 @@ function canonicalizeCliReferences(description) {
 	return description.replaceAll("`primitive emails:latest`", "`primitive emails latest`").replaceAll("`primitive describe emails:get-email | jq '.responseSchema.properties'`", "`primitive describe emails:get | jq '.responseSchema.properties'`");
 }
 //#endregion
+//#region src/oclif/commands/agent-upgrade.ts
+/**
+* Interactive upgrade of an emailless agent account to a full developer
+* account: starts the email claim, prompts for the emailed code, and verifies
+* it. Combines the generated `agent:claim` (start) and `agent:claim-verify`
+* into one flow with a prompt, mirroring the `signup` interactive command.
+* Authenticated by the agent's own API key (the org is taken from the key).
+*/
+var AgentUpgradeCommand = class AgentUpgradeCommand extends Command {
+	static description = "Upgrade an emailless agent account to a full developer account by confirming an email. Authenticated by the agent's own API key (PRIMITIVE_API_KEY).";
+	static summary = "Upgrade an agent account to developer (email confirmation)";
+	static examples = ["<%= config.bin %> agent upgrade --email you@example.com"];
+	static flags = {
+		email: Flags.string({ description: "Email to confirm. Prompted if omitted." }),
+		code: Flags.string({ description: "Verification code from the email. Prompted if omitted." }),
+		"api-key": Flags.string({
+			env: "PRIMITIVE_API_KEY",
+			description: "Agent API key (defaults to PRIMITIVE_API_KEY or saved credentials)."
+		}),
+		"api-base-url": Flags.string({ description: "Override the API base URL." })
+	};
+	async run() {
+		const { flags } = await this.parse(AgentUpgradeCommand);
+		const { apiClient } = await createAuthenticatedCliApiClient({
+			apiKey: flags["api-key"],
+			apiBaseUrl: flags["api-base-url"],
+			configDir: this.config.configDir
+		});
+		const email = flags.email ?? await promptRequired$1("Email to confirm: ");
+		const started = await startAgentClaim({
+			body: { email },
+			client: apiClient.client,
+			responseStyle: "fields"
+		});
+		if (!started.data) {
+			writeErrorWithHints(extractErrorPayload(started.error));
+			this.exit(1);
+			return;
+		}
+		process$1.stderr.write(`Verification code sent to ${email}.\n`);
+		const verified = await verifyAgentClaim({
+			body: { verification_code: flags.code ?? await promptRequired$1("Verification code: ") },
+			client: apiClient.client,
+			responseStyle: "fields"
+		});
+		const result = verified.data?.data;
+		if (result) {
+			this.log(JSON.stringify(result, null, 2));
+			process$1.stderr.write(`Upgraded to ${result.plan}. Your API key and managed inbox carry over; the send cap is lifted.\n`);
+			return;
+		}
+		writeErrorWithHints(extractErrorPayload(verified.error));
+		this.exit(1);
+	}
+};
+async function promptRequired$1(question) {
+	const rl = createInterface({
+		input: process$1.stdin,
+		output: process$1.stderr
+	});
+	try {
+		for (;;) {
+			const answer = (await rl.question(question)).trim();
+			if (answer) return answer;
+		}
+	} finally {
+		rl.close();
+	}
+}
+//#endregion
 //#region src/oclif/attachments.ts
 function readAttachmentBytes(path, readFile) {
 	try {
@@ -18777,8 +19382,8 @@ const PRIMITIVE_TEAM_AUTHOR = {
 	name: "Primitive Team",
 	url: "https://primitive.dev"
 };
-const SDK_VERSION_RANGE = "^1.3.0";
-const CLI_VERSION_RANGE = "^1.3.0";
+const SDK_VERSION_RANGE = "^1.5.0";
+const CLI_VERSION_RANGE = "^1.5.0";
 const ESBUILD_VERSION_RANGE = "^0.27.0";
 function renderHandler() {
 	return `// env.PRIMITIVE_API_KEY, env.PRIMITIVE_WEBHOOK_SECRET, and
@@ -21923,6 +22528,251 @@ var LogoutCommand = class LogoutCommand extends Command {
 	}
 };
 //#endregion
+//#region src/oclif/commands/org-secrets-shared.ts
+function orgSecretsUrl(baseUrl, key) {
+	const base = `${baseUrl.replace(/\/$/, "")}/org/secrets`;
+	return key ? `${base}/${encodeURIComponent(key)}` : base;
+}
+function orgSecretsAuthHeaders(requestHeaders, apiKey) {
+	return {
+		...requestHeaders ?? {},
+		...apiKey ? { authorization: `Bearer ${apiKey}` } : {}
+	};
+}
+async function orgSecretsErrorPayload(response) {
+	if ((response.headers.get("content-type")?.toLowerCase() ?? "").includes("application/json")) return response.json().catch(() => ({
+		code: "http_error",
+		message: `HTTP ${response.status} ${response.statusText}`.trim()
+	}));
+	return {
+		code: "http_error",
+		message: (await response.text().catch(() => "")).trim() || `HTTP ${response.status} ${response.statusText}`.trim()
+	};
+}
+async function runOrgSecretsRequest(fetchImpl, baseUrl, headers, op) {
+	const url = op.kind === "remove" ? orgSecretsUrl(baseUrl, op.key) : orgSecretsUrl(baseUrl);
+	const init = op.kind === "set" ? {
+		method: "POST",
+		headers: {
+			...headers,
+			"content-type": "application/json"
+		},
+		body: JSON.stringify({
+			key: op.key,
+			value: op.value
+		})
+	} : op.kind === "remove" ? {
+		method: "DELETE",
+		headers
+	} : { headers };
+	let response;
+	try {
+		response = await fetchImpl(url, init);
+	} catch (error) {
+		return {
+			kind: "error",
+			payload: extractErrorPayload(error)
+		};
+	}
+	if (!response.ok) return {
+		kind: "error",
+		payload: extractErrorPayload(await orgSecretsErrorPayload(response))
+	};
+	if (op.kind === "remove") return {
+		kind: "ok",
+		data: null
+	};
+	const body = await response.json().catch(() => ({}));
+	if (op.kind === "list") return {
+		kind: "ok",
+		data: body.data?.items ?? []
+	};
+	return {
+		kind: "ok",
+		data: body.data ?? {}
+	};
+}
+//#endregion
+//#region src/oclif/commands/org-secrets-list.ts
+var OrgSecretsListCommand = class OrgSecretsListCommand extends Command {
+	static description = `List your organization's global secrets.
+
+  Global secrets apply to every function in the org and are read as
+  \`env.<KEY>\` in handlers. Only the keys and timestamps are returned;
+  the values are encrypted at rest and never surfaced.`;
+	static summary = "List global secrets (keys only; values never returned)";
+	static examples = ["<%= config.bin %> org secrets list"];
+	static flags = {
+		"api-key": Flags.string({
+			description: "Primitive API key override (defaults to PRIMITIVE_API_KEY or saved OAuth login credentials)",
+			env: "PRIMITIVE_API_KEY"
+		}),
+		"api-base-url": Flags.string({
+			description: "Override the primary API base URL. Internal testing only; not documented to customers.",
+			env: "PRIMITIVE_API_BASE_URL",
+			hidden: true
+		}),
+		time: Flags.boolean({ description: TIME_FLAG_DESCRIPTION })
+	};
+	async run() {
+		const { flags } = await this.parse(OrgSecretsListCommand);
+		await runWithTiming(flags.time, async () => {
+			const { auth, baseUrlOverridden, requestConfig } = await createAuthenticatedCliApiClient({
+				apiKey: flags["api-key"],
+				apiBaseUrl: flags["api-base-url"],
+				configDir: this.config.configDir
+			});
+			const outcome = await runOrgSecretsRequest(fetch, requestConfig.resolvedApiBaseUrl, orgSecretsAuthHeaders(requestConfig.headers, auth.apiKey), { kind: "list" });
+			if (outcome.kind === "error") {
+				writeErrorWithHints(outcome.payload);
+				surfaceUnauthorizedHint({
+					auth,
+					baseUrlOverridden,
+					configDir: this.config.configDir,
+					payload: outcome.payload
+				});
+				process.exitCode = 1;
+				return;
+			}
+			this.log(JSON.stringify(outcome.data, null, 2));
+		});
+	}
+};
+//#endregion
+//#region src/oclif/commands/org-secrets-remove.ts
+var OrgSecretsRemoveCommand = class OrgSecretsRemoveCommand extends Command {
+	static description = `Delete a global secret.
+
+  Deployed functions keep the previous value until each is redeployed. A
+  function that defines its own secret of the same name is unaffected.`;
+	static summary = "Delete a global secret";
+	static aliases = ["org:secrets:delete"];
+	static examples = ["<%= config.bin %> org secrets remove --key STRIPE_KEY"];
+	static flags = {
+		"api-key": Flags.string({
+			description: "Primitive API key override (defaults to PRIMITIVE_API_KEY or saved OAuth login credentials)",
+			env: "PRIMITIVE_API_KEY"
+		}),
+		"api-base-url": Flags.string({
+			description: "Override the primary API base URL. Internal testing only; not documented to customers.",
+			env: "PRIMITIVE_API_BASE_URL",
+			hidden: true
+		}),
+		key: Flags.string({
+			description: "Global secret key to delete.",
+			required: true
+		}),
+		time: Flags.boolean({ description: TIME_FLAG_DESCRIPTION })
+	};
+	async run() {
+		const { flags } = await this.parse(OrgSecretsRemoveCommand);
+		await runWithTiming(flags.time, async () => {
+			const { auth, baseUrlOverridden, requestConfig } = await createAuthenticatedCliApiClient({
+				apiKey: flags["api-key"],
+				apiBaseUrl: flags["api-base-url"],
+				configDir: this.config.configDir
+			});
+			const outcome = await runOrgSecretsRequest(fetch, requestConfig.resolvedApiBaseUrl, orgSecretsAuthHeaders(requestConfig.headers, auth.apiKey), {
+				kind: "remove",
+				key: flags.key
+			});
+			if (outcome.kind === "error") {
+				writeErrorWithHints(outcome.payload);
+				surfaceUnauthorizedHint({
+					auth,
+					baseUrlOverridden,
+					configDir: this.config.configDir,
+					payload: outcome.payload
+				});
+				process.exitCode = 1;
+				return;
+			}
+			process.stderr.write(`Global secret ${flags.key} deleted. Deployed functions keep the previous value until each is redeployed.\n`);
+		});
+	}
+};
+//#endregion
+//#region src/oclif/commands/org-secrets-set.ts
+var OrgSecretsSetCommand = class OrgSecretsSetCommand extends Command {
+	static description = `Set a global secret available to every function as \`env.<KEY>\`.
+
+  Global secrets are read into each function at deploy time, so a new or
+  changed value lands in a function only on its next redeploy. A function
+  secret with the same key overrides the global value for that function.
+
+  Keys must match \`^[A-Z_][A-Z0-9_]*$\` (uppercase letters, digits,
+  underscores; first character a letter or underscore). System-managed keys
+  are reserved and rejected. ${SINGLE_SECRET_VALUE_SOURCE_DESCRIPTION}`;
+	static summary = "Set a global secret shared across all functions";
+	static examples = [
+		"<%= config.bin %> org secrets set --key STRIPE_KEY --value sk_live_...",
+		"<%= config.bin %> org secrets set --key OPENAI_KEY --value-from-env OPENAI_KEY",
+		"printf '%s' \"$OPENAI_KEY\" | <%= config.bin %> org secrets set --key OPENAI_KEY --stdin"
+	];
+	static flags = {
+		"api-key": Flags.string({
+			description: "Primitive API key override (defaults to PRIMITIVE_API_KEY or saved OAuth login credentials)",
+			env: "PRIMITIVE_API_KEY"
+		}),
+		"api-base-url": Flags.string({
+			description: "Override the primary API base URL. Internal testing only; not documented to customers.",
+			env: "PRIMITIVE_API_BASE_URL",
+			hidden: true
+		}),
+		key: Flags.string({
+			description: "Secret key. Uppercase letters, digits, underscores; must start with a letter or underscore. System-managed keys are reserved.",
+			required: true
+		}),
+		value: Flags.string({ description: "Secret value (up to 4096 UTF-8 bytes). Encrypted at rest. Visible in shell history and process argv; prefer a non-argv source for sensitive values." }),
+		"value-from-env": Flags.string({ description: "Environment variable to read as the secret value. Example: --value-from-env OPENAI_KEY reads process.env.OPENAI_KEY." }),
+		"value-file": Flags.string({ description: "UTF-8 file to read as the secret value. The full file contents become the value." }),
+		"value-from-env-file": Flags.string({ description: "Dotenv-style file to read as the secret value. Use FILE to read --key from that file, or FILE:KEY to read a different key." }),
+		stdin: Flags.boolean({ description: "Read the secret value from stdin. A single trailing line ending is stripped." }),
+		time: Flags.boolean({ description: TIME_FLAG_DESCRIPTION })
+	};
+	async run() {
+		const { flags } = await this.parse(OrgSecretsSetCommand);
+		await runWithTiming(flags.time, async () => {
+			const { auth, baseUrlOverridden, requestConfig } = await createAuthenticatedCliApiClient({
+				apiKey: flags["api-key"],
+				apiBaseUrl: flags["api-base-url"],
+				configDir: this.config.configDir
+			});
+			const resolved = resolveSingleSecretValue({
+				key: flags.key,
+				value: flags.value,
+				valueFile: flags["value-file"],
+				valueFromEnv: flags["value-from-env"],
+				valueFromEnvFile: flags["value-from-env-file"],
+				stdin: flags.stdin
+			});
+			if (resolved.kind === "error") {
+				process.stderr.write(`${resolved.message}\n`);
+				process.exitCode = 1;
+				return;
+			}
+			const outcome = await runOrgSecretsRequest(fetch, requestConfig.resolvedApiBaseUrl, orgSecretsAuthHeaders(requestConfig.headers, auth.apiKey), {
+				kind: "set",
+				key: flags.key,
+				value: resolved.value
+			});
+			if (outcome.kind === "error") {
+				writeErrorWithHints(outcome.payload);
+				surfaceUnauthorizedHint({
+					auth,
+					baseUrlOverridden,
+					configDir: this.config.configDir,
+					payload: outcome.payload
+				});
+				process.exitCode = 1;
+				return;
+			}
+			this.log(JSON.stringify(outcome.data, null, 2));
+			process.stderr.write(`Global secret ${flags.key} saved. Deployed functions pick it up on their next redeploy; a function secret of the same name overrides it.\n`);
+		});
+	}
+};
+//#endregion
 //#region src/oclif/message-body-sources.ts
 function defaultReadFile(path) {
 	return readFileSync(path, "utf8");
@@ -23358,6 +24208,7 @@ const OVERRIDDEN_OPERATION_IDS = new Set([
 const generatedCommands = Object.fromEntries(operationManifest.filter((operation) => !OVERRIDDEN_OPERATION_IDS.has(operationId(operation))).map((operation) => [operationId(operation), createOperationCommand(operation)]));
 const COMMANDS = {
 	completion: CompletionCommand,
+	"agent:upgrade": AgentUpgradeCommand,
 	"list-operations": ListOperationsCommand,
 	config: ConfigCommand,
 	"config:list": ConfigListCommand,
@@ -23410,6 +24261,9 @@ const COMMANDS = {
 	"functions:deploy": FunctionsDeployCommand,
 	"functions:redeploy": FunctionsRedeployCommand,
 	"functions:set-secret": FunctionsSetSecretCommand,
+	"org:secrets:list": OrgSecretsListCommand,
+	"org:secrets:set": OrgSecretsSetCommand,
+	"org:secrets:remove": OrgSecretsRemoveCommand,
 	"functions:test": FunctionsTestFunctionCommand,
 	"functions:test-function": FunctionsTestFunctionCommand,
 	"functions:route-set": FunctionsRouteSetCommand,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primitivedotdev/cli",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "Official Primitive CLI: deploy Primitive Functions, send and inspect mail, manage endpoints, all from the terminal. Wraps the @primitivedotdev/sdk runtime client with one-shot commands.",
   "type": "module",
   "sideEffects": false,
@@ -97,6 +97,12 @@
       },
       "functions": {
         "description": "Deploy JavaScript handlers that run on inbound mail. Prefer `primitive functions templates`, `primitive functions init`, `primitive functions deploy`, `primitive functions redeploy`, `primitive functions list`, `primitive functions get`, `primitive functions logs`, and `primitive functions set-secret`; generated API names remain available for compatibility."
+      },
+      "org": {
+        "description": "Manage org-level (global) resources shared across functions"
+      },
+      "org:secrets": {
+        "description": "Global secrets shared across every function. Use `primitive org secrets list|set|remove`. Changes land in a function on its next redeploy; a function secret of the same name overrides the global."
       }
     },
     "topicSeparator": " "