@vercel/board 0.29.0 → 0.30.0

package/dist/{internal-CvsrprnU-CRY89I-b.mjs → internal-CvsrprnU-zZMpDiRY.mjs}

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/experimental-a2@0.22.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__52060f00b21aecfab049c27fa3abd2f9/node_modules/experimental-a2/dist/internal-CvsrprnU.js
+//#region ../../node_modules/.pnpm/experimental-a2@0.24.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__b1e2c243a963f2620a5d202817417c26/node_modules/experimental-a2/dist/internal-CvsrprnU.js
 /**
 * A null-prototype record for maps keyed by caller-controlled strings
 * (participant ids, presence field names). On a normal object,

package/dist/{local-DhkrAqPP.mjs → local-C76Fy5ad.mjs}

@@ -1,4 +1,4 @@
-import { i as deliverSchedulerClear, r as deliverSchedulerAppend } from "./server-DtFrWxi3-Boa6gdWO.mjs";
+import { i as deliverSchedulerClear, r as deliverSchedulerAppend } from "./server-DX7mM6nm-D7N_7bug.mjs";
 //#region src/scheduler/local.ts
 /** The longest delay a timer takes: past it, `setTimeout` fires at once. */
 const MAX_DELAY = 2 ** 31 - 1;

package/dist/{main-CVBqe3VO.mjs → main-D2s-QBOK.mjs}

@@ -1,14 +1,14 @@
 import { i as fileSize, n as DIRECT_UPLOAD_BYTES_MAX } from "./files-SniSmeEr.mjs";
 import { a as AttachmentId } from "./schemas-DBmUO6pr.mjs";
-import { d as VERSION, i as withMentions } from "./watchers-hash-BDhLVkV5.mjs";
+import { d as VERSION, i as withMentions } from "./watchers-hash-B_5b0-ZG.mjs";
 import { n as displayEmoji, r as normalizeEmoji } from "./emoji-CTLpvH-A.mjs";
-import { t as BoardError } from "./client-D0Px7KzF.mjs";
-import { i as groups, n as filters$1, o as options, r as globalOptions, s as usage$1, t as commands } from "./commands-C3R1AWgm.mjs";
-import { a as handFetch, d as vercelProjectFile, n as boardUrl, o as handLogin, r as connect } from "./node-Zd_C-gxP.mjs";
-import { t as http } from "./backend-http-Bmp0IgD3.mjs";
-import { t as board } from "./server-BixV_byP.mjs";
-import { t as conformance } from "./conformance-DlnfuzEB.mjs";
-import { n as handTeam, r as vercel, t as credentialSource } from "./backend-vercel-DQc_TaHp.mjs";
+import { u as BoardError } from "./errors-C_5rB8Iz.mjs";
+import { i as groups, n as filters$1, o as options, r as globalOptions, s as usage$1, t as commands } from "./commands-B5DHjZKK.mjs";
+import { a as handFetch, d as vercelProjectFile, n as boardUrl, o as handLogin, r as connect } from "./node-D8Rtg1su.mjs";
+import { t as http } from "./backend-http-16SbvnAK.mjs";
+import { t as board } from "./server-D82a4uMe.mjs";
+import { t as conformance } from "./conformance-C7fwIvmN.mjs";
+import { n as handTeam, r as vercel, t as credentialSource } from "./backend-vercel-Kd8nvW5A.mjs";
 import { t as displayText } from "./bots-CGkO76qH.mjs";
 import { spawn } from "node:child_process";
 import { readFile, stat, writeFile } from "node:fs/promises";
@@ -83,7 +83,7 @@ function embed(link, pad) {
 /** One message as a block: header line, indented text, reactions. */
 function formatMessage(message, options = {}) {
 	const pad = options.reply ? "    " : "      ";
-	const head = `${options.reply ? "  ↳ " : ""}#${message.id}  ${authorName(message)} · ${ago(message.createdAt)}${message.editedAt ? " (edited)" : ""}${message.schedule ? ` · scheduled s${message.schedule.id}` : ""}${labels(message)}`;
+	const head = `${options.reply ? "  ↳ " : ""}#${message.id}  ${authorName(message)} · ${ago(message.createdAt)}${message.editedAt ? " (edited)" : ""}${message.schedule ? ` · scheduled ${message.schedule.id}` : ""}${labels(message)}`;
 	const body = message.deleted ? `${pad}(message removed)` : indent(displayText(message.text, message.by.actor), pad);
 	const files = (message.attachments ?? []).map((a) => `${pad}file ${a.name} · ${a.type} · ${fileSize(a.size)} · ${a.id}`);
 	const links = message.deleted ? [] : (message.links ?? []).flatMap((link) => embed(link, pad));
@@ -193,7 +193,7 @@ function formatSchedule(schedule, options = {}) {
 	const sent = schedule.sent > 0 ? ` · ${schedule.sent} sent` : "";
 	const files = schedule.attachments.length ? ` · ${schedule.attachments.length} ${schedule.attachments.length === 1 ? "file" : "files"}` : "";
 	const text = displayText(schedule.text, schedule.by.actor);
-	return [`${pad}s${schedule.id}  ${where} · ${repeat}${stop} · ${when}${sent}${files} · by ${authorName(schedule)}`, indent(text || "(no text)", `${pad}    `)].join("\n");
+	return [`${pad}${schedule.id}  ${where} · ${repeat}${stop} · ${when}${sent}${files} · by ${authorName(schedule)}`, indent(text || "(no text)", `${pad}    `)].join("\n");
 }
 /** One line per live event, for `tail` and `wait`. */
 function formatEvent(event) {
@@ -859,11 +859,18 @@ const tooLarge = (path) => new Failed({
 const isMessageRef = (value) => /^#[^\s/]+$/.test(value) || /^\d+$/.test(value);
 /** A message's ID as it's passed back: bare when it's a number, `#<id>` when it could be a channel's name. */
 const messageRef = (id) => /^\d+$/.test(id) ? id : `#${id}`;
-function labelPairs(values) {
+/** `--if-revision N`, as an edit or a delete takes it. */
+function ifRevision() {
+	const given = flags["if-revision"];
+	if (given === void 0) return {};
+	if (!/^[1-9]\d{0,15}$/.test(given)) throw usage(`--if-revision takes the message's revision, a number, and ${given} isn't one.`);
+	return { revision: Number(given) };
+}
+function labelPairs(values, wrong = "Labels look like key=value, and {value} isn't one.") {
 	const pairs = {};
 	for (const value of values ?? []) {
 		const at = value.indexOf("=");
-		if (at <= 0) throw usage(`Labels look like key=value, and ${value} isn't one.`);
+		if (at <= 0) throw usage(wrong.replace("{value}", value));
 		pairs[value.slice(0, at)] = value.slice(at + 1);
 	}
 	return pairs;
@@ -895,12 +902,11 @@ async function attachments(board) {
 	}));
 	return uploaded;
 }
-/** `s12` or `12`. */
+/** A schedule's ID as the board gave it: `s12`, or `sch_…` on Vercel's board. */
 function scheduleId(value) {
-	const id = value?.replace(/^s(?=\d)/i, "") ?? "";
 	if (value === void 0) throw usage("Missing the schedule ID, like s12.", { reason: "missing_arguments" });
-	if (!/^[^\s/]+$/.test(id)) throw usage(`${value} isn't a schedule ID like s12.`);
-	return id;
+	if (!/^[^\s/]+$/.test(value)) throw usage(`${value} isn't a schedule ID like s12.`);
+	return value;
 }
 /** A time flag: anything `Date` reads, as ISO. */
 function instant(flag, value) {
@@ -1121,7 +1127,37 @@ function failureOf(error) {
 			details: []
 		} : theirs("not_found", specific("not_found"), `Can't ${doing()}.`);
 	}
-	if (status === 409) return theirs("conflict", specific("conflict"), `Can't ${doing()}.`);
+	if (status === 409) {
+		const { args } = current;
+		const newer = code === "newer_message" && flags.after !== void 0 && args[0] !== void 0;
+		const labeled = code === "label_conflict" && (flags.if !== void 0 || flags["if-unset"] !== void 0) && args[0] !== void 0;
+		const changed = code === "revision_conflict" && flags["if-revision"] !== void 0 && args[0] !== void 0;
+		return theirs("conflict", specific("conflict"), `Can't ${doing()}.`, newer ? [{
+			instruction: `Read what came after ${ref(flags.after)}`,
+			argv: [
+				...cli(),
+				"read",
+				args[0].replace(/^#/, ""),
+				"--after",
+				flags.after.replace(/^#/, "")
+			]
+		}] : labeled ? [{
+			instruction: "See its labels now",
+			argv: [
+				...cli(),
+				"read",
+				args[0].replace(/^#/, "")
+			]
+		}] : changed ? [{
+			instruction: "Read it as it is now",
+			argv: [
+				...cli(),
+				"read",
+				args[0].replace(/^#/, ""),
+				"--json"
+			]
+		}] : []);
+	}
 	if (status === 413) return theirs("limit", "payload_too_large", `Can't ${doing()}. It's too large for the board.`);
 	if (status === 429) return theirs("rate_limit", "rate_limited", "Too many requests to the board. Try again in a minute.");
 	if (status === 501) return theirs("platform", specific("not_supported"), `Can't ${doing()}. This board doesn't support it.`);
@@ -1506,6 +1542,7 @@ async function run(command, args) {
 				]
 			}] });
 			if (flags.sync?.length && flags["no-sync"]) throw usage("Can't use --sync with --no-sync.");
+			if (re === void 0 && flags.after !== void 0) throw usage("Can't use --after on a new thread. It's for replies: the thread's newest message.");
 			const board = client();
 			const content = body === void 0 && flags.attach?.length ? "" : await text(body);
 			const files = await attachments(board);
@@ -1519,7 +1556,10 @@ async function run(command, args) {
 			const message = re === void 0 ? await board.post(target, {
 				...options,
 				...flags.sync?.length ? { sync: flags.sync } : {}
-			}) : await board.reply(re, options);
+			}) : await board.reply(re, {
+				...options,
+				...flags.after !== void 0 ? { after: messageId(flags.after) } : {}
+			});
 			warnUnknownMentions(message.unknownMentions);
 			printMessage(message);
 			return 0;
@@ -1533,7 +1573,8 @@ async function run(command, args) {
 				text: content,
 				...files.length ? { attachments: files } : {},
 				...flags["idempotency-key"] ? { id: flags["idempotency-key"] } : {},
-				...flags["no-sync"] ? { noSync: true } : {}
+				...flags["no-sync"] ? { noSync: true } : {},
+				...flags.after !== void 0 ? { after: messageId(flags.after) } : {}
 			});
 			warnUnknownMentions(message.unknownMentions);
 			printMessage(message);
@@ -1546,7 +1587,7 @@ async function run(command, args) {
 					schedule,
 					outcome: canceled ? "canceled" : "unchanged"
 				});
-				else out(canceled ? `canceled s${schedule.id}` : `s${schedule.id} is already ${schedule.state}`);
+				else out(canceled ? `canceled ${schedule.id}` : `${schedule.id} is already ${schedule.state}`);
 				return 0;
 			}
 			const [target, body] = args;
@@ -1630,14 +1671,14 @@ async function run(command, args) {
 		case "hook": return 0;
 		case "edit": {
 			const id = messageId(args[0]);
-			const { unknownMentions } = await client().edit(id, await text(args[1]));
+			const { unknownMentions } = await client().edit(id, await text(args[1]), ifRevision());
 			warnUnknownMentions(unknownMentions);
 			printDone(id, "edited");
 			return 0;
 		}
 		case "delete": {
 			const id = messageId(args[0]);
-			await client().delete(id);
+			await client().delete(id, ifRevision());
 			printDone(id, "deleted");
 			return 0;
 		}
@@ -1659,9 +1700,15 @@ async function run(command, args) {
 			const set = labelPairs(args.slice(1));
 			const unset = flags.unset ?? [];
 			if (Object.keys(set).length === 0 && unset.length === 0) throw usage("Missing the labels: k=v to set one, --unset k to remove one.", { reason: "missing_arguments" });
+			const expected = labelPairs(flags.if, "--if takes key=value, and {value} isn't one. For a label that mustn't be set, --if-unset key.");
+			for (const key of flags["if-unset"] ?? []) {
+				if (Object.hasOwn(expected, key)) throw usage(`Can't use --if ${key}=… with --if-unset ${key}.`);
+				expected[key] = null;
+			}
 			await client().label(id, {
 				set,
-				unset
+				unset,
+				...Object.keys(expected).length ? { if: expected } : {}
 			});
 			printDone(id, "labeled");
 			return 0;

package/dist/{middleware-CXjEeef4.mjs → middleware-DlJQYiwV.mjs}

@@ -1,5 +1,5 @@
 import { m as MESSAGE_TEXT_MAX, p as Labels } from "./schemas-DBmUO6pr.mjs";
-import { t as HttpError } from "./errors-CusN4x2l.mjs";
+import { t as HttpError } from "./errors-C_5rB8Iz.mjs";
 import { z } from "zod";
 //#region src/server/middleware.ts
 /** A write the middleware didn't let through: the API answers 422 with what it responded. */

package/dist/{node-Zd_C-gxP.mjs → node-D8Rtg1su.mjs}

@@ -1,4 +1,4 @@
-import { t as BoardError } from "./client-D0Px7KzF.mjs";
+import { u as BoardError } from "./errors-C_5rB8Iz.mjs";
 import { execFile } from "node:child_process";
 import { createHash } from "node:crypto";
 import { mkdir, readFile, readdir, stat, unlink, writeFile } from "node:fs/promises";

package/dist/{platform-B4TnJtWu-CwcTyKg2.mjs → platform-B4TnJtWu-Do3agKr5.mjs}

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/experimental-a2@0.22.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__52060f00b21aecfab049c27fa3abd2f9/node_modules/experimental-a2/dist/platform-B4TnJtWu.js
+//#region ../../node_modules/.pnpm/experimental-a2@0.24.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__b1e2c243a963f2620a5d202817417c26/node_modules/experimental-a2/dist/platform-B4TnJtWu.js
 const SYMBOL_FOR_REQ_CONTEXT = Symbol.for("@vercel/request-context");
 function requestContext() {
 	try {

package/dist/{project-CBXlLftU.mjs → project-C_2xs57L.mjs}

@@ -1,5 +1,5 @@
 import { n as setOwn, t as own } from "./own-OwgPWdmh.mjs";
-import { n as foldMessages, r as foldSync } from "./folds-BDMSxBUf.mjs";
+import { n as foldMessages, r as foldSync } from "./folds-DGYkMW19.mjs";
 //#region src/store/project.ts
 /** The message an event concerns, if any. */
 function concernedMessageId(event) {

package/dist/{provider-DmSTp9lI.d.mts → provider-Bm46LAdp.d.mts}

@@ -1,5 +1,5 @@
-import { d as ExternalFile, f as ExternalLink, l as ExternalAuthor, p as Link, t as Actor, u as ExternalEvent } from "./folds-ZkHM4M-v.mjs";
-import { V as MessageView, _ as BoardEventView, dt as SourceJoin, mt as SourceRead, t as BoardClient } from "./client-BqAjk0Q4.mjs";
+import { d as ExternalFile, f as ExternalLink, l as ExternalAuthor, p as Link, t as Actor, u as ExternalEvent } from "./folds-8wRRXjAt.mjs";
+import { H as MessageView, _ as BoardEventView, ft as SourceJoin, ht as SourceRead, t as BoardClient } from "./client-CjAatpV4.mjs";
 import { z } from "zod";
 //#region src/sync/events.d.ts
 declare const EventBase: z.ZodObject<{

package/dist/{redis-tables-BJQVUspu.mjs → redis-tables-BWJZHUGg.mjs}

@@ -1,14 +1,14 @@
 import { c as externalMessageKey } from "./external-D3p5T57R.mjs";
 import { n as setOwn } from "./own-OwgPWdmh.mjs";
-import { n as CLEAR_EVENT_TYPE, o as sessionClearedError, s as supersededAttemptError, t as A2Error } from "./session-clear-wHd5GCpZ-BnKSxReK.mjs";
-import { m as nullProtoRecord, n as NOTIFY_TIMINGS, v as stateTailReaders } from "./internal-CvsrprnU-CRY89I-b.mjs";
-import { i as presenceTombstones, n as isSerializedEvent, r as parseSerializedEvent, t as bufferedEvents } from "./stream-buffer-DrTyiIuo-BKy-vI14.mjs";
-import { i as streamActivities, n as defaultSleep, r as pollingStream, t as createStreamActivity } from "./store-polling-BZt2Rf3D-BiEM6_HB.mjs";
-import { t as retryableLazy } from "./retryable-lazy-DZWmHpii-Bye-W8q7.mjs";
-import { i as syncReads, n as project, r as projectSync, t as concernedMessageId } from "./project-CBXlLftU.mjs";
-import { i as idempotentReplay, n as decodeCause } from "./store-codec-DwrWlgQx-CYxGW0aD.mjs";
-import { t as pollPresence } from "./store-presence-polling-JuAy2Ck2-CYpuK75X.mjs";
-//#region ../../node_modules/.pnpm/experimental-a2@0.22.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__52060f00b21aecfab049c27fa3abd2f9/node_modules/experimental-a2/dist/store-redis-notify-CsJw_hfD.js
+import { a as duplicateBatchError, c as sessionClearedError, l as supersededAttemptError, n as CLEAR_EVENT_TYPE, s as lastIndexMismatchError, t as A2Error } from "./session-clear-XJYpmUpg-2q8l_FJR.mjs";
+import { m as nullProtoRecord, n as NOTIFY_TIMINGS, v as stateTailReaders } from "./internal-CvsrprnU-zZMpDiRY.mjs";
+import { i as presenceTombstones, n as isSerializedEvent, r as parseSerializedEvent, t as bufferedEvents } from "./stream-buffer-DrTyiIuo-Be10yOBR.mjs";
+import { i as streamActivities, n as defaultSleep, r as pollingStream, t as createStreamActivity } from "./store-polling-BZt2Rf3D-Div-bJ_D.mjs";
+import { t as retryableLazy } from "./retryable-lazy-DZWmHpii-DpTc5PIP.mjs";
+import { i as syncReads, n as project, r as projectSync, t as concernedMessageId } from "./project-C_2xs57L.mjs";
+import { i as idempotentReplay, n as decodeCause } from "./store-codec-pAG2oPgQ-SqDXlPBR.mjs";
+import { t as pollPresence } from "./store-presence-polling-JuAy2Ck2-Dh-g_KYM.mjs";
+//#region ../../node_modules/.pnpm/experimental-a2@0.24.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__b1e2c243a963f2620a5d202817417c26/node_modules/experimental-a2/dist/store-redis-notify-ys_-VrSP.js
 const key = ({ participant, field }) => JSON.stringify([participant, field]);
 function presenceRecovery({ read, deliver, isActive }) {
 	const fields = /* @__PURE__ */ new Map();
@@ -645,11 +645,12 @@ end
 `;
 /**
 * KEYS: counter.
-* ARGV: sessionId, nowMs, n, served consumers, origin index or '', then per
-* event: id, type, payloadJson, causeJson or '', targets.
+* ARGV: sessionId, nowMs, n, served consumers, origin index or '',
+* ifLastIndex or '', then per event: id, type, payloadJson, causeJson or '',
+* targets.
 * Returns ['empty', hasPending] | ['ok', firstIndex, hasPending] |
-* ['dup', hasPending, ...indexes] | ['partial', count] |
-* ['superseded', position] | ['cleared', originIndex] |
+* ['dup', hasPending, head, ...indexes] | ['partial', count, head] |
+* ['superseded', position] | ['cleared', originIndex] | ['moved', head] |
 * ['index', type, after].
 */
 const APPEND_LUA = `${BASE_LUA}${CURSOR_LUA}
@@ -657,7 +658,7 @@ local now, n = ARGV[2], tonumber(ARGV[3])
 use_served(ARGV[4])
 if n == 0 then return { 'empty', has_pending() } end
 local ids = {}
-for i = 1, n do ids[i] = ARGV[5 + (i - 1) * 5 + 1] end
+for i = 1, n do ids[i] = ARGV[6 + (i - 1) * 5 + 1] end
 local owners = owners_of(read_bounds(ids))
 local base = total
 local dups = {}
@@ -665,18 +666,18 @@ for i = 1, n do
   if owners[i] then dups[#dups + 1] = owners[i] end
 end
 if #dups == n then
-  local res = { 'dup', has_pending() }
+  local res = { 'dup', has_pending(), tostring(total) }
   for i = 1, #dups do res[#res + 1] = dups[i] end
   return res
 end
-if #dups > 0 then return { 'partial', tostring(#dups) } end
+if #dups > 0 then return { 'partial', tostring(#dups), tostring(total) } end
 local origin = ARGV[5]
 if origin ~= '' and tonumber(origin) <= boundary then return { 'cleared', origin } end
 -- The attempt-currency fence: a cause's head row must still be its cursor's
 -- head, at that attempt, not dead-lettered.
 local refs, fenced = {}, {}
 for i = 1, n do
-  local raw = ARGV[5 + (i - 1) * 5 + 4]
+  local raw = ARGV[6 + (i - 1) * 5 + 4]
   if raw ~= '' then
     local cause = cjson.decode(raw)
     local index = tonumber(cause.index)
@@ -696,16 +697,18 @@ for k, cause in ipairs(fenced) do
   end
   if served_has(cause.consumer) then pending_fast = true end
 end
+local expected = ARGV[6]
+if expected ~= '' and tonumber(expected) ~= total then return { 'moved', tostring(total) } end
 local batch = {}
 for i = 1, n do
-  local o = 5 + (i - 1) * 5
+  local o = 6 + (i - 1) * 5
   batch[i] = { idx = base + i, type = ARGV[o + 2], targets = targets_of(ARGV[o + 5]) }
 end
 local planned, missing, after = plan(batch, base)
 if not planned then return { 'index', missing, tostring(after) } end
 local marks = {}
 for i = 1, n do
-  local o = 5 + (i - 1) * 5
+  local o = 6 + (i - 1) * 5
   local field = tostring(base + i)
   redis.call('XADD', LOG, field .. '-0',
     'id', ARGV[o + 1], 'type', ARGV[o + 2], 'payload', ARGV[o + 3],
@@ -2040,6 +2043,12 @@ function createRedisStoreCore(options) {
 				const suppliedIds = events.filter((e) => e.id !== void 0).map((e) => e.id);
 				if (new Set(suppliedIds).size !== suppliedIds.length) throw new A2Error("PARTIAL_DUPLICATE_BATCH", "batch contains the same event id more than once");
 				const now = clock.now().getTime();
+				const ifLastIndex = appendOptions?.ifLastIndex;
+				const conditionalAt = (head) => ifLastIndex === void 0 ? void 0 : {
+					sessionId,
+					ifLastIndex,
+					head: Number(head)
+				};
 				const withIds = events.map((e) => ({
 					id: e.id ?? generateId(),
 					type: e.type,
@@ -2054,6 +2063,7 @@ function createRedisStoreCore(options) {
 					withIds.length,
 					servedArg(appendOptions?.consumers),
 					appendOptions?.originIndex ?? "",
+					ifLastIndex ?? "",
 					...withIds.flatMap((e, i) => [
 						e.id,
 						e.type,
@@ -2069,13 +2079,14 @@ function createRedisStoreCore(options) {
 				};
 				if (verdict === "cleared") throw sessionClearedError(`scheduled work from event ${reply[1]} was cleared in session '${sessionId}'`);
 				if (verdict === "superseded") throw supersededAttemptError(sessionId, withIds[Number(reply[1]) - 1].cause);
-				if (verdict === "partial") throw new A2Error("PARTIAL_DUPLICATE_BATCH", `batch mixes ${reply[1]} already-appended and ${events.length - Number(reply[1])} fresh events`);
+				if (verdict === "moved") throw lastIndexMismatchError(sessionId, ifLastIndex, Number(reply[1]));
+				if (verdict === "partial") throw duplicateBatchError(`batch mixes ${reply[1]} already-appended and ${events.length - Number(reply[1])} fresh events`, conditionalAt(reply[2]));
 				if (verdict === "dup") {
 					const hasPending = reply[1] === "1";
-					const firstIndex = Math.min(...reply.slice(2).map(Number));
+					const firstIndex = Math.min(...reply.slice(3).map(Number));
 					const { rows: existing, clearIndex } = await retryAfterGap(() => readBoundedRange(sessionId, firstIndex - 1, firstIndex + events.length - 1));
 					if (firstIndex < clearIndex) throw new A2Error("STORE_UNAVAILABLE", `session '${sessionId}' was cleared while an append retry replayed; retry it`);
-					const replayed = idempotentReplay(events, existing);
+					const replayed = idempotentReplay(events, existing, conditionalAt(reply[2]));
 					await publish(notifyChannel(sessionId), wakeMessage(firstIndex + events.length - 1, now, []));
 					return {
 						events: replayed,
@@ -2674,11 +2685,16 @@ function createRedisNotifyStore(options) {
 	*/
 	let subscriberGate = null;
 	const gatedSubscriber = () => {
-		subscriberGate ??= getSubscriber().then(async (conn) => {
+		if (subscriberGate) return subscriberGate;
+		const gate = getSubscriber().then(async (conn) => {
 			await conn.call("echo", "ready");
 			return conn;
 		});
-		return subscriberGate;
+		subscriberGate = gate;
+		gate.catch(() => {
+			if (subscriberGate === gate) subscriberGate = null;
+		});
+		return gate;
 	};
 	const acquireChannel = async (channel) => {
 		const existing = subscriptions.get(channel);

package/dist/{reducer-CjmvZSAb-D_OSISmj.mjs → reducer-Bswr11ar-P324o9vn.mjs}

@@ -1,5 +1,5 @@
-import { a as isSessionCleared } from "./session-clear-wHd5GCpZ-BnKSxReK.mjs";
-//#region ../../node_modules/.pnpm/experimental-a2@0.22.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__52060f00b21aecfab049c27fa3abd2f9/node_modules/experimental-a2/dist/reducer-CjmvZSAb.js
+import { o as isSessionCleared } from "./session-clear-XJYpmUpg-2q8l_FJR.mjs";
+//#region ../../node_modules/.pnpm/experimental-a2@0.24.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__b1e2c243a963f2620a5d202817417c26/node_modules/experimental-a2/dist/reducer-Bswr11ar.js
 /**
 * Run a Standard Schema validator, requiring a synchronous result.
 * Validators must be synchronous (specs/a2-api.md §1) — an async one is

package/dist/{reducer-CYPHsSmd-BQIfozGi.d.mts → reducer-CYPHsSmd-BXjGiptm.d.mts}

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/experimental-a2@0.22.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__52060f00b21aecfab049c27fa3abd2f9/node_modules/experimental-a2/dist/reducer-CYPHsSmd.d.ts
+//#region ../../node_modules/.pnpm/experimental-a2@0.24.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__b1e2c243a963f2620a5d202817417c26/node_modules/experimental-a2/dist/reducer-CYPHsSmd.d.ts
 //#region src/standard-schema.d.ts
 /**
  * The Standard Schema interface, vendored per the spec's guidance

package/dist/{reducers-DJzVpXwM.mjs → reducers-8jqLewgw.mjs}

@@ -1,10 +1,10 @@
 import { S as storable, _ as RemoteWatcherId, c as ChannelPath, d as LabelKey, g as MessageText, h as MessageId, i as Attachment, l as Emoji, n as ActorId, o as Author, p as Labels, u as Handle, v as SCOPE_MAX, y as SeenActorKind } from "./schemas-DBmUO6pr.mjs";
 import { a as Link, i as ExternalTarget, n as ExternalEvent, o as Origin } from "./external-D3p5T57R.mjs";
 import { n as setOwn, t as own } from "./own-OwgPWdmh.mjs";
-import { a as reducer, i as makeReducerBuilder, t as assertSyncSchema } from "./reducer-CjmvZSAb-D_OSISmj.mjs";
-import { n as foldMessages, t as foldActors } from "./folds-BDMSxBUf.mjs";
+import { a as reducer, i as makeReducerBuilder, t as assertSyncSchema } from "./reducer-Bswr11ar-P324o9vn.mjs";
+import { n as foldMessages, t as foldActors } from "./folds-DGYkMW19.mjs";
 import { z } from "zod";
-//#region ../../node_modules/.pnpm/experimental-a2@0.22.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__52060f00b21aecfab049c27fa3abd2f9/node_modules/experimental-a2/dist/contract-CWukt01d.js
+//#region ../../node_modules/.pnpm/experimental-a2@0.24.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__b1e2c243a963f2620a5d202817417c26/node_modules/experimental-a2/dist/contract-DqfBSIqJ.js
 function contract(options) {
 	for (const type of Object.keys(options.events ?? {})) if (type.startsWith("a2.")) throw new TypeError(`contract '${String(options.name)}': event types starting with 'a2.' are reserved`);
 	return defineContract(options);

package/dist/{retryable-lazy-DZWmHpii-Bye-W8q7.mjs → retryable-lazy-DZWmHpii-DpTc5PIP.mjs}

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/experimental-a2@0.22.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__52060f00b21aecfab049c27fa3abd2f9/node_modules/experimental-a2/dist/retryable-lazy-DZWmHpii.js
+//#region ../../node_modules/.pnpm/experimental-a2@0.24.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__b1e2c243a963f2620a5d202817417c26/node_modules/experimental-a2/dist/retryable-lazy-DZWmHpii.js
 const retryableLazy = (initialize) => {
 	let current = null;
 	const get = () => {

package/dist/{scheduler-task-X1SToDjP-BVoWuInI.mjs → scheduler-task-X1SToDjP-D2Il2rln.mjs}

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/experimental-a2@0.22.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__52060f00b21aecfab049c27fa3abd2f9/node_modules/experimental-a2/dist/scheduler-task-X1SToDjP.js
+//#region ../../node_modules/.pnpm/experimental-a2@0.24.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__b1e2c243a963f2620a5d202817417c26/node_modules/experimental-a2/dist/scheduler-task-X1SToDjP.js
 const recordOf = (value) => value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
 const validName = (value) => typeof value === "string" && value.length > 0;
 const validDueAt = (value) => typeof value === "number" && Number.isInteger(value) && value % 1e3 === 0;

package/dist/{serve-G9RuaDSr.mjs → serve-lPoBDEds.mjs}

@@ -1,10 +1,10 @@
-import { t as BoardError } from "./client-D0Px7KzF.mjs";
-import { s as localTokenFile } from "./node-Zd_C-gxP.mjs";
-import { t as board } from "./server-BixV_byP.mjs";
-import { t as oidcTokens } from "./tokens-CC3izSNr.mjs";
-import { t as a2 } from "./a2-HUbQJ0RD.mjs";
-import { a as fsBlob } from "./blob-DdbpJqN1.mjs";
-import { t as localScheduler } from "./local-DhkrAqPP.mjs";
+import { u as BoardError } from "./errors-C_5rB8Iz.mjs";
+import { s as localTokenFile } from "./node-D8Rtg1su.mjs";
+import { t as board } from "./server-D82a4uMe.mjs";
+import { t as oidcTokens } from "./tokens-C5_yGRlL.mjs";
+import { t as a2 } from "./a2-D_28Pdip.mjs";
+import { a as fsBlob } from "./blob-DQK5prXT.mjs";
+import { t as localScheduler } from "./local-C76Fy5ad.mjs";
 import { mkdir, rm, writeFile } from "node:fs/promises";
 import { userInfo } from "node:os";
 import { dirname, join, resolve } from "node:path";

package/dist/{server-qgez0Xny-D5mLfqFQ.d.mts → server-B9gu0qi1-DI1WvcVK.d.mts}

@@ -1,6 +1,6 @@
-import { a as PresenceDefs, c as PresenceSnapshot, d as WithPresence, i as EventDefs, l as Reducer, n as Contract, o as PresenceMap, r as ContractEvent, s as PresencePatch, t as AppendInput, u as RegisteredReducer } from "./reducer-CYPHsSmd-BQIfozGi.mjs";
-import { r as Event } from "./store-D0MhBvg6-4Z2L0Kqd.mjs";
-//#region ../../node_modules/.pnpm/experimental-a2@0.22.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__52060f00b21aecfab049c27fa3abd2f9/node_modules/experimental-a2/dist/session-clear-D1PFe7xl.d.ts
+import { a as PresenceDefs, c as PresenceSnapshot, d as WithPresence, i as EventDefs, l as Reducer, n as Contract, o as PresenceMap, r as ContractEvent, s as PresencePatch, t as AppendInput, u as RegisteredReducer } from "./reducer-CYPHsSmd-BXjGiptm.mjs";
+import { r as Event } from "./store-DEzcHZOA-B-5vhxef.mjs";
+//#region ../../node_modules/.pnpm/experimental-a2@0.24.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__b1e2c243a963f2620a5d202817417c26/node_modules/experimental-a2/dist/session-clear-vfonou9S.d.ts
 //#region src/session-clear.d.ts
 /** Reserved type of the marker a clear appends. */
 declare const CLEAR_EVENT_TYPE = "a2.cleared";
@@ -10,7 +10,7 @@ type SessionCleared = Event & {
   payload: null;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/experimental-a2@0.22.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__52060f00b21aecfab049c27fa3abd2f9/node_modules/experimental-a2/dist/server-qgez0Xny.d.ts
+//#region ../../node_modules/.pnpm/experimental-a2@0.24.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__b1e2c243a963f2620a5d202817417c26/node_modules/experimental-a2/dist/server-B9gu0qi1.d.ts
 //#region src/session-socket.d.ts
 /**
  * The structural socket `sessionsSocket` speaks against — satisfied
@@ -148,6 +148,12 @@ type SessionDispatch<D extends EventDefs> = (...events: AppendInput<D>[]) => Pro
 type SessionAppend<D extends EventDefs> = SessionDispatch<D> & {
   /** Commit, then hand pending work directly to configured scheduler. */
   dispatch: SessionDispatch<D>;
+  /**
+   * Append only while `index` is the session's head, checked in the same
+   * atomic step as the write. Otherwise nothing is written and it throws
+   * `LAST_INDEX_MISMATCH`, with the head as `details.index`.
+   */
+  ifLastIndex(index: number, ...events: AppendInput<D>[]): Promise<ContractEvent<D>[]>;
 };
 type ConsumerAppend<D extends EventDefs> = (name: string, ...events: AppendInput<D>[]) => Promise<ContractEvent<D>[]>;
 type ScheduleDelay = `${number}${"ms" | "s" | "m" | "h" | "d"}`;

package/dist/{server-BixV_byP.mjs → server-D82a4uMe.mjs}

@@ -1,5 +1,5 @@
-import { t as createBoard } from "./exports-BG-0Wyn-.mjs";
-import { t as http } from "./backend-http-Bmp0IgD3.mjs";
+import { t as createBoard } from "./exports-CG0P8Qi4.mjs";
+import { t as http } from "./backend-http-16SbvnAK.mjs";
 //#region src/server/index.ts
 /**
 * The handle on a board. With a `backend`, the board lives there: `a2()` keeps it in this
@@ -9,8 +9,8 @@ import { t as http } from "./backend-http-Bmp0IgD3.mjs";
 function board(options = {}) {
 	return createBoard(options, {
 		http: () => http(),
-		sync: () => import("./engine-DQxXk7dX.mjs"),
-		serving: () => import("./serving-B75Y4BF-.mjs")
+		sync: () => import("./engine-DkdkXQEy.mjs"),
+		serving: () => import("./serving-DKny38LK.mjs")
 	});
 }
 //#endregion