@vercel/board 0.24.0 → 0.25.0

package/dist/{a2-BxfKZFvJ.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-C_1jGA53.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-D0GDYiFr.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

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-D0GDYiFr.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-BxfKZFvJ.mjs";
+import { n as fsBlob, r as memoryBlob, t as a2 } from "./a2-CQ3WcqMv.mjs";
 export { a2, fsBlob, memoryBlob };

package/dist/{backend-http-rfiG-AKP.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-C_1jGA53.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-Dvq2p__1.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-D0GDYiFr.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-tGUo0e8j.mjs → backend-http-Cs-UKpYp.mjs}

@@ -1,5 +1,5 @@
-import { r as createHttp } from "./backend-http-rfiG-AKP.mjs";
-import { n as connect, r as environmentProfile, t as boardUrl } from "./node-CirFYqw0.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,

package/dist/backend-http.d.mts

@@ -1,4 +1,4 @@
-import { n as HttpOptions, t as HttpBackend } from "./backend-http-Dvq2p__1.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-B6oPlvEa.mjs";
+import { t as http } from "./index.default-DmfhBZZi.mjs";
 export { http };

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

@@ -1,4 +1,4 @@
-import { n as HttpOptions, t as HttpBackend } from "./backend-http-Dvq2p__1.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

package/dist/backend-http.node.mjs

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

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

@@ -1,6 +1,6 @@
-import { t as HttpError } from "./errors-CQ-fwxM3.mjs";
-import { o as vercelLogin, r as environmentProfile, s as vercelProjectFile } from "./node-CirFYqw0.mjs";
-import { t as createVercel } from "./backend-vercel-DM5PyMc2.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-01QKDobk.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-D0GDYiFr.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-DM5PyMc2.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-C_1jGA53.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-rfiG-AKP.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-01QKDobk.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-DM5PyMc2.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-01QKDobk.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-C3zuxmcD.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-embedded.d.mts

@@ -1,5 +1,47 @@
-import { d as Board } from "./backend-D0GDYiFr.mjs";
-import "./index-B_hWanKF.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>;
 };
@@ -48,4 +98,5 @@ export type VbResult = {
  * `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,22 +1,42 @@
-import { n as main, r as mainWith, t as commandWord } from "./main-CzWvRy91.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
@@ -27,15 +47,15 @@ let queue = Promise.resolve();
 */
 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 };

package/dist/cli.mjs

@@ -2,8 +2,8 @@
 import { t as ATTACHMENT_BYTES_MAX } from "./files-SniSmeEr.mjs";
 import "./schemas-Be08nyfW.mjs";
 import { a as option } from "./commands-BtL4jFq8.mjs";
-import { a as projectDir } from "./node-CirFYqw0.mjs";
-import { i as who, n as main } from "./main-CzWvRy91.mjs";
+import { a as projectDir } from "./node-C51_xzCb.mjs";
+import { r as main, u as who } from "./main-BNkywL2P.mjs";
 import { randomBytes, timingSafeEqual } from "node:crypto";
 import { appendFile, readFile } from "node:fs/promises";
 import { join } from "node:path";
@@ -658,10 +658,10 @@ const local = {
 			}]
 		},
 		async run(args, { flags, out, usage, portFlag, connection, openBrowser }) {
-			if (args.length > 0) throw usage("usage: board serve [--port N] [--dir <dir>] [--no-inspect] [--no-open]");
+			if (args.length > 0) throw usage("serve takes no arguments: pass its port with --port, and its directory with --dir.");
 			const port = portFlag();
 			const root = projectDir();
-			const { localHandle, serveLocal } = await import("./serve-DHyA-6FR.mjs");
+			const { localHandle, serveLocal } = await import("./serve-DYQ64Q5R.mjs");
 			const handle = flags.handle ?? process.env.BOARD_HANDLE;
 			const local = await serveLocal({
 				dir: flags.dir ?? join(root, ".board"),

package/dist/{client-ClznIBMg.mjs → client-BY-BCggB.mjs}

@@ -39,14 +39,20 @@ async function* parseSse(body, signal) {
 }
 //#endregion
 //#region src/client/client.ts
+/**
+* What went wrong: `message` says what and why, `code` is what to branch on, and `hint`, when the
+* handle knows one, says what fixes it (`Set VERCEL_AUTOMATION_BYPASS_SECRET…`).
+*/
 var BoardError = class extends Error {
 	code;
 	status;
-	constructor(code, message, status) {
+	hint;
+	constructor(code, message, status, options = {}) {
 		super(message);
 		this.name = "BoardError";
 		this.code = code;
 		this.status = status;
+		this.hint = options.hint;
 	}
 };
 const resolve = async (value) => typeof value === "function" ? await value() : value;
@@ -76,7 +82,7 @@ const UNITS = {
 function duration(value) {
 	if (typeof value === "number") return value;
 	const match = value.trim().match(/^(\d+(?:\.\d+)?)(ms|s|m|h|d)?$/);
-	if (!match) throw new BoardError("invalid_duration", `invalid duration: ${value}`, 0);
+	if (!match) throw new BoardError("invalid_duration", `${value} isn't a duration like 30s, 10m, or 1h.`, 0);
 	return Number(match[1]) * UNITS[match[2] ?? "ms"];
 }
 /** A ref as a path segment: opaque, so it's encoded as it is. */
@@ -214,13 +220,13 @@ function createBoardClient(options) {
 			const type = input.type || (input.data instanceof Blob ? input.data.type : "") || typeOf(input.name);
 			const size = input.data instanceof Blob ? input.data.size : input.data.byteLength;
 			if (size > 4194304) {
-				if (size > 104857600) throw new BoardError("too_large", `attachments are at most ${DIRECT_UPLOAD_BYTES_MAX / 1024 / 1024} MB`, 413);
+				if (size > 104857600) throw new BoardError("too_large", `Attachments are at most ${DIRECT_UPLOAD_BYTES_MAX / 1024 / 1024} MB.`, 413);
 				const ticket = await call("POST", "/attachments/uploads", { body: {
 					name: input.name,
 					type,
 					size
 				} }).catch((error) => {
-					if (error instanceof BoardError && error.status === 404 && error.code === "not_found") throw new BoardError("too_large", `this board takes files of at most ${ATTACHMENT_BYTES_MAX / 1024 / 1024} MB`, 413);
+					if (error instanceof BoardError && error.status === 404 && error.code === "not_found") throw new BoardError("too_large", `This board takes files of at most ${ATTACHMENT_BYTES_MAX / 1024 / 1024} MB.`, 413);
 					throw error;
 				});
 				const put = await storeFetch(ticket.url, {
@@ -228,7 +234,7 @@ function createBoardClient(options) {
 					headers: ticket.headers,
 					body: input.data
 				});
-				if (!put.ok) throw new BoardError("upload_failed", `the blob store refused the file: ${put.status} ${(await put.text().catch(() => "")).slice(0, 300) || put.statusText}`, put.status);
+				if (!put.ok) throw new BoardError("upload_failed", `The blob store refused the file: ${put.status} ${(await put.text().catch(() => "")).slice(0, 300) || put.statusText}`, put.status);
 				return (await call("POST", `/attachments/uploads/${encodeURIComponent(ticket.id)}`, { body: {} })).attachment;
 			}
 			const response = await doFetch(`${base}/attachments`, {
@@ -382,9 +388,9 @@ function createBoardClient(options) {
 async function toError(response) {
 	try {
 		const body = await response.json();
-		if (body.error?.message) return new BoardError(body.error.code ?? "error", body.error.message, response.status);
+		if (body.error?.message) return new BoardError(body.error.code ?? "error", body.error.message, response.status, typeof body.error.hint === "string" ? { hint: body.error.hint } : {});
 	} catch {}
-	return new BoardError("http_error", `${response.status} ${response.statusText}`, response.status);
+	return new BoardError("http_error", `The board answered ${`${response.status} ${response.statusText}`.trim()}.`, response.status);
 }
 //#endregion
 export { createBoardClient as n, duration as r, BoardError as t };

package/dist/{conformance-DQ9qVzWP.mjs → conformance-BZ53bxrG.mjs}

@@ -1,4 +1,4 @@
-import { t as BoardError } from "./client-ClznIBMg.mjs";
+import { t as BoardError } from "./client-BY-BCggB.mjs";
 //#region src/conformance/index.ts
 var Mismatch = class extends Error {};
 const show = (value) => JSON.stringify(value) ?? String(value);

package/dist/conformance.d.mts

@@ -1,4 +1,4 @@
-import { d as Board } from "./backend-D0GDYiFr.mjs";
+import { d as Board } from "./backend-DmXjVnil.mjs";
 //#region src/conformance/index.d.ts
 /**
  * Checks that a board speaks the protocol, through a handle on it (`conformance(board())`), as

package/dist/conformance.mjs

@@ -1,2 +1,2 @@
-import { t as conformance } from "./conformance-DQ9qVzWP.mjs";
+import { t as conformance } from "./conformance-BZ53bxrG.mjs";
 export { conformance };

package/dist/{engine-kHfSOXnQ.mjs → engine-SeaJ_CIY.mjs}

@@ -3,9 +3,9 @@ import { C as toStorable, c as ChannelPath, m as MESSAGE_TEXT_MAX } from "./sche
 import { c as externalMessageKey, l as isThreadTarget, s as channelOf } from "./external-BV_cUncs.mjs";
 import { t as canonicalEmoji } from "./emoji-CTLpvH-A.mjs";
 import { n as derivedId } from "./ids-C6AYo1bu.mjs";
-import { r as badRequest, s as notFound, t as HttpError } from "./errors-CQ-fwxM3.mjs";
+import { r as badRequest, s as notFound, t as HttpError } from "./errors-Bven0k29.mjs";
 import { n as replaceMentions } from "./mentions-CB6ShY4R.mjs";
-import { t as DroppedError } from "./middleware-DUjyQP_a.mjs";
+import { t as DroppedError } from "./middleware-B0J7QBq7.mjs";
 import { n as waitUntil, t as afterRetry } from "./attempts-CLG840Oj.mjs";
 import { a as channelMissing, i as UnreadableError, n as ResolvedTarget, o as routesFor, t as ReceivedEvent } from "./provider-poIkXapd.mjs";
 import { a as immutable, n as SyncOverrides } from "./events-CewD4kw7.mjs";

package/dist/{errors-CQ-fwxM3.mjs → errors-Bven0k29.mjs}

@@ -3,10 +3,13 @@ import { ZodError } from "zod";
 var HttpError = class extends Error {
 	status;
 	code;
-	constructor(status, code, message) {
+	/** What fixes it, when the handle that raised it knows (`BoardError`'s `hint`). */
+	hint;
+	constructor(status, code, message, options = {}) {
 		super(message);
 		this.status = status;
 		this.code = code;
+		this.hint = options.hint;
 	}
 };
 /** A request a host's own verifier rejected with `response`, which the board answers with as it is. */
@@ -41,12 +44,13 @@ function reported(issue) {
 		path: [...issue.path, ...first.path]
 	}) : issue;
 }
-/** Every failure becomes `{ error: { code, message } }` with a matching status. */
+/** Every failure becomes `{ error: { code, message, hint? } }` with a matching status. */
 function toErrorResponse(error) {
 	if (error instanceof RejectedError) return error.response;
 	if (error instanceof HttpError) return json({ error: {
 		code: error.code,
-		message: error.message
+		message: error.message,
+		...error.hint !== void 0 ? { hint: error.hint } : {}
 	} }, error.status);
 	if (error instanceof ZodError) {
 		const issue = error.issues[0] && reported(error.issues[0]);

package/dist/{exports-Bw81oDDl.mjs → exports-ByvYtxFT.mjs}

@@ -1,12 +1,12 @@
 import { t as ATTACHMENT_BYTES_MAX } from "./files-SniSmeEr.mjs";
 import "./schemas-Be08nyfW.mjs";
-import { A as SchedulesQuery, B as SyncReceiptBody, C as MatchesQuery, D as Ref, E as ReactBody, F as SyncBody, G as UploadStartBody, H as SyncUnlinkBody, I as SyncCodeBody, L as SyncCopiesQuery, M as SourceJoinBody, N as SourceReadQuery, O as RegisterBody, P as SyncAccountBody, R as SyncFindQuery, S as LinkedQuery, T as PostBody, U as ThreadsQuery, V as SyncRootsQuery, W as TypingBody, _ as InboxAckBody, a as METHODS, b as InboxQuery, c as queryObject, d as VERSION, f as SYNC, g as IdentityUnlinkBody, h as EventsQuery, j as SignInQuery, k as ScheduleBody, l as readCapped, m as EditBody, o as createRouter, p as AckBody, s as openapi, u as readJson, v as InboxNextQuery, w as MessagesQuery, x as LabelBody, y as InboxPushBody, z as SyncImportBody } from "./watchers-hash-C_1jGA53.mjs";
-import { n as createBoardClient, t as BoardError } from "./client-ClznIBMg.mjs";
+import { A as SchedulesQuery, B as SyncReceiptBody, C as MatchesQuery, D as Ref, E as ReactBody, F as SyncBody, G as UploadStartBody, H as SyncUnlinkBody, I as SyncCodeBody, L as SyncCopiesQuery, M as SourceJoinBody, N as SourceReadQuery, O as RegisterBody, P as SyncAccountBody, R as SyncFindQuery, S as LinkedQuery, T as PostBody, U as ThreadsQuery, V as SyncRootsQuery, W as TypingBody, _ as InboxAckBody, a as METHODS, b as InboxQuery, c as queryObject, d as VERSION, f as SYNC, g as IdentityUnlinkBody, h as EventsQuery, j as SignInQuery, k as ScheduleBody, l as readCapped, m as EditBody, o as createRouter, p as AckBody, s as openapi, u as readJson, v as InboxNextQuery, w as MessagesQuery, x as LabelBody, y as InboxPushBody, z as SyncImportBody } from "./watchers-hash-C4CJg7K1.mjs";
+import { n as createBoardClient, t as BoardError } from "./client-BY-BCggB.mjs";
 import { n as derivedId } from "./ids-C6AYo1bu.mjs";
-import { a as forbidden, c as toErrorResponse, l as unauthorized, n as RejectedError, o as json, r as badRequest, s as notFound, t as HttpError } from "./errors-CQ-fwxM3.mjs";
-import { d as issuersOf, g as verifiesTokens, l as hostPrincipal, o as createAuthority, s as fromTokens } from "./auth-5nLsx9qB.mjs";
-import { i as resolveActor, r as claimsOf, t as KNOWN_AGENTS } from "./actors-rPnEQLZu.mjs";
-import { r as runMiddleware, t as DroppedError } from "./middleware-DUjyQP_a.mjs";
+import { a as forbidden, c as toErrorResponse, l as unauthorized, n as RejectedError, o as json, r as badRequest, s as notFound, t as HttpError } from "./errors-Bven0k29.mjs";
+import { d as issuersOf, g as verifiesTokens, l as hostPrincipal, o as createAuthority, s as fromTokens } from "./auth-BwWH3Twu.mjs";
+import { i as resolveActor, r as claimsOf, t as KNOWN_AGENTS } from "./actors-CDDhhFNY.mjs";
+import { r as runMiddleware, t as DroppedError } from "./middleware-B0J7QBq7.mjs";
 import { n as syncTarget, r as withEmailMentions, t as mentionsEmails } from "./targets-C-wdR5wP.mjs";
 //#region src/server/policy.ts
 /**