@burdenoff/fe-libs 2026.925.9 → 2026.926.2

package/dist/shared/assistant/turnProgress.d.ts

@@ -74,14 +74,68 @@ export declare function buildAssistantProgress(messages: AssistantRawMessage[],
  * earlier assistant message counts as this turn's, and the PREVIOUS completed
  * reply is shown — and charged — as the answer on the first poll.
  *
- * - A new session has said nothing yet, so 0 is exact: no retry needed.
+ * - ★ A new session — one THIS attempt created — is not read at all: 0 is
+ *   exact (BOFF-7801). Creating it posts at most ONE message, the mode's
+ *   context, and that is a no-reply USER message (the agent's
+ *   `injectModeContext`; opencode returns before its model loop on
+ *   `noReply`). No assistant message predates the prompt, and only an
+ *   assistant message can be taken for the reply. The read cost a round trip
+ *   (0.9–1.6s in prod) ahead of every first prompt and changed no poll: that
+ *   context message is the session's first, so no `since` and its old value
+ *   select the same set.
  * - A reused one that fails — or lists NOTHING, which a session that has
  *   answered before cannot truthfully do (a misrouted or stale read) — is
  *   read once more. Empty twice is believed: the session is genuinely empty
  *   (its first prompt never went out). Failing twice fails the turn, with the
  *   first error (a temporary outcome the person can retry).
+ *
+ * `readAhead`: the first read, already under way (`startSessionReadAhead`).
+ * It stands in for the FIRST read only. The second is always a fresh fetch —
+ * a read-ahead that came back empty or failed is exactly the read not trusted.
+ * Its floor is the session as of when it was STARTED — before the session
+ * check, not after it. See `startSessionReadAhead` for what that admits.
  */
-export declare function snapshotReplyFloor(fetchPrior: () => Promise<AssistantRawMessage[]>, sessionIsNew: boolean): Promise<number>;
+export declare function snapshotReplyFloor(fetchPrior: () => Promise<AssistantRawMessage[]>, sessionIsNew: boolean, readAhead?: Promise<AssistantRawMessage[]> | null): Promise<number>;
+/**
+ * ★ BOFF-7801: a REUSED session's pre-prompt read, started alongside the check
+ * that the session is still alive — the two were strictly serial round trips
+ * (0.6–1.3s each in prod) ahead of every follow-up prompt.
+ *
+ * Tagged with the sandbox and session it reads, and those are the ids handed
+ * to `read`: the tag cannot name one session while the read fetched another.
+ * `readAheadFor` releases it only to a prompt bound for that same session.
+ *
+ * ★ What the overlap costs. Both are accepted, and neither is a new kind of
+ * fault:
+ *
+ * - The floor is one check round trip OLDER. The read used to be taken after
+ *   the check returned; now it is taken as the check is sent. A message the
+ *   session gains in between is newer than the floor, so it is taken for THIS
+ *   turn's reply: an earlier turn's loop still finishing (a
+ *   `continuesInBackground` build; a turn stopped while its sandbox was still
+ *   starting, whose prompt still goes out), or another tab on the session.
+ *   That was already true of any message written after the old floor; this
+ *   widens the window by the check (0.6–1.3s). Closing it means matching the
+ *   reply to this turn's own user message (`parentID`) instead of by time.
+ * - It is speculative: it is sent before the check can say whether the
+ *   session is alive. A stored session found dead or in another mode costs
+ *   this one discarded read, repaid by the new session's skipped read
+ *   (`snapshotReplyFloor`) whenever the create succeeds, so no path that
+ *   reaches a prompt makes more calls than before. An attempt that then fails
+ *   BEFORE prompting (the create refused, the trusted-cache plan rethrowing,
+ *   the turn abandoned) is left one read up. And a transport failure is
+ *   retried like any gateway call (`executeSandboxGraphQL`), alongside the
+ *   check's own retries: up to two more requests, never a longer wait —
+ *   nothing awaits a discarded read.
+ */
+export interface SessionReadAhead {
+    sandboxId: string;
+    sessionId: string;
+    messages: Promise<AssistantRawMessage[]>;
+}
+export declare function startSessionReadAhead(sandboxId: string, sessionId: string, read: (sandboxId: string, sessionId: string) => Promise<AssistantRawMessage[]>): SessionReadAhead;
+/** The read-ahead's messages — only for the session the prompt is sent to. */
+export declare function readAheadFor(readAhead: SessionReadAhead | null, sandboxId: string, sessionId: string): Promise<AssistantRawMessage[]> | null;
 /** Where a turn's first answer text is, while it is still only a candidate. */
 export interface FirstTextTracker {
     messageId: string | null;

package/dist/shared/assistant/turnProgress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"turnProgress.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/turnProgress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EACL,KAAK,wBAAwB,EAK9B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,uEAAuE;AACvE,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,mBAAmB,EAAE,OAAO,CAAC;IAC7B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,oBAAoB,EAAE,MAAM,EAC5B,OAAO,CAAC,EAAE,wBAAwB,GACjC,qBAAqB,CAqFvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,OAAO,CAAC,mBAAmB,EAAE,CAAC,EAChD,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACnB;AAED,eAAO,MAAM,aAAa,EAAE,gBAAgD,CAAC;AAE7E;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,IAAI,CAAC,qBAAqB,EAAE,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC,EACvE,GAAG,EAAE,MAAM,GACV;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAc3D"}
+{"version":3,"file":"turnProgress.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/turnProgress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EACL,KAAK,wBAAwB,EAK9B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,uEAAuE;AACvE,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,mBAAmB,EAAE,OAAO,CAAC;IAC7B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,oBAAoB,EAAE,MAAM,EAC5B,OAAO,CAAC,EAAE,wBAAwB,GACjC,qBAAqB,CAqFvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,OAAO,CAAC,mBAAmB,EAAE,CAAC,EAChD,YAAY,EAAE,OAAO,EACrB,SAAS,GAAE,OAAO,CAAC,mBAAmB,EAAE,CAAC,GAAG,IAAW,GACtD,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;CAC1C;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,CACJ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,mBAAmB,EAAE,CAAC,GAClC,gBAAgB,CASlB;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAC1B,SAAS,EAAE,gBAAgB,GAAG,IAAI,EAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,EAAE,CAAC,GAAG,IAAI,CAKvC;AAED,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACnB;AAED,eAAO,MAAM,aAAa,EAAE,gBAAgD,CAAC;AAE7E;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,IAAI,CAAC,qBAAqB,EAAE,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC,EACvE,GAAG,EAAE,MAAM,GACV;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAc3D"}

package/dist/shared/assistant/turnProgress.js

@@ -29,31 +29,42 @@ function a(a, o, s) {
 		...p ? { pendingWrite: p } : {}
 	};
 }
-async function o(e, t) {
-	let r = (e) => e.reduce((e, t) => Math.max(e, n(t)), 0), i = null;
+async function o(e, t, r = null) {
+	if (t) return 0;
+	let i = (e) => e.reduce((e, t) => Math.max(e, n(t)), 0), a = null;
 	try {
-		let n = await e();
-		if (n.length > 0 || t) return r(n);
+		let t = await (r ?? e());
+		if (t.length > 0) return i(t);
 	} catch (e) {
-		if (t) return 0;
-		i = e;
+		a = e;
 	}
 	try {
-		return r(await e());
+		return i(await e());
 	} catch (e) {
-		throw i ?? e;
+		throw a ?? e;
 	}
 }
-var s = {
+function s(e, t, n) {
+	let r = (async () => n(e, t))();
+	return r.catch(() => void 0), {
+		sandboxId: e,
+		sessionId: t,
+		messages: r
+	};
+}
+function c(e, t, n) {
+	return e?.sandboxId === t && e.sessionId === n ? e.messages : null;
+}
+var l = {
 	messageId: null,
 	at: null
 };
-function c(e, t, n) {
+function u(e, t, n) {
 	let r = t.messageId ?? null, i = e;
 	t.hasText ? (e.at === null || e.messageId !== r) && (i = {
 		messageId: r,
 		at: n
-	}) : i = s;
+	}) : i = l;
 	let a = t.done && i.at !== null && i.messageId === r ? i.at : null;
 	return {
 		tracker: i,
@@ -61,4 +72,4 @@ function c(e, t, n) {
 	};
 }
 //#endregion
-export { s as NO_FIRST_TEXT, a as buildAssistantProgress, o as snapshotReplyFloor, c as trackFirstText };
+export { l as NO_FIRST_TEXT, a as buildAssistantProgress, c as readAheadFor, o as snapshotReplyFloor, s as startSessionReadAhead, u as trackFirstText };

package/dist/shared/assistant/ui/AssistantChatArea.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantChatArea.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/ui/AssistantChatArea.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,EAAE,EACR,MAAM,OAAO,CAAC;AAmIf,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AA+EvE;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,EAAE,oBAAoB,CAAC;CACpC;AAED,eAAO,MAAM,iBAAiB,EAAE,EAAE,CAAC,sBAAsB,CA6qGxD,CAAC"}
+{"version":3,"file":"AssistantChatArea.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/ui/AssistantChatArea.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,EAAE,EACR,MAAM,OAAO,CAAC;AAsIf,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AA+EvE;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,EAAE,oBAAoB,CAAC;CACpC;AAED,eAAO,MAAM,iBAAiB,EAAE,EAAE,CAAC,sBAAsB,CAktGxD,CAAC"}