@primitivedotdev/cli 1.3.0 → 1.4.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;
@@ -1194,10 +1194,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
@@ -1618,7 +1620,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 +2392,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 +3350,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,
@@ -4849,6 +4870,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 +4907,9 @@ const openapiDocument = {
 					"id",
 					"email",
 					"plan",
+					"limits",
+					"entitlements",
+					"managed_inbox_address",
 					"created_at",
 					"discard_content_on_webhook_confirmed"
 				]
@@ -7914,6 +7948,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 +8008,9 @@ const operationManifest = [
 				"id",
 				"email",
 				"plan",
+				"limits",
+				"entitlements",
+				"managed_inbox_address",
 				"created_at",
 				"discard_content_on_webhook_confirmed"
 			]
@@ -10397,6 +10467,22 @@ 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,
@@ -11406,7 +11492,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",
@@ -15344,6 +15430,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 +18933,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.4.0";
+const CLI_VERSION_RANGE = "^1.4.0";
 const ESBUILD_VERSION_RANGE = "^0.27.0";
 function renderHandler() {
 	return `// env.PRIMITIVE_API_KEY, env.PRIMITIVE_WEBHOOK_SECRET, and
@@ -21923,6 +22079,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 +23759,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 +23812,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.4.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": " "