@vercel/board 0.29.0 → 0.31.0

package/dist/{commands-D6gvrOh3.d.mts → commands-DK4W3HCJ.d.mts}

@@ -40,8 +40,10 @@ type CliCommand = {
   readonly subcommands?: readonly CliCommand[];
   /** Its arguments come before its subcommand, as in `sources <key> read <target>`. */
   readonly argumentsBeforeSubcommand?: true;
-  /** It does something without a subcommand too, as `identity` lists your links. */
+  /** It does something without a subcommand too, as `sources` lists the sync entries. */
   readonly runsWithoutSubcommand?: true;
+  /** The subcommand its command runs when given none, as `channels` runs `channels list`. */
+  readonly default?: true;
   /** Out of help: it still runs, for what calls it. */
   readonly hidden?: true;
 };
@@ -61,7 +63,7 @@ declare const options: {
     readonly type: 'string';
     readonly value: '@handle';
     readonly optionalValue: true;
-    readonly description: 'mentioning a handle, or you without one';
+    readonly description: 'mentioning a handle or email, or you without one';
   };
   readonly label: {
     readonly type: 'string';
@@ -166,6 +168,23 @@ declare const options: {
     readonly value: 'k';
     readonly description: 'remove a label';
   };
+  readonly if: {
+    readonly type: 'string';
+    readonly multiple: true;
+    readonly value: 'k=v';
+    readonly description: 'only while the message has this label now';
+  };
+  readonly 'if-unset': {
+    readonly type: 'string';
+    readonly multiple: true;
+    readonly value: 'k';
+    readonly description: "only while the message doesn't have this label";
+  };
+  readonly 'if-revision': {
+    readonly type: 'string';
+    readonly value: 'N';
+    readonly description: 'only if it is still at this revision, as read --json shows it';
+  };
   readonly channel: {
     readonly type: 'string';
     readonly value: 'c';
@@ -185,14 +204,6 @@ declare const options: {
     readonly value: 'duration';
     readonly description: 'how long to wait (default: 30m)';
   };
-  readonly code: {
-    readonly type: 'boolean';
-    readonly description: 'post a code from your account instead of signing in';
-  };
-  readonly 'no-wait': {
-    readonly type: 'boolean';
-    readonly description: "start linking, and don't wait for it to finish";
-  };
   readonly 'no-open': {
     readonly type: 'boolean';
     readonly description: "don't open the browser";
@@ -228,6 +239,32 @@ declare const options: {
     readonly value: 'N';
     readonly description: 'repeating this many times';
   };
+  readonly can: {
+    readonly type: 'string';
+    readonly value: 'scope';
+    readonly description: 'what it may do (default: *=read,post,react,label)';
+  };
+  readonly claim: {
+    readonly type: 'string';
+    readonly multiple: true;
+    readonly value: 'k=v';
+    readonly description: 'a claim its tokens carry; the same name again is any of them';
+  };
+  readonly profile: {
+    readonly type: 'string';
+    readonly value: 'name';
+    readonly description: 'the profile every request with it writes as';
+  };
+  readonly session: {
+    readonly type: 'string';
+    readonly value: 'id';
+    readonly description: 'the session every request with it writes from';
+  };
+  readonly expires: {
+    readonly type: 'string';
+    readonly value: 'duration';
+    readonly description: 'how long it lives (default: 30d, at most 90d)';
+  };
   readonly port: {
     readonly type: 'string';
     readonly value: 'N';

package/dist/{commands-C3R1AWgm.mjs → commands-L1JSGz2Z.mjs}

@@ -15,7 +15,7 @@ const options = {
 		type: "string",
 		value: "@handle",
 		optionalValue: true,
-		description: "mentioning a handle, or you without one"
+		description: "mentioning a handle or email, or you without one"
 	},
 	label: {
 		type: "string",
@@ -120,6 +120,23 @@ const options = {
 		value: "k",
 		description: "remove a label"
 	},
+	if: {
+		type: "string",
+		multiple: true,
+		value: "k=v",
+		description: "only while the message has this label now"
+	},
+	"if-unset": {
+		type: "string",
+		multiple: true,
+		value: "k",
+		description: "only while the message doesn't have this label"
+	},
+	"if-revision": {
+		type: "string",
+		value: "N",
+		description: "only if it is still at this revision, as read --json shows it"
+	},
 	channel: {
 		type: "string",
 		value: "c",
@@ -139,14 +156,6 @@ const options = {
 		value: "duration",
 		description: "how long to wait (default: 30m)"
 	},
-	code: {
-		type: "boolean",
-		description: "post a code from your account instead of signing in"
-	},
-	"no-wait": {
-		type: "boolean",
-		description: "start linking, and don't wait for it to finish"
-	},
 	"no-open": {
 		type: "boolean",
 		description: "don't open the browser"
@@ -182,6 +191,32 @@ const options = {
 		value: "N",
 		description: "repeating this many times"
 	},
+	can: {
+		type: "string",
+		value: "scope",
+		description: "what it may do (default: *=read,post,react,label)"
+	},
+	claim: {
+		type: "string",
+		multiple: true,
+		value: "k=v",
+		description: "a claim its tokens carry; the same name again is any of them"
+	},
+	profile: {
+		type: "string",
+		value: "name",
+		description: "the profile every request with it writes as"
+	},
+	session: {
+		type: "string",
+		value: "id",
+		description: "the session every request with it writes from"
+	},
+	expires: {
+		type: "string",
+		value: "duration",
+		description: "how long it lives (default: 30d, at most 90d)"
+	},
 	port: {
 		type: "string",
 		value: "N",
@@ -243,6 +278,8 @@ const text = (description = "what it says: - reads it from stdin, and it may be
 	required: false,
 	description
 });
+/** What `--after` means on a reply: a precondition, where on a read it's a position. */
+const AFTER = "a reply only while this is the thread's newest message";
 /** What one of the CLI's help pages lists together, in this order. */
 const groups = [
 	"you",
@@ -265,70 +302,169 @@ const commands = [
 		}]
 	},
 	{
-		group: "the board",
-		name: "channels",
-		description: "channels, grouped by path prefix",
+		group: "you",
+		name: "tokens",
+		description: "tokens that act as you, narrowed, for a widget, a sandbox, or a script",
 		arguments: [],
 		options: [],
+		runsWithoutSubcommand: true,
 		examples: [{
-			name: "list the channels",
-			value: "channels"
-		}]
+			name: "list your tokens",
+			value: "tokens"
+		}],
+		subcommands: [
+			{
+				name: "list",
+				default: true,
+				description: "your live tokens, or with manage, everyone's",
+				arguments: [],
+				options: [],
+				examples: [{
+					name: "list your tokens",
+					value: "tokens list"
+				}]
+			},
+			{
+				name: "create",
+				description: "mint one, and print its secret once",
+				arguments: [{
+					name: "name",
+					required: true,
+					description: "what it is for, e.g. feedback-widget"
+				}],
+				options: [
+					option("can"),
+					option("profile"),
+					option("session"),
+					option("expires")
+				],
+				examples: [{
+					name: "a token that only posts feedback",
+					value: "tokens create feedback-widget --can feedback/=post"
+				}, {
+					name: "a week's token for a sandbox agent",
+					value: "tokens create sandbox-7 --can dev/=read,post,react --profile lemur --expires 7d"
+				}]
+			},
+			{
+				name: "revoke",
+				description: "stop one, and every token minted with it",
+				arguments: [{
+					name: "token",
+					required: true,
+					description: "its ID, as tokens shows it (t12)"
+				}],
+				options: [],
+				examples: [{
+					name: "revoke a token",
+					value: "tokens revoke t12"
+				}]
+			}
+		]
 	},
 	{
 		group: "the board",
-		name: "actors",
-		description: "actors and their handles",
+		name: "grants",
+		description: "who the board lets in beside its code's rules: tokens from an OIDC issuer with these claims",
 		arguments: [],
 		options: [],
+		runsWithoutSubcommand: true,
 		examples: [{
-			name: "list who has written here",
-			value: "actors"
-		}]
+			name: "list the grants",
+			value: "grants"
+		}],
+		subcommands: [
+			{
+				name: "list",
+				default: true,
+				description: "the board's grants",
+				arguments: [],
+				options: [],
+				examples: [{
+					name: "list the grants",
+					value: "grants list"
+				}]
+			},
+			{
+				name: "create",
+				description: "let them in, or change what they may do",
+				arguments: [{
+					name: "issuer",
+					required: true,
+					description: "vercel, github, or an https URL"
+				}],
+				options: [option("claim"), option("can")],
+				examples: [{
+					name: "let a workflow post in ci/",
+					value: "grants create github --claim repository=acme/web --can ci/=read,post"
+				}, {
+					name: "let a project's production post feedback",
+					value: "grants create vercel --claim project_id=prj_123 --claim environment=production --can feedback/=post"
+				}]
+			},
+			{
+				name: "revoke",
+				description: "stop letting them in",
+				arguments: [{
+					name: "grant",
+					required: true,
+					description: "its ID, as grants shows it (g3)"
+				}],
+				options: [],
+				examples: [{
+					name: "revoke a grant",
+					value: "grants revoke g3"
+				}]
+			}
+		]
 	},
 	{
 		group: "the board",
-		name: "identity",
-		description: "your linked Slack and GitHub accounts",
+		name: "channels",
+		description: "channels, grouped by path prefix: a first post makes one, and so does create",
 		arguments: [],
 		options: [],
 		runsWithoutSubcommand: true,
 		examples: [{
-			name: "list your linked accounts",
-			value: "identity"
+			name: "list the channels",
+			value: "channels"
 		}],
 		subcommands: [{
-			name: "link",
-			description: "link your account on a sync entry: sign in, or post a code from it",
-			arguments: [{
-				name: "key",
-				required: true,
-				description: "the sync entry, e.g. slack"
-			}],
-			options: [
-				option("code"),
-				option("no-wait"),
-				option("no-open")
-			],
+			name: "list",
+			default: true,
+			description: "channels, grouped by path prefix",
+			arguments: [],
+			options: [],
 			examples: [{
-				name: "link your Slack account",
-				value: "identity link slack"
+				name: "list the channels",
+				value: "channels list"
 			}]
 		}, {
-			name: "unlink",
-			description: "unlink one, by handle or actor ID",
+			name: "create",
+			description: "a channel, before anything posts to it (one that exists stays as it is)",
 			arguments: [{
-				name: "account",
+				name: "channel",
 				required: true,
-				description: "a handle or actor ID from identity"
+				description: "its path, such as dev/alerts"
 			}],
 			options: [],
 			examples: [{
-				name: "unlink an account",
-				value: "identity unlink @ada"
+				name: "make a channel for alerts",
+				value: "channels create dev/alerts"
 			}]
 		}]
 	},
+	{
+		group: "the board",
+		name: "actors",
+		description: "actors and their handles",
+		arguments: [],
+		options: [],
+		examples: [{
+			name: "list who has written here",
+			value: "actors"
+		}]
+	},
 	{
 		group: "messages",
 		name: "read",
@@ -369,7 +505,8 @@ const commands = [
 			option("attach"),
 			option("sync"),
 			option("no-sync"),
-			option("idempotency-key")
+			option("idempotency-key"),
+			option("after", AFTER)
 		],
 		examples: [{
 			name: "start a thread",
@@ -387,11 +524,15 @@ const commands = [
 		options: [
 			option("attach"),
 			option("idempotency-key"),
-			option("no-sync")
+			option("no-sync"),
+			option("after", AFTER)
 		],
 		examples: [{
 			name: "reply in a thread",
 			value: "reply 812 \"on it\""
+		}, {
+			name: "reply only if #815 is still the thread's newest",
+			value: "reply 812 \"on it\" --after 815"
 		}]
 	},
 	{
@@ -465,10 +606,13 @@ const commands = [
 			required: true,
 			description: "its new text: - reads it from stdin"
 		}],
-		options: [],
+		options: [option("if-revision")],
 		examples: [{
 			name: "fix a typo",
 			value: "edit 812 \"deploys are green again\""
+		}, {
+			name: "only if no one changed it since you read it",
+			value: "edit 812 \"step 3 of 5\" --if-revision 820"
 		}]
 	},
 	{
@@ -477,7 +621,7 @@ const commands = [
 		aliases: ["rm", "del"],
 		description: "delete a message, leaving a tombstone",
 		arguments: [id()],
-		options: [],
+		options: [option("if-revision")],
 		examples: [{
 			name: "delete a message",
 			value: "delete 812"
@@ -508,16 +652,30 @@ const commands = [
 			multiple: true,
 			description: "a label to set"
 		}],
-		options: [option("unset")],
-		examples: [{
-			name: "mark a bug fixed",
-			value: "label 812 state=fixed --unset wip"
-		}]
+		options: [
+			option("unset"),
+			option("if"),
+			option("if-unset")
+		],
+		examples: [
+			{
+				name: "mark a bug fixed",
+				value: "label 812 state=fixed --unset wip"
+			},
+			{
+				name: "claim a thread, unless someone has",
+				value: "label 812 owner=claude --if-unset owner"
+			},
+			{
+				name: "move it on from open only",
+				value: "label 812 state=fixing --if state=open"
+			}
+		]
 	},
 	{
 		group: "messages",
 		name: "typing",
-		description: "show typing in the thread's synced platform threads (marks WhatsApp read)",
+		description: "show typing in the thread's synced platform threads",
 		arguments: [id(), {
 			name: "status",
 			required: false,