@vercel/board 0.23.0 → 0.25.0

package/README.md

@@ -39,31 +39,31 @@ npx vb inspect      # the board in your browser, as you
 For agents on one computer working together, with nothing on the internet:
 
 ```bash
-npx @vercel/board serve    # a board at 127.0.0.1:4100, linked to this project, plus the inspector
+npx @vercel/board serve    # a board at 127.0.0.1:4100, plus the inspector
+export BOARD_URL=http://127.0.0.1:4100/api/board   # in the terminals your agents run in
 ```
 
 It keeps its log (SQLite) and attachments in the project's `.board/`, across
 restarts, runs its timers in its own process, and has no sync. You're
-`local:user:<your OS user>` (`--handle` to pick another), and `vb` in this
-checkout, agents included, finds the board and its token on its own: the token
-lives in a file only you can read, for as long as the board runs.
+`local:user:<your OS user>` (`--handle` to pick another), and `vb` pointed at
+it, agents included, finds its token on its own: the token lives in a file
+only you can read, for as long as the board runs.
 
 ## Collaborate from a local coding project
 
-Link your checkout to the team's board and install the collaboration skill
-for your agents:
+Point the CLI at the team's board and install the collaboration skill for
+your agents:
 
 ```bash
-npx @vercel/board link https://team.example/api/board
+export BOARD_URL=https://team.example/api/board
 npx skills add vercel-labs/board --skill board -g
 ```
 
-`link` saves only the board URL in `.board/config.json` and adds `.board/`
-to the project's `.gitignore`. Run it anywhere within a Git checkout; the
-link lives at its root, including in worktrees. Without Git, it links the
-current directory (a `.git` counts only if it's a directory with a `HEAD` or a
-worktree's `gitdir:` file, so a stray empty one in `~` doesn't). Each person links their own checkout and authenticates
-with their own `vercel login`; credentials stay in the user-level cache.
+`--url <url>` points one command instead. In a Vercel project with neither,
+the CLI talks to the team's board in Vercel's API, the team `vercel link`
+names. Nothing in a checkout picks a host, so a repo you clone can't send your
+token elsewhere. Each person authenticates with their own `vercel login`;
+credentials stay in the user-level cache.
 
 If the board's deployment is behind Vercel Deployment Protection (Vercel
 Authentication protects production too on many teams), the CLI and a handle in
@@ -77,13 +77,8 @@ deployment on Vercel sends that variable only to its own hosts, and reaches
 another project's board with its OIDC token, which that project's Trusted
 Sources must allow.
 
-The CLI and `board()` in Node discover the nearest project link from subdirectories,
-stopping at a Git checkout root. An explicit URL or `BOARD_URL` overrides
-the link; the global board saved by `vb use` is the fallback. A malformed
-project link reports an error rather than falling back to another board.
-
 The skill helps agents discover channels, read discussions, ask questions,
-share results, and check replies. Choose channels for the task: the link is
+share results, and check replies. Choose channels for the task: the URL is
 to the whole board. Posts and replies may sync to the team's Slack, GitHub,
 or WhatsApp. Automatic wakeups and subscriptions aren't part of this skill.
 The skill installation is global per user with `-g`; omit it to install in

package/dist/{a2-NMEbIKNZ.mjs → a2-CQ3WcqMv.mjs}

@@ -1,15 +1,15 @@
 import { n as DIRECT_UPLOAD_BYTES_MAX, r as IMPORT_BYTES_MAX, t as ATTACHMENT_BYTES_MAX } from "./files-SniSmeEr.mjs";
 import { _ as RemoteWatcherId, b as actorKind, i as Attachment, x as platformAvatar } from "./schemas-Be08nyfW.mjs";
 import "./external-BV_cUncs.mjs";
-import { a as METHODS, d as VERSION, f as SYNC, n as compileWatcher, r as hasCriteria, t as canonicalWatchers } from "./watchers-hash-DYu8WWXj.mjs";
-import { r as duration, t as BoardError } from "./client-ClznIBMg.mjs";
+import { a as METHODS, d as VERSION, f as SYNC, n as compileWatcher, r as hasCriteria, t as canonicalWatchers } from "./watchers-hash-C4CJg7K1.mjs";
+import { r as duration, t as BoardError } from "./client-BY-BCggB.mjs";
 import { n as derivedId, r as isKeyIdOf } from "./ids-C6AYo1bu.mjs";
-import { a as forbidden, c as toErrorResponse, i as duplicateId, r as badRequest, s as notFound, t as HttpError } from "./errors-CQ-fwxM3.mjs";
+import { a as forbidden, c as toErrorResponse, i as duplicateId, r as badRequest, s as notFound, t as HttpError } from "./errors-Bven0k29.mjs";
 import { t as own } from "./own-OwgPWdmh.mjs";
 import { n as replaceMentions } from "./mentions-CB6ShY4R.mjs";
-import { _ as FULL_ACCESS, i as authenticates, v as authorize } from "./auth-5nLsx9qB.mjs";
-import { a as resolveMentions, n as actorSeen } from "./actors-rPnEQLZu.mjs";
-import { n as MIDDLEWARE_ACTOR, t as DroppedError } from "./middleware-DUjyQP_a.mjs";
+import { _ as FULL_ACCESS, i as authenticates, v as authorize } from "./auth-BwWH3Twu.mjs";
+import { a as resolveMentions, n as actorSeen } from "./actors-CDDhhFNY.mjs";
+import { n as MIDDLEWARE_ACTOR, t as DroppedError } from "./middleware-B0J7QBq7.mjs";
 import { n as syncTarget, r as withEmailMentions } from "./targets-C-wdR5wP.mjs";
 import { t as A2Error } from "./session-clear-wHd5GCpZ-BnKSxReK.mjs";
 import { a as reducer } from "./reducer-CjmvZSAb-D_OSISmj.mjs";

package/dist/access.mjs

@@ -1,4 +1,4 @@
-import { a as compileRules, c as githubActions, h as vercelProject, p as oidc } from "./auth-5nLsx9qB.mjs";
-import { i as resolveActor } from "./actors-rPnEQLZu.mjs";
-import { t as oidcTokens } from "./tokens-DUXaXwOj.mjs";
+import { a as compileRules, c as githubActions, h as vercelProject, p as oidc } from "./auth-BwWH3Twu.mjs";
+import { i as resolveActor } from "./actors-CDDhhFNY.mjs";
+import { t as oidcTokens } from "./tokens-U-XRlEfq.mjs";
 export { compileRules, githubActions, oidc, oidcTokens, resolveActor, vercelProject };

package/dist/{actors-rPnEQLZu.mjs → actors-CDDhhFNY.mjs}

@@ -1,8 +1,8 @@
 import { C as toStorable } from "./schemas-Be08nyfW.mjs";
-import { r as badRequest } from "./errors-CQ-fwxM3.mjs";
+import { r as badRequest } from "./errors-Bven0k29.mjs";
 import { t as own } from "./own-OwgPWdmh.mjs";
 import { t as extractMentions } from "./mentions-CB6ShY4R.mjs";
-import { y as parseScope } from "./auth-5nLsx9qB.mjs";
+import { y as parseScope } from "./auth-BwWH3Twu.mjs";
 //#region src/server/actors.ts
 /** Agents whose avatars the board serves itself. */
 const KNOWN_AGENTS = [

package/dist/{auth-5nLsx9qB.mjs → auth-BwWH3Twu.mjs}

@@ -1,5 +1,5 @@
 import { c as ChannelPath, v as SCOPE_MAX } from "./schemas-Be08nyfW.mjs";
-import { a as forbidden, l as unauthorized } from "./errors-CQ-fwxM3.mjs";
+import { a as forbidden, l as unauthorized } from "./errors-Bven0k29.mjs";
 //#region src/server/access.ts
 /**
 * What a principal may do in a channel. `read` covers messages, threads,

package/dist/{backend-CWmd4UH-.d.mts → backend-DmXjVnil.d.mts}

@@ -2,7 +2,7 @@ import { t as Access } from "./access-CV96SYgr.mjs";
 import { m as RuleFunction, n as AccessRule, r as Authenticate, s as Granted, t as AccessFunction, u as Known } from "./auth-CU56Q2Xh.mjs";
 import { i as Attachment, o as Author, p as Labels } from "./schemas-CWxs3ECJ.mjs";
 import { t as Actor, u as ExternalEvent } from "./folds-CRYY14kc.mjs";
-import { $ as Discovery, $t as SyncCodeView, Bt as SchedulesQuery, Et as PostBody, F as BoardClient, Gt as SourceJoinBody, It as ScheduleBody, Jt as SourceReadQuery, Nt as RegistrationView, Qt as SyncCodeBody, St as MessagesQuery, Tt as PersonView, Wt as SourceJoin, X as BoardEventView, Yt as SyncAccountBody, Z as ChannelView, _t as MatchView, an as SyncImportBody, bn as UploadStartBody, bt as MessageView, ct as InboxEntry, dn as SyncUnlinkBody, dt as InboxPushBody, en as SyncCopiesQuery, et as EditBody, fn as SyncedView, ft as InboxQuery, gn as ThreadsQuery, gt as LinkedQuery, hn as ThreadsPage, ht as LinkedAccount, in as SyncFindView, jt as RegisterBody, kt as ReactBody, ln as SyncRootsQuery, lt as InboxItem, mn as ThreadView, nt as EventsQuery, ot as IdentityView, p as SyncProvider, pt as LabelBody, q as AckBody, qt as SourceRead, rn as SyncFindQuery, sn as SyncReceiptBody, st as InboxAckBody, tn as SyncCopiesView, tt as EventsPage, un as SyncThreadView, ut as InboxNextQuery, vn as TypingBody, vt as MatchesQuery, xn as UploadTicket, xt as MessagesPage, yt as Me, z as ProfileOption, zt as ScheduleView } from "./provider-D11Dfda0.mjs";
+import { $ as Discovery, $t as SyncCodeView, Bt as SchedulesQuery, Et as PostBody, F as BoardClient, Gt as SourceJoinBody, It as ScheduleBody, Jt as SourceReadQuery, Nt as RegistrationView, Qt as SyncCodeBody, St as MessagesQuery, Tt as PersonView, Wt as SourceJoin, X as BoardEventView, Yt as SyncAccountBody, Z as ChannelView, _t as MatchView, an as SyncImportBody, bn as UploadStartBody, bt as MessageView, ct as InboxEntry, dn as SyncUnlinkBody, dt as InboxPushBody, en as SyncCopiesQuery, et as EditBody, fn as SyncedView, ft as InboxQuery, gn as ThreadsQuery, gt as LinkedQuery, hn as ThreadsPage, ht as LinkedAccount, in as SyncFindView, jt as RegisterBody, kt as ReactBody, ln as SyncRootsQuery, lt as InboxItem, mn as ThreadView, nt as EventsQuery, ot as IdentityView, p as SyncProvider, pt as LabelBody, q as AckBody, qt as SourceRead, rn as SyncFindQuery, sn as SyncReceiptBody, st as InboxAckBody, tn as SyncCopiesView, tt as EventsPage, un as SyncThreadView, ut as InboxNextQuery, vn as TypingBody, vt as MatchesQuery, xn as UploadTicket, xt as MessagesPage, yt as Me, z as ProfileOption, zt as ScheduleView } from "./provider-C_sj4-GL.mjs";
 import { z } from "zod";
 //#region src/api/protocol.d.ts
 type Input<S extends z.ZodType> = NonNullable<z.output<S>>;
@@ -298,7 +298,11 @@ type Method = keyof Protocol;
 declare class HttpError extends Error {
   readonly status: number;
   readonly code: string;
-  constructor(status: number, code: string, message: string);
+  /** What fixes it, when the handle that raised it knows (`BoardError`'s `hint`). */
+  readonly hint: string | undefined;
+  constructor(status: number, code: string, message: string, options?: {
+    hint?: string;
+  });
 }
 //#endregion
 //#region src/server/middleware.d.ts
@@ -471,7 +475,7 @@ type BoardOptions = PolicyOptions & {
   /**
    * Where the board lives: `a2({ … })` from `@vercel/board/backend-a2` keeps it here, `http(url)` from
    * `@vercel/board/backend-http` uses another, or your own. By default, `http()`: in Node, the board the
-   * environment points at (`BOARD_URL`, the repo's link, or `vb use`'s).
+   * environment points at (`BOARD_URL`).
    */
   backend?: Backend;
   /**

package/dist/backend-a2.d.mts

@@ -2,8 +2,8 @@ import { i as Attachment } from "./schemas-CWxs3ECJ.mjs";
 import { t as Actor } from "./folds-CRYY14kc.mjs";
 import { l as Reducer, r as ContractEvent } from "./reducer-CYPHsSmd-BQIfozGi.mjs";
 import { a as SessionAppend, c as SessionConsumeOptions, d as SessionSchedule, f as StateOptions, l as SessionConsumeResult, n as A2Server, o as SessionClearOptions, p as SessionCleared, r as Consumer, s as SessionClearResult, t as A2Scheduler, u as SessionDeadLetters } from "./server-qgez0Xny-D5mLfqFQ.mjs";
-import { $ as Discovery, $t as SyncCodeView, Nt as RegistrationView, Tt as PersonView, Wt as SourceJoin, Z as ChannelView, _t as MatchView, bt as MessageView, ct as InboxEntry, fn as SyncedView, hn as ThreadsPage, ht as LinkedAccount, in as SyncFindView, lt as InboxItem, mn as ThreadView, ot as IdentityView, qt as SourceRead, tn as SyncCopiesView, tt as EventsPage, un as SyncThreadView, xn as UploadTicket, xt as MessagesPage, yt as Me, zt as ScheduleView } from "./provider-D11Dfda0.mjs";
-import { i as Caller, n as BackendRoute, r as BoardBinding } from "./backend-CWmd4UH-.mjs";
+import { $ as Discovery, $t as SyncCodeView, Nt as RegistrationView, Tt as PersonView, Wt as SourceJoin, Z as ChannelView, _t as MatchView, bt as MessageView, ct as InboxEntry, fn as SyncedView, hn as ThreadsPage, ht as LinkedAccount, in as SyncFindView, lt as InboxItem, mn as ThreadView, ot as IdentityView, qt as SourceRead, tn as SyncCopiesView, tt as EventsPage, un as SyncThreadView, xn as UploadTicket, xt as MessagesPage, yt as Me, zt as ScheduleView } from "./provider-C_sj4-GL.mjs";
+import { i as Caller, n as BackendRoute, r as BoardBinding } from "./backend-DmXjVnil.mjs";
 import { n as fsBlob, r as memoryBlob, t as BlobStore } from "./blob-C0J3wbGv.mjs";
 import { t as BoardStore } from "./types-8yq2VnKI.mjs";
 import { z } from "zod";

package/dist/backend-a2.mjs

@@ -1,2 +1,2 @@
-import { n as fsBlob, r as memoryBlob, t as a2 } from "./a2-NMEbIKNZ.mjs";
+import { n as fsBlob, r as memoryBlob, t as a2 } from "./a2-CQ3WcqMv.mjs";
 export { a2, fsBlob, memoryBlob };

package/dist/{backend-http-DQUsVgML.mjs → backend-http-BJ7AdK0c.mjs}

@@ -1,9 +1,9 @@
 import "./files-SniSmeEr.mjs";
 import "./schemas-Be08nyfW.mjs";
-import { K as routes, O as RegisterBody, a as METHODS, n as compileWatcher, t as canonicalWatchers } from "./watchers-hash-DYu8WWXj.mjs";
-import { n as createBoardClient, t as BoardError } from "./client-ClznIBMg.mjs";
+import { K as routes, O as RegisterBody, a as METHODS, n as compileWatcher, t as canonicalWatchers } from "./watchers-hash-C4CJg7K1.mjs";
+import { n as createBoardClient, t as BoardError } from "./client-BY-BCggB.mjs";
 import { a as sha256, i as keyId, n as derivedId, t as DERIVED_ID } from "./ids-C6AYo1bu.mjs";
-import { a as forbidden, o as json, t as HttpError } from "./errors-CQ-fwxM3.mjs";
+import { a as forbidden, o as json, t as HttpError } from "./errors-Bven0k29.mjs";
 //#region src/server/registrant.ts
 /** Registering again this soon after the same registration only repeats it. */
 const REGISTER_EVERY_MS = 1e4;
@@ -239,7 +239,7 @@ function scopeOf(identity) {
 const describe = (error) => ((error instanceof Error ? error.message : String(error)) || "unknown error").slice(0, 500);
 /** The SDK's error, as the board answers it: the remote's own status and code, or 502 when it never answered. */
 const rethrow = (error) => {
-	if (error instanceof BoardError) throw new HttpError(error.status >= 400 ? error.status : 502, error.code, error.message);
+	if (error instanceof BoardError) throw new HttpError(error.status >= 400 ? error.status : 502, error.code, error.message, error.hint !== void 0 ? { hint: error.hint } : {});
 	if (error instanceof HttpError || error instanceof Error && error.name === "AbortError") throw error;
 	throw new HttpError(502, "unreachable", `the board didn't answer: ${describe(error)}`);
 };
@@ -339,7 +339,7 @@ function createHttp(url, options, environment) {
 	let discovered = null;
 	/** The board it uses' discovery, for a handle here: who it is, and the sync entries it lists. */
 	const discovery = () => (discovered ??= doFetch(remote).then(async (response) => {
-		if (!response.ok) throw new HttpError(response.status >= 400 ? response.status : 502, "no_board", `no board at ${remote} (${response.status})`);
+		if (!response.ok) throw new HttpError(response.status >= 400 ? response.status : 502, "no_board", `There's no board at ${remote}: it answered ${response.status}.`);
 		return await response.json();
 	}, rethrow)).catch((error) => {
 		discovered = null;
@@ -395,7 +395,7 @@ function createHttp(url, options, environment) {
 		if (response.ok) return response;
 		try {
 			const body = await response.json();
-			if (body.error?.message) throw new HttpError(response.status, body.error.code ?? "error", body.error.message);
+			if (body.error?.message) throw new HttpError(response.status, body.error.code ?? "error", body.error.message, typeof body.error.hint === "string" ? { hint: body.error.hint } : {});
 		} catch (error) {
 			if (error instanceof HttpError) throw error;
 		}

package/dist/{backend-http-BfWQfvqB.d.mts → backend-http-BsP0Xq9e.d.mts}

@@ -1,7 +1,7 @@
 import { i as Attachment } from "./schemas-CWxs3ECJ.mjs";
 import { t as Actor } from "./folds-CRYY14kc.mjs";
-import { $ as Discovery, $t as SyncCodeView, Nt as RegistrationView, Tt as PersonView, Wt as SourceJoin, Z as ChannelView, _t as MatchView, bt as MessageView, ct as InboxEntry, fn as SyncedView, hn as ThreadsPage, ht as LinkedAccount, in as SyncFindView, lt as InboxItem, mn as ThreadView, ot as IdentityView, qt as SourceRead, tn as SyncCopiesView, tt as EventsPage, un as SyncThreadView, xn as UploadTicket, xt as MessagesPage, yt as Me, z as ProfileOption, zt as ScheduleView } from "./provider-D11Dfda0.mjs";
-import { i as Caller, n as BackendRoute, r as BoardBinding } from "./backend-CWmd4UH-.mjs";
+import { $ as Discovery, $t as SyncCodeView, Nt as RegistrationView, Tt as PersonView, Wt as SourceJoin, Z as ChannelView, _t as MatchView, bt as MessageView, ct as InboxEntry, fn as SyncedView, hn as ThreadsPage, ht as LinkedAccount, in as SyncFindView, lt as InboxItem, mn as ThreadView, ot as IdentityView, qt as SourceRead, tn as SyncCopiesView, tt as EventsPage, un as SyncThreadView, xn as UploadTicket, xt as MessagesPage, yt as Me, z as ProfileOption, zt as ScheduleView } from "./provider-C_sj4-GL.mjs";
+import { i as Caller, n as BackendRoute, r as BoardBinding } from "./backend-DmXjVnil.mjs";
 //#region src/server/backend-http.d.ts
 type HttpOptions = {
   /**

package/dist/{backend-http-D_rjJVmW.mjs → backend-http-Cs-UKpYp.mjs}

@@ -1,5 +1,5 @@
-import { r as createHttp } from "./backend-http-DQUsVgML.mjs";
-import { i as environmentProfile, r as connect, t as boardUrl } from "./node-BeKPcokJ.mjs";
+import { r as createHttp } from "./backend-http-BJ7AdK0c.mjs";
+import { n as connect, r as environmentProfile, t as boardUrl } from "./node-C51_xzCb.mjs";
 //#region src/backend-http/index.ts
 const environment = {
 	url: boardUrl,
@@ -8,7 +8,7 @@ const environment = {
 };
 /**
 * The board at `url`, which keeps the log: this board uses it as this deployment. Without a
-* `url`, the one the environment points at: `BOARD_URL`, the repo's link, or `vb use`'s.
+* `url`, the one the environment points at: `BOARD_URL`.
 * Without a `fetch`, it sends the credentials `vb` would.
 */
 function http(url, options = {}) {

package/dist/backend-http.d.mts

@@ -1,4 +1,4 @@
-import { n as HttpOptions, t as HttpBackend } from "./backend-http-BfWQfvqB.mjs";
+import { n as HttpOptions, t as HttpBackend } from "./backend-http-BsP0Xq9e.mjs";
 //#region src/backend-http/index.default.d.ts
 /**
  * The board at `url`, which keeps the log. Outside Node there's no environment to find it or a

package/dist/backend-http.mjs

@@ -1,2 +1,2 @@
-import { t as http } from "./index.default-TBybqjGV.mjs";
+import { t as http } from "./index.default-DmfhBZZi.mjs";
 export { http };

package/dist/backend-http.node.d.mts

@@ -1,8 +1,8 @@
-import { n as HttpOptions, t as HttpBackend } from "./backend-http-BfWQfvqB.mjs";
+import { n as HttpOptions, t as HttpBackend } from "./backend-http-BsP0Xq9e.mjs";
 //#region src/backend-http/index.d.ts
 /**
  * The board at `url`, which keeps the log: this board uses it as this deployment. Without a
- * `url`, the one the environment points at: `BOARD_URL`, the repo's link, or `vb use`'s.
+ * `url`, the one the environment points at: `BOARD_URL`.
  * Without a `fetch`, it sends the credentials `vb` would.
  */
 export declare function http(url?: string, options?: HttpOptions): HttpBackend;

package/dist/backend-http.node.mjs

@@ -1,2 +1,2 @@
-import { t as http } from "./backend-http-D_rjJVmW.mjs";
+import { t as http } from "./backend-http-Cs-UKpYp.mjs";
 export { http };

package/dist/{backend-vercel-BSuIfOyF.mjs → backend-vercel-B0Q0K0O5.mjs}

@@ -1,6 +1,6 @@
-import { t as HttpError } from "./errors-CQ-fwxM3.mjs";
-import { c as vercelLogin, i as environmentProfile, l as vercelProjectFile } from "./node-BeKPcokJ.mjs";
-import { t as createVercel } from "./backend-vercel-BWVAihZC.mjs";
+import { t as HttpError } from "./errors-Bven0k29.mjs";
+import { o as vercelLogin, r as environmentProfile, s as vercelProjectFile } from "./node-C51_xzCb.mjs";
+import { t as createVercel } from "./backend-vercel-CG2SYa03.mjs";
 import { readFile } from "node:fs/promises";
 import { decodeJwt } from "jose";
 import { getVercelOidcToken } from "@vercel/oidc";

package/dist/{backend-vercel-CYOqtLPc.d.mts → backend-vercel-CED673bx.d.mts}

@@ -1,7 +1,7 @@
 import { i as Attachment } from "./schemas-CWxs3ECJ.mjs";
 import { t as Actor } from "./folds-CRYY14kc.mjs";
-import { $ as Discovery, $t as SyncCodeView, Nt as RegistrationView, Tt as PersonView, Wt as SourceJoin, Z as ChannelView, _t as MatchView, bt as MessageView, ct as InboxEntry, fn as SyncedView, hn as ThreadsPage, ht as LinkedAccount, in as SyncFindView, lt as InboxItem, mn as ThreadView, ot as IdentityView, qt as SourceRead, tn as SyncCopiesView, tt as EventsPage, un as SyncThreadView, xn as UploadTicket, xt as MessagesPage, yt as Me, z as ProfileOption, zt as ScheduleView } from "./provider-D11Dfda0.mjs";
-import { i as Caller, n as BackendRoute, r as BoardBinding } from "./backend-CWmd4UH-.mjs";
+import { $ as Discovery, $t as SyncCodeView, Nt as RegistrationView, Tt as PersonView, Wt as SourceJoin, Z as ChannelView, _t as MatchView, bt as MessageView, ct as InboxEntry, fn as SyncedView, hn as ThreadsPage, ht as LinkedAccount, in as SyncFindView, lt as InboxItem, mn as ThreadView, ot as IdentityView, qt as SourceRead, tn as SyncCopiesView, tt as EventsPage, un as SyncThreadView, xn as UploadTicket, xt as MessagesPage, yt as Me, z as ProfileOption, zt as ScheduleView } from "./provider-C_sj4-GL.mjs";
+import { i as Caller, n as BackendRoute, r as BoardBinding } from "./backend-DmXjVnil.mjs";
 //#region src/server/backend-vercel.d.ts
 type VercelOptions = {
   /** The team whose board it is: its ID (`team_…`) or its slug. In Node, by default your deployment's, or `VERCEL_ORG_ID`. */

package/dist/{backend-vercel-BWVAihZC.mjs → backend-vercel-CG2SYa03.mjs}

@@ -1,8 +1,8 @@
 import { _ as RemoteWatcherId } from "./schemas-Be08nyfW.mjs";
-import { O as RegisterBody, a as METHODS, d as VERSION, n as compileWatcher, t as canonicalWatchers } from "./watchers-hash-DYu8WWXj.mjs";
+import { O as RegisterBody, a as METHODS, d as VERSION, n as compileWatcher, t as canonicalWatchers } from "./watchers-hash-C4CJg7K1.mjs";
 import { a as sha256, n as derivedId } from "./ids-C6AYo1bu.mjs";
-import { a as forbidden, o as json, s as notFound, t as HttpError } from "./errors-CQ-fwxM3.mjs";
-import { a as wakePath, i as registrant, n as callerProfile, t as PROJECTS_OWN } from "./backend-http-DQUsVgML.mjs";
+import { a as forbidden, o as json, s as notFound, t as HttpError } from "./errors-Bven0k29.mjs";
+import { a as wakePath, i as registrant, n as callerProfile, t as PROJECTS_OWN } from "./backend-http-BJ7AdK0c.mjs";
 //#region src/server/backend-vercel.ts
 const PROFILE = /^[A-Za-z][A-Za-z0-9-]{0,31}$/;
 const SESSION = /^[A-Za-z0-9_.:-]{1,128}$/;

package/dist/backend-vercel.d.mts

@@ -1,4 +1,4 @@
-import { n as VercelOptions, t as VercelBackend } from "./backend-vercel-CYOqtLPc.mjs";
+import { n as VercelOptions, t as VercelBackend } from "./backend-vercel-CED673bx.mjs";
 //#region src/backend-vercel/index.default.d.ts
 /**
  * Your team's board, in Vercel's API. Outside Node there's no environment to find credentials or

package/dist/backend-vercel.mjs

@@ -1,4 +1,4 @@
-import { t as createVercel } from "./backend-vercel-BWVAihZC.mjs";
+import { t as createVercel } from "./backend-vercel-CG2SYa03.mjs";
 //#region src/backend-vercel/index.default.ts
 /**
 * Your team's board, in Vercel's API. Outside Node there's no environment to find credentials or

package/dist/backend-vercel.node.d.mts

@@ -1,4 +1,4 @@
-import { n as VercelOptions, t as VercelBackend } from "./backend-vercel-CYOqtLPc.mjs";
+import { n as VercelOptions, t as VercelBackend } from "./backend-vercel-CED673bx.mjs";
 //#region src/backend-vercel/index.d.ts
 /** Where `token` comes from, in words: what `vb whoami` says. */
 export declare function credentialSource(): string;

package/dist/backend-vercel.node.mjs

@@ -1,2 +1,2 @@
-import { n as vercel, t as credentialSource } from "./backend-vercel-BSuIfOyF.mjs";
+import { n as vercel, t as credentialSource } from "./backend-vercel-B0Q0K0O5.mjs";
 export { credentialSource, vercel };

package/dist/{chat-provider-D0k3y8zY.d.mts → chat-provider-6eYkL2ef.d.mts}

@@ -1,5 +1,5 @@
 import { d as ExternalFile, f as ExternalLink, l as ExternalAuthor, t as Actor } from "./folds-CRYY14kc.mjs";
-import { M as SyncRoot, O as ProviderEvent, Wt as SourceJoin, a as ProviderOptions, c as ReceivedEvent, d as ResolvedTarget, i as ProviderFile, n as FileDelivery, o as ProviderPost, p as SyncProvider, qt as SourceRead, r as ProviderDelivery, s as Receive, t as FetchedLink, y as SyncFn } from "./provider-D11Dfda0.mjs";
+import { M as SyncRoot, O as ProviderEvent, Wt as SourceJoin, a as ProviderOptions, c as ReceivedEvent, d as ResolvedTarget, i as ProviderFile, n as FileDelivery, o as ProviderPost, p as SyncProvider, qt as SourceRead, r as ProviderDelivery, s as Receive, t as FetchedLink, y as SyncFn } from "./provider-C_sj4-GL.mjs";
 import { Adapter, Author, FileUpload, Message, ReactionEvent } from "chat";
 //#region src/sync/types.d.ts
 declare function externalAuthor(platform: string, author: Author): ExternalAuthor;

package/dist/cli-commands.mjs

@@ -1,2 +1,2 @@
-import { a as option, i as groups, n as filters, o as options, r as globalOptions, s as usage, t as commands } from "./commands-D_ODblQY.mjs";
+import { a as option, i as groups, n as filters, o as options, r as globalOptions, s as usage, t as commands } from "./commands-BtL4jFq8.mjs";
 export { commands, filters, globalOptions, groups, option, options, usage };

package/dist/cli-embedded.d.mts

@@ -1,5 +1,47 @@
-import { d as Board } from "./backend-CWmd4UH-.mjs";
-import "./index-DsMPCv_K.mjs";
+import { d as Board } from "./backend-DmXjVnil.mjs";
+import "./index-k2LfZxl-.mjs";
+//#region src/cli/failure.d.ts
+/**
+ * What kind of failure it is, which fixes the exit code: 2 for `usage` and `missing_input`, 124
+ * for `timeout`, 130 for `canceled`, and 1 for the rest.
+ */
+type FailureClass = 'usage' | 'missing_input' | 'auth' | 'permission' | 'not_found' | 'conflict' | 'limit' | 'rate_limit' | 'network' | 'platform' | 'timeout' | 'canceled' | 'unknown';
+/** One way out: what to do, and the command that does it, whole (`['vb', 'read', 'dev', '--scope', '<TEAM>']`). */
+type Recovery = {
+  instruction: string;
+  argv?: string[];
+};
+type Failure = {
+  class: FailureClass;
+  /** Stable and snake_case: what a program branches on. */
+  reason: string;
+  /** The headline: what failed, then the known cause, as sentences. */
+  message: string;
+  /** What the headline can't hold, a line each: the board's own message, say. */
+  details?: string[];
+  /** Facts needed to act on it, as rows: `['Board', 'https://…']`. */
+  context?: [string, string][];
+  /** At most two, likeliest first. */
+  next?: Recovery[];
+  /** Blocked before anything happened, until someone gives it what it needs (a team, say). */
+  actionRequired?: boolean;
+  /** For programs: what the CLI resolved, and the board's own error (`{ code, message }`) when it answered with one. */
+  data?: Record<string, unknown>;
+};
+/** A write went through, with something to say about it. */
+type Warning = {
+  reason: string;
+  message: string;
+};
+/** A recovery's command, as a person types it. */
+export declare const commandLine: (argv: readonly string[]) => string;
+/**
+ * The failure as lines, the headline first and the rest as they sit under it, before the indent a
+ * CLI adds under its own mark (`error: `, `✗ `): details, context rows, then each way out after a
+ * blank line, its command two spaces in.
+ */
+export declare function failureLines(failure: Failure): string[];
+//#endregion
 //#region src/cli/main.d.ts
 /**
  * The command `argv` runs, by its own name (`delete` for `rm`), as the parser reads it: the
@@ -13,11 +55,19 @@ export declare function commandWord(argv: string[]): string | undefined;
  * Board's CLI as `appName` names it in help, usage, and errors (`vercel board`). With no board
  * URL anywhere, it talks to the team's board in Vercel's API: `VERCEL_ORG_ID`'s, the nearest linked
  * project's team's (`.vercel`), your login's, or `--scope`'s. `run` takes what follows the name, and answers the exit code:
- * 0 success, 1 error, 2 misuse, 124 when `wait` times out. It never exits the process itself. One `run`
+ * 0 success, 1 error, 2 misuse, 124 when `wait` times out, 130 when Ctrl-C stops it. It never exits the process itself. One `run`
  * at a time: a run's flags are the CLI's while it runs.
+ *
+ * A failure goes to `onError`, with whether the run asked for `--json`, to show as the app shows
+ * its own, and a warning to `onWarning` (with `--json`, it's in the result). Without them, the CLI
+ * prints its own on stderr.
  */
 export declare function createApp(options: {
   appName: string;
+  onError?: (failure: Failure, mode: {
+    json: boolean;
+  }) => void;
+  onWarning?: (warning: Warning) => void;
 }): {
   run(args: string[]): Promise<number>;
 };
@@ -43,9 +93,10 @@ export type VbResult = {
 /**
  * Runs the vb command `argv` (`['read', '42']`, `['reply', '42', 'on it']`) on `board`, in this
  * process, and returns what the CLI would print. `board` already says which board and who, so
- * `--url` and `--handle` don't apply, and the commands about your machine (`link`, `use`, `whoami`,
- * `identity`, `hooks`, `serve`, `inspect`) answer 2. Calls run one at a time, in order, so
+ * `--url` and `--handle` don't apply, and the commands about your machine (`whoami`, `identity`,
+ * `hooks`, `serve`, `inspect`) answer 2. Calls run one at a time, in order, so
  * `tail` and `wait`, which hold the rest until they end, need `options.signal`.
  */
 export declare function vb(board: Board, argv: string[], options?: VbOptions): Promise<VbResult>;
-//#endregion
+//#endregion
+export type { Failure, FailureClass, Recovery, Warning };

package/dist/cli-embedded.mjs

@@ -1,41 +1,61 @@
-import { n as main, r as mainWith, t as commandWord } from "./main-B5BCEQ0l.mjs";
+import { a as commandLine, c as failureLines, i as mainWith, l as formatFailure, n as commandWord, o as exitCode, r as main, s as failureDocument, t as Failed } from "./main-BNkywL2P.mjs";
 //#region src/cli/embedded.ts
 /**
 * Board's CLI as `appName` names it in help, usage, and errors (`vercel board`). With no board
 * URL anywhere, it talks to the team's board in Vercel's API: `VERCEL_ORG_ID`'s, the nearest linked
 * project's team's (`.vercel`), your login's, or `--scope`'s. `run` takes what follows the name, and answers the exit code:
-* 0 success, 1 error, 2 misuse, 124 when `wait` times out. It never exits the process itself. One `run`
+* 0 success, 1 error, 2 misuse, 124 when `wait` times out, 130 when Ctrl-C stops it. It never exits the process itself. One `run`
 * at a time: a run's flags are the CLI's while it runs.
+*
+* A failure goes to `onError`, with whether the run asked for `--json`, to show as the app shows
+* its own, and a warning to `onWarning` (with `--json`, it's in the result). Without them, the CLI
+* prints its own on stderr.
 */
 function createApp(options) {
+	const { appName, onError, onWarning } = options;
 	return { run: (args) => main(args, {
-		name: options.appName,
+		name: appName,
 		commands: {},
-		teamBoard: true
+		teamBoard: true,
+		...onError ? { onError } : {},
+		...onWarning ? { onWarning } : {}
 	}) };
 }
-const lacking = (what) => async () => {
-	throw new Error(`${what}: pass it in vb()'s options`);
+const lacking = (what, option) => async () => {
+	throw new Failed({
+		class: "usage",
+		reason: "not_available",
+		message: `${what} here: pass ${option} in vb()'s options.`
+	});
 };
+/** A call `vb()` answers itself, printed as the CLI would print it. */
+function refused(argv, failure) {
+	const stderr = argv.slice(0, argv.includes("--") ? argv.indexOf("--") : void 0).includes("--json") ? JSON.stringify(failureDocument(failure)) : formatFailure(failure);
+	return Promise.resolve({
+		code: exitCode(failure),
+		stdout: "",
+		stderr: `${stderr}\n`
+	});
+}
 let queue = Promise.resolve();
 /**
 * Runs the vb command `argv` (`['read', '42']`, `['reply', '42', 'on it']`) on `board`, in this
 * process, and returns what the CLI would print. `board` already says which board and who, so
-* `--url` and `--handle` don't apply, and the commands about your machine (`link`, `use`, `whoami`,
-* `identity`, `hooks`, `serve`, `inspect`) answer 2. Calls run one at a time, in order, so
+* `--url` and `--handle` don't apply, and the commands about your machine (`whoami`, `identity`,
+* `hooks`, `serve`, `inspect`) answer 2. Calls run one at a time, in order, so
 * `tail` and `wait`, which hold the rest until they end, need `options.signal`.
 */
 function vb(board, argv, options = {}) {
 	const word = commandWord(argv);
-	if (word !== void 0 && options.refuse?.includes(word)) return Promise.resolve({
-		code: 2,
-		stdout: "",
-		stderr: `error: ${word} isn't available here\n`
+	if (word !== void 0 && options.refuse?.includes(word)) return refused(argv, {
+		class: "usage",
+		reason: "not_available",
+		message: `${word} isn't available here.`
 	});
-	if ((word === "tail" || word === "wait") && !options.signal) return Promise.resolve({
-		code: 2,
-		stdout: "",
-		stderr: `error: ${word} runs until it's stopped, and vb() runs one call at a time: pass a signal\n`
+	if ((word === "tail" || word === "wait") && !options.signal) return refused(argv, {
+		class: "usage",
+		reason: "not_available",
+		message: `${word} runs until it's stopped, and vb() runs one call at a time: pass a signal.`
 	});
 	const result = queue.then(async () => {
 		let stdout = "";
@@ -49,9 +69,9 @@ function vb(board, argv, options = {}) {
 				board,
 				write: (chunk) => void (stdout += typeof chunk === "string" ? chunk : decoder.decode(chunk, { stream: true })),
 				error: (chunk) => void (stderr += chunk),
-				readFile: options.readFile ? async (path) => options.readFile(path) : lacking("--attach reads files"),
-				writeFile: options.writeFile ? async (path, data) => options.writeFile(path, data) : lacking("download saves files"),
-				stdin: options.stdin !== void 0 ? async () => options.stdin : lacking("- reads stdin"),
+				readFile: options.readFile ? async (path) => options.readFile(path) : lacking("--attach can't read files", "readFile"),
+				writeFile: options.writeFile ? async (path, data) => options.writeFile(path, data) : lacking("download can't save files", "writeFile"),
+				stdin: options.stdin !== void 0 ? async () => options.stdin : lacking("- can't read stdin", "stdin"),
 				...options.signal ? { signal: options.signal } : {}
 			}),
 			stdout,
@@ -62,4 +82,4 @@ function vb(board, argv, options = {}) {
 	return result;
 }
 //#endregion
-export { commandWord, createApp, vb };
+export { commandLine, commandWord, createApp, failureLines, vb };