@burdenoff/fe-libs 2026.930.5 → 2026.1001.1

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

@@ -302,7 +302,11 @@ export interface ConversationSyncStamp {
     hasOlder?: true;
     /** Where "Show earlier messages" continues from. */
     olderCursor?: string;
-    /** Renamed on this device: the server's title never overwrites it (renames are not synced). */
+    /**
+     * Renamed on this device only — before renames were synced, or while server
+     * history could not address it — so the server's title never overwrites it
+     * here. A rename that IS synced (BOFF-8159) lifts it.
+     */
     titleLocked?: true;
     /** Why the latest turns are not being saved. */
     blocked?: "quota" | "invalid" | "scope";

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

@@ -1 +1 @@
-{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/conversation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/conversation.ts"],"names":[],"mappings":"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"}

package/dist/shared/assistant/history/historyApi.d.ts

@@ -1,25 +1,39 @@
-import { AssistantHistoryChangePage, AssistantHistoryConvRef, AssistantHistoryDeletePayload, AssistantHistoryEntryPage, AssistantHistoryEntryPaging, AssistantHistoryHeaderPage, AssistantHistorySaveInput, AssistantHistorySavePayload, AssistantHistoryScope } from './historyTypes';
+import { AssistantHistoryChangePage, AssistantHistoryConvRef, AssistantHistoryConversationFilter, AssistantHistoryDeletePayload, AssistantHistoryEntryPage, AssistantHistoryEntryPaging, AssistantHistoryHeaderPage, AssistantHistorySaveInput, AssistantHistorySavePayload, AssistantHistoryScope, AssistantHistoryUpdatePatch, AssistantHistoryUpdatePayload } from './historyTypes';
 export interface AssistantHistoryTransport {
     changes(scope: AssistantHistoryScope, page: {
         first: number;
         after: string | null;
     }): Promise<AssistantHistoryChangePage>;
+    /**
+     * The live list. With a `filter` it needs the history controls: without
+     * them it is refused (`AssistantHistoryControlsUnavailableError`) rather
+     * than answered unfiltered.
+     */
     conversations(scope: AssistantHistoryScope, page: {
         first: number;
         after: string | null;
+        filter?: AssistantHistoryConversationFilter;
     }): Promise<AssistantHistoryHeaderPage>;
     entries(scope: AssistantHistoryScope, ref: AssistantHistoryConvRef, page: AssistantHistoryEntryPaging): Promise<AssistantHistoryEntryPage>;
     save(scope: AssistantHistoryScope, input: AssistantHistorySaveInput): Promise<AssistantHistorySavePayload>;
     remove(scope: AssistantHistoryScope, ref: AssistantHistoryConvRef): Promise<AssistantHistoryDeletePayload>;
+    /** A control change (BOFF-8159). Refused, unsent, while the controls are unavailable. */
+    update(scope: AssistantHistoryScope, ref: AssistantHistoryConvRef, patch: AssistantHistoryUpdatePatch): Promise<AssistantHistoryUpdatePayload>;
+    /** Whether the server has the history controls, as far as the last answer showed (true until one says not). */
+    controlsAvailable(): boolean;
+    /** Hear every change of {@link controlsAvailable}. Returns the unsubscribe. */
+    onControlsChange(listener: (available: boolean) => void): () => void;
+    /** The next feed read tries the controls again, without waiting for the ten-minute recheck. */
+    recheckControls(): void;
 }
-/** The server answered, but not with a shape this client understands. Never a reason to drop. */
-export declare class AssistantHistoryResponseError extends Error {
-    constructor(operationName: string, detail: string);
-}
-/** The request's workspace or account is not the active one, so it was not sent. Hold, never drop. */
-export declare class AssistantHistoryScopeInactiveError extends Error {
-    constructor();
-}
+/** While the controls are unavailable: how often the feed tries the FULL documents again. */
+export declare const ASSISTANT_HISTORY_CONTROLS_RECHECK_MS: number;
+/**
+ * Consecutive masked failures of FULL documents ("Unexpected error." from a
+ * gateway that hides validation errors) after which a BASE retry that
+ * succeeds is read as drift.
+ */
+export declare const ASSISTANT_HISTORY_MASKED_DRIFT_STREAK = 2;
 /** One GraphQL call, as `executeAssistantGraphQLOnce` makes it. Injected in tests. */
 export type AssistantHistoryExecutor = <TData>(params: {
     query: string;
@@ -33,6 +47,8 @@ export interface GatewayHistoryTransportOptions {
     activeWorkspaceId?: () => string;
     /** The signed-in account right now (default: the access token's subject). */
     activeActorId?: () => string | null;
+    /** Epoch ms now, for the controls recheck (default: `Date.now`). */
+    now?: () => number;
 }
 export declare function createGatewayHistoryTransport(options?: GatewayHistoryTransportOptions): AssistantHistoryTransport;
 //# sourceMappingURL=historyApi.d.ts.map

package/dist/shared/assistant/history/historyApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"historyApi.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/history/historyApi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAqBH,OAAO,KAAK,EACV,0BAA0B,EAC1B,uBAAuB,EAEvB,6BAA6B,EAE7B,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAG1B,yBAAyB,EAEzB,2BAA2B,EAC3B,qBAAqB,EAGtB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,yBAAyB;IACxC,OAAO,CACL,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAC5C,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACvC,aAAa,CACX,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAC5C,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACvC,OAAO,CACL,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,uBAAuB,EAC5B,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACtC,IAAI,CACF,KAAK,EAAE,qBAAqB,EAC5B,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACxC,MAAM,CACJ,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,6BAA6B,CAAC,CAAC;CAC3C;AAED,iGAAiG;AACjG,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAIlD;AAED,sGAAsG;AACtG,qBAAa,kCAAmC,SAAQ,KAAK;;CAK5D;AAED,sFAAsF;AACtF,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;AAErB,MAAM,WAAW,8BAA8B;IAC7C,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,MAAM,MAAM,CAAC;IACjC,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACrC;AAWD,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,8BAAmC,GAC3C,yBAAyB,CAgH3B"}
+{"version":3,"file":"historyApi.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/history/historyApi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAoCH,OAAO,KAAK,EACV,0BAA0B,EAE1B,uBAAuB,EACvB,kCAAkC,EAElC,6BAA6B,EAE7B,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAG1B,yBAAyB,EAEzB,2BAA2B,EAC3B,qBAAqB,EAIrB,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,yBAAyB;IACxC,OAAO,CACL,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAC5C,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACvC;;;;OAIG;IACH,aAAa,CACX,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,kCAAkC,CAAA;KAAE,GACzF,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACvC,OAAO,CACL,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,uBAAuB,EAC5B,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACtC,IAAI,CACF,KAAK,EAAE,qBAAqB,EAC5B,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACxC,MAAM,CACJ,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC1C,yFAAyF;IACzF,MAAM,CACJ,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,uBAAuB,EAC5B,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC1C,+GAA+G;IAC/G,iBAAiB,IAAI,OAAO,CAAC;IAC7B,+EAA+E;IAC/E,gBAAgB,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACrE,+FAA+F;IAC/F,eAAe,IAAI,IAAI,CAAC;CACzB;AAED,6FAA6F;AAC7F,eAAO,MAAM,qCAAqC,QAAc,CAAC;AACjE;;;;GAIG;AACH,eAAO,MAAM,qCAAqC,IAAI,CAAC;AAEvD,sFAAsF;AACtF,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;AAErB,MAAM,WAAW,8BAA8B;IAC7C,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,MAAM,MAAM,CAAC;IACjC,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACpC,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAuBD,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,8BAAmC,GAC3C,yBAAyB,CA6Q3B"}

package/dist/shared/assistant/history/historyApi.js

@@ -1,116 +1,243 @@
 import { executeAssistantGraphQLOnce as e } from "../gatewayClient.js";
 import { getActorId as t, getWorkspaceId as n } from "../context.js";
-import { ASSISTANT_HISTORY_CHANGES_OPERATION as r, ASSISTANT_HISTORY_CHANGES_QUERY as i, ASSISTANT_HISTORY_CONVERSATIONS_OPERATION as a, ASSISTANT_HISTORY_CONVERSATIONS_QUERY as o, ASSISTANT_HISTORY_DELETE_MUTATION as s, ASSISTANT_HISTORY_DELETE_OPERATION as c, ASSISTANT_HISTORY_ENTRIES_OPERATION as l, ASSISTANT_HISTORY_ENTRIES_QUERY as u, ASSISTANT_HISTORY_SAVE_MUTATION as d, ASSISTANT_HISTORY_SAVE_OPERATION as f, buildHistoryDeleteVariables as p, buildHistoryEntriesVariables as m, buildHistoryPageVariables as h, buildHistorySaveVariables as g } from "./historyOperations.js";
-import { historyTimestampToIso as _ } from "./historyTimestamps.js";
+import { AssistantHistoryControlsUnavailableError as r, AssistantHistoryResponseError as i, AssistantHistoryScopeInactiveError as a } from "./historyTransportErrors.js";
+import { classifyAssistantHistoryError as o, isAssistantHistoryControlsDrift as s } from "./historyErrors.js";
+import { ASSISTANT_HISTORY_CHANGES_OPERATION as c, ASSISTANT_HISTORY_CHANGES_QUERY as l, ASSISTANT_HISTORY_CHANGES_QUERY_BASE as u, ASSISTANT_HISTORY_CONVERSATIONS_OPERATION as d, ASSISTANT_HISTORY_CONVERSATIONS_QUERY as f, ASSISTANT_HISTORY_CONVERSATIONS_QUERY_BASE as p, ASSISTANT_HISTORY_DELETE_MUTATION as m, ASSISTANT_HISTORY_DELETE_MUTATION_BASE as h, ASSISTANT_HISTORY_DELETE_OPERATION as g, ASSISTANT_HISTORY_ENTRIES_OPERATION as _, ASSISTANT_HISTORY_ENTRIES_QUERY as v, ASSISTANT_HISTORY_ENTRIES_QUERY_BASE as y, ASSISTANT_HISTORY_SAVE_MUTATION as b, ASSISTANT_HISTORY_SAVE_MUTATION_BASE as x, ASSISTANT_HISTORY_SAVE_OPERATION as S, ASSISTANT_HISTORY_UPDATE_MUTATION as C, ASSISTANT_HISTORY_UPDATE_OPERATION as w, buildHistoryDeleteVariables as T, buildHistoryEntriesVariables as E, buildHistoryListVariables as D, buildHistoryPageVariables as O, buildHistorySaveVariables as k, buildHistoryUpdateVariables as A } from "./historyOperations.js";
+import { historyTimestampToIso as j } from "./historyTimestamps.js";
 //#region src/shared/assistant/history/historyApi.ts
-var v = class extends Error {
-	constructor(e, t) {
-		super(`Assistant history: unexpected ${e} response (${t})`), this.name = "AssistantHistoryResponseError";
-	}
-}, y = class extends Error {
-	constructor() {
-		super("Assistant history: the request's workspace or account is not the active one"), this.name = "AssistantHistoryScopeInactiveError";
-	}
-};
-function b(e) {
+var M = 10 * 6e4, N = 2;
+function P(e) {
+	let t = o(e);
+	return t.class === "transient" && t.code !== "RATE_LIMIT_EXCEEDED";
+}
+function F(e) {
 	try {
 		return e();
 	} catch {
 		return null;
 	}
 }
-function x(_ = {}) {
-	let x = _.execute ?? ((t) => e(t)), w = _.activeWorkspaceId ?? n, T = _.activeActorId ?? t, j = async (e, t, n, r) => {
-		if (!e.workspaceId || !e.actorId || b(w) !== e.workspaceId || b(T) !== e.actorId) throw new y();
-		let i = await x({
+function I(o = {}) {
+	let j = o.execute ?? ((t) => e(t)), N = o.activeWorkspaceId ?? n, I = o.activeActorId ?? t, B = o.now ?? Date.now, V = !0, H = 0, K = !1, Y = 0, X = /* @__PURE__ */ new Set(), Z = (e) => {
+		if (e || (H = B() + M), e !== V) {
+			V = e;
+			for (let t of [...X]) try {
+				t(e);
+			} catch {}
+		}
+	}, Q = async (e, t, n, r) => {
+		if (!e.workspaceId || !e.actorId || F(N) !== e.workspaceId || F(I) !== e.actorId) throw new a();
+		let o = await j({
 			query: n,
 			operationName: t,
 			variables: r,
 			workspaceId: e.workspaceId
 		});
-		if (!E(i)) throw new v(t, "no data");
-		return i;
+		if (!U(o)) throw new i(t, "no data");
+		return o;
+	}, $ = async (e, t, n, i, o = {}) => {
+		let { full: c, base: l } = n, u = async () => {
+			if (!l) throw new r(t);
+			return i(await Q(e, t, l.query, l.variables), !1);
+		};
+		if (!V) {
+			if (!(o.probe === !0 && (K || B() >= H))) return u();
+			K = !1, H = B() + M;
+		}
+		let d;
+		try {
+			d = await Q(e, t, c.query, c.variables);
+		} catch (n) {
+			if (n instanceof a) throw n;
+			if (s(n)) return Y = 0, Z(!1), u();
+			if (l && P(n) && (Y += 1, Y >= 2)) {
+				Y = 0;
+				let r;
+				try {
+					r = await Q(e, t, l.query, l.variables);
+				} catch {
+					throw n;
+				}
+				return Z(!1), i(r, !1);
+			}
+			throw n;
+		}
+		Y = 0;
+		let f = i(d, !0);
+		return Z(!0), f;
 	};
 	return {
-		async changes(e, t) {
-			let n = await j(e, r, i, h(e, t)), a = D(r), o = a.record(n.myAssistantHistoryChanges, "myAssistantHistoryChanges");
-			return {
-				nodes: a.list(o.nodes, "nodes").map((e) => k(a, e)),
-				pageInfo: O(a, o.pageInfo),
-				resetRequired: a.bool(o.resetRequired, "resetRequired")
+		controlsAvailable: () => V,
+		onControlsChange(e) {
+			return X.add(e), () => {
+				X.delete(e);
 			};
 		},
+		recheckControls() {
+			V || (K = !0);
+		},
+		async changes(e, t) {
+			let n = O(e, t);
+			return $(e, c, {
+				full: {
+					query: l,
+					variables: n
+				},
+				base: {
+					query: u,
+					variables: n
+				}
+			}, (e, t) => {
+				let n = W(c), r = n.record(e.myAssistantHistoryChanges, "myAssistantHistoryChanges");
+				return {
+					nodes: n.list(r.nodes, "nodes").map((e) => q(n, e, t)),
+					pageInfo: G(n, r.pageInfo),
+					resetRequired: n.bool(r.resetRequired, "resetRequired")
+				};
+			}, { probe: !0 });
+		},
 		async conversations(e, t) {
-			let n = await j(e, a, o, h(e, t)), r = D(a), i = r.record(n.myAssistantConversations, "myAssistantConversations");
-			return {
-				nodes: r.list(i.nodes, "nodes").map((e) => k(r, e)),
-				pageInfo: O(r, i.pageInfo)
-			};
+			return $(e, d, {
+				full: {
+					query: f,
+					variables: D(e, t)
+				},
+				base: t.filter ? null : {
+					query: p,
+					variables: O(e, t)
+				}
+			}, (e, t) => {
+				let n = W(d), r = n.record(e.myAssistantConversations, "myAssistantConversations");
+				return {
+					nodes: n.list(r.nodes, "nodes").map((e) => q(n, e, t)),
+					pageInfo: G(n, r.pageInfo)
+				};
+			});
 		},
 		async entries(e, t, n) {
-			let r = await j(e, l, u, m(e, t, n)), i = D(l), a = i.record(r.myAssistantConversationEntries, "myAssistantConversationEntries");
-			return {
-				conversation: k(i, a.conversation),
-				nodes: i.list(a.nodes, "nodes").map((e) => A(i, e)),
-				pageInfo: O(i, a.pageInfo)
-			};
+			let r = E(e, t, n);
+			return $(e, _, {
+				full: {
+					query: v,
+					variables: r
+				},
+				base: {
+					query: y,
+					variables: r
+				}
+			}, (e, t) => {
+				let n = W(_), r = n.record(e.myAssistantConversationEntries, "myAssistantConversationEntries");
+				return {
+					conversation: q(n, r.conversation, t),
+					nodes: n.list(r.nodes, "nodes").map((e) => J(n, e)),
+					pageInfo: G(n, r.pageInfo)
+				};
+			});
 		},
 		async save(e, t) {
-			let n = await j(e, f, d, g(e, t)), r = D(f), i = r.record(n.saveMyAssistantHistoryEntries, "saveMyAssistantHistoryEntries");
-			return {
-				outcome: r.oneOf(i.outcome, S, "outcome"),
-				conversation: k(r, i.conversation),
-				entries: r.list(i.entries, "entries").map((e) => A(r, e)),
-				droppedMetadataKeys: r.list(i.droppedMetadataKeys, "droppedMetadataKeys").map((e) => r.string(e, "droppedMetadataKeys[]"))
-			};
+			let n = k(e, t);
+			return $(e, S, {
+				full: {
+					query: b,
+					variables: n
+				},
+				base: {
+					query: x,
+					variables: n
+				}
+			}, (e, t) => {
+				let n = W(S), r = n.record(e.saveMyAssistantHistoryEntries, "saveMyAssistantHistoryEntries");
+				return {
+					outcome: n.oneOf(r.outcome, L, "outcome"),
+					conversation: q(n, r.conversation, t),
+					entries: n.list(r.entries, "entries").map((e) => J(n, e)),
+					droppedMetadataKeys: n.list(r.droppedMetadataKeys, "droppedMetadataKeys").map((e) => n.string(e, "droppedMetadataKeys[]"))
+				};
+			});
 		},
 		async remove(e, t) {
-			let n = await j(e, c, s, p(e, t)), r = D(c), i = r.record(n.deleteMyAssistantConversation, "deleteMyAssistantConversation");
-			return {
-				outcome: r.oneOf(i.outcome, C, "outcome"),
-				conversation: i.conversation == null ? null : k(r, i.conversation)
-			};
+			let n = T(e, t);
+			return $(e, g, {
+				full: {
+					query: m,
+					variables: n
+				},
+				base: {
+					query: h,
+					variables: n
+				}
+			}, (e, t) => {
+				let n = W(g), r = n.record(e.deleteMyAssistantConversation, "deleteMyAssistantConversation");
+				return {
+					outcome: n.oneOf(r.outcome, R, "outcome"),
+					conversation: r.conversation == null ? null : q(n, r.conversation, t)
+				};
+			});
+		},
+		async update(e, t, n) {
+			return $(e, w, {
+				full: {
+					query: C,
+					variables: A(e, t, n)
+				},
+				base: null
+			}, (e) => {
+				let t = W(w), n = t.record(e.updateMyAssistantConversation, "updateMyAssistantConversation");
+				return {
+					outcome: t.oneOf(n.outcome, z, "outcome"),
+					conversation: q(t, n.conversation, !0)
+				};
+			});
 		}
 	};
 }
-var S = [
+var L = [
 	"APPLIED",
 	"ALREADY_APPLIED",
 	"CONVERSATION_DELETED"
-], C = [
+], R = [
 	"DELETED",
 	"ALREADY_DELETED",
 	"TOMBSTONED_UNSEEN",
 	"NOT_PRESENT"
-], w = [
+], z = [
+	"APPLIED",
+	"ALREADY_APPLIED",
+	"CONVERSATION_DELETED",
+	"PIN_LIMIT_REACHED"
+], B = [
+	"CHAT",
+	"VOICE",
+	"MIXED"
+], V = [
 	"USER",
 	"ASSISTANT",
 	"NOTE"
-], T = [
+], H = [
 	"TURN",
 	"LOCAL_COMMAND",
 	"NOTE"
 ];
-function E(e) {
+function U(e) {
 	return typeof e == "object" && !!e && !Array.isArray(e);
 }
-function D(e) {
+function W(e) {
 	let t = (t) => {
-		throw new v(e, t);
+		throw new i(e, t);
 	};
 	return {
-		record: (e, n) => E(e) ? e : t(n),
+		record: (e, n) => U(e) ? e : t(n),
 		list: (e, n) => Array.isArray(e) ? e : t(n),
 		string: (e, n) => typeof e == "string" ? e : t(n),
 		optionalString: (e, n) => e == null ? null : typeof e == "string" ? e : t(n),
 		int: (e, n) => typeof e == "number" && Number.isSafeInteger(e) ? e : t(n),
 		optionalInt: (e, n) => e == null ? null : typeof e == "number" && Number.isSafeInteger(e) ? e : t(n),
 		bool: (e, n) => typeof e == "boolean" ? e : t(n),
-		time: (e, n) => _(e) ?? t(n),
+		time: (e, n) => j(e) ?? t(n),
 		oneOf: (e, n, r) => n.find((t) => t === e) ?? t(r)
 	};
 }
-function O(e, t) {
+function G(e, t) {
 	let n = e.record(t, "pageInfo");
 	return {
 		hasNextPage: e.bool(n.hasNextPage, "pageInfo.hasNextPage"),
@@ -119,35 +246,53 @@ function O(e, t) {
 		endCursor: e.optionalString(n.endCursor, "pageInfo.endCursor")
 	};
 }
-function k(e, t) {
-	let n = e.record(t, "conversation");
+function K(e) {
+	let t = {};
+	for (let n of ["pinnedAt", "archivedAt"]) {
+		let r = e[n];
+		if (r === null) t[n] = null;
+		else {
+			let e = j(r);
+			e !== null && (t[n] = e);
+		}
+	}
+	if (e.channel === null) t.channel = null;
+	else {
+		let n = B.find((t) => t === e.channel);
+		n && (t.channel = n);
+	}
+	return t;
+}
+function q(e, t, n) {
+	let r = e.record(t, "conversation");
 	return {
-		id: e.string(n.id, "conversation.id"),
-		clientConversationId: e.optionalString(n.clientConversationId, "conversation.clientConversationId"),
-		productId: e.string(n.productId, "conversation.productId"),
-		title: e.optionalString(n.title, "conversation.title"),
-		legacy: e.bool(n.legacy, "conversation.legacy"),
-		revision: e.int(n.revision, "conversation.revision"),
-		lastMessageSeq: e.int(n.lastMessageSeq, "conversation.lastMessageSeq"),
-		deleted: e.bool(n.deleted, "conversation.deleted"),
-		deletedAt: n.deletedAt == null ? null : e.time(n.deletedAt, "conversation.deletedAt"),
-		createdAt: e.time(n.createdAt, "conversation.createdAt"),
-		updatedAt: e.time(n.updatedAt, "conversation.updatedAt")
+		id: e.string(r.id, "conversation.id"),
+		clientConversationId: e.optionalString(r.clientConversationId, "conversation.clientConversationId"),
+		productId: e.string(r.productId, "conversation.productId"),
+		title: e.optionalString(r.title, "conversation.title"),
+		legacy: e.bool(r.legacy, "conversation.legacy"),
+		revision: e.int(r.revision, "conversation.revision"),
+		lastMessageSeq: e.int(r.lastMessageSeq, "conversation.lastMessageSeq"),
+		deleted: e.bool(r.deleted, "conversation.deleted"),
+		deletedAt: r.deletedAt == null ? null : e.time(r.deletedAt, "conversation.deletedAt"),
+		createdAt: e.time(r.createdAt, "conversation.createdAt"),
+		updatedAt: e.time(r.updatedAt, "conversation.updatedAt"),
+		...n ? K(r) : {}
 	};
 }
-function A(e, t) {
+function J(e, t) {
 	let n = e.record(t, "entry");
 	return {
 		id: e.string(n.id, "entry.id"),
 		clientMessageId: e.optionalString(n.clientMessageId, "entry.clientMessageId"),
-		kind: T.find((e) => e === n.kind) ?? null,
-		role: e.oneOf(n.role, w, "entry.role"),
+		kind: H.find((e) => e === n.kind) ?? null,
+		role: e.oneOf(n.role, V, "entry.role"),
 		content: e.string(n.content, "entry.content"),
 		seq: e.optionalInt(n.seq, "entry.seq"),
 		createdAt: e.time(n.createdAt, "entry.createdAt"),
 		clientCreatedAt: e.optionalString(n.clientCreatedAt, "entry.clientCreatedAt"),
-		metadata: E(n.metadata) ? n.metadata : null
+		metadata: U(n.metadata) ? n.metadata : null
 	};
 }
 //#endregion
-export { v as AssistantHistoryResponseError, y as AssistantHistoryScopeInactiveError, x as createGatewayHistoryTransport };
+export { M as ASSISTANT_HISTORY_CONTROLS_RECHECK_MS, N as ASSISTANT_HISTORY_MASKED_DRIFT_STREAK, I as createGatewayHistoryTransport };

package/dist/shared/assistant/history/historyControls.d.ts

@@ -0,0 +1,86 @@
+import { Conversation } from '../conversation';
+import { AssistantHistoryChannel, AssistantHistoryConvKey, AssistantHistoryConversationFilter, AssistantHistoryHeader, AssistantHistoryOutboxItem, AssistantHistoryScopeKey, AssistantHistoryUpdatePatch } from './historyTypes';
+/**
+ * The server's cap on pinned conversations per person, workspace and product
+ * (wspace-conversations `MAX_PINNED_PER_SCOPE`). The server enforces it
+ * (`PIN_LIMIT_REACHED`); here it is only the number the notice names, and the
+ * bound on the pinned fetch.
+ */
+export declare const MAX_PINNED = 50;
+/** A title's length on the server, in code points (not UTF-16 units). */
+export declare const HISTORY_TITLE_MAX_CODE_POINTS = 80;
+/** `text` cut to at most `max` code points (never splitting a surrogate pair). */
+export declare function clampToCodePoints(text: string, max: number): string;
+/** How many code points `text` holds. */
+export declare function codePointLength(text: string): number;
+/**
+ * A title exactly as the server will store it: what cannot be stored becomes
+ * U+FFFD, every run of whitespace one space, trimmed, then at most 80 code
+ * points (and trimmed again, so a cut never leaves a trailing space the server
+ * would remove). Empty means "no title": the server refuses one.
+ */
+export declare function normaliseHistoryTitle(text: string): string;
+/**
+ * One patch from two queued ones, the newer winning field by field — and the
+ * pair rule kept: a newer archive drops an older pin, a newer pin drops an
+ * older archive (the server refuses both at once, and would apply them in
+ * that order anyway).
+ */
+export declare function coalesceUpdatePatch(older: AssistantHistoryUpdatePatch, newer: AssistantHistoryUpdatePatch): AssistantHistoryUpdatePatch;
+/** A patch the server accepts: at least one field, and never pin and archive together. */
+export declare function isValidUpdatePatch(patch: AssistantHistoryUpdatePatch): boolean;
+/**
+ * Which kinds of person turns this device holds for a conversation, from the
+ * voice marker on its USER messages (notes and replies do not count; a local
+ * command counts as the person's turn, as on the server). Null with none.
+ */
+export declare function localChannelOf(conversation: Pick<Conversation, "messages">): AssistantHistoryChannel | null;
+/** A queued control change, as the row reads it. */
+export interface AssistantHistoryPendingUpdate {
+    patch: AssistantHistoryUpdatePatch;
+    /** Epoch ms the person made it. */
+    at: number;
+}
+/** The queued control changes of one scope, per conversation, oldest first. */
+export declare function pendingUpdatesByConversation(outbox: readonly AssistantHistoryOutboxItem[], scopeKey: AssistantHistoryScopeKey | null): Record<AssistantHistoryConvKey, AssistantHistoryPendingUpdate[]>;
+/** What one row shows for the controls. */
+export interface AssistantHistoryRowControls {
+    /** A queued rename's title; null when none is queued (the row keeps its own). */
+    pendingTitle: string | null;
+    pinnedAt: string | null;
+    archivedAt: string | null;
+    channel: AssistantHistoryChannel | null;
+    /** The server's control state is known here (a header with the controls, or a queued change). */
+    known: boolean;
+    /** A control change is queued and not answered yet. */
+    pending: boolean;
+}
+/**
+ * A row's controls. Precedence: the queued changes (oldest to newest), then
+ * the header, then this device's conversation.
+ *
+ * - Pin and archive come from the header (this device keeps no pin or archive
+ *   of its own); a queued change overrides them, dated by when it was made.
+ * - The channel is the UNION of the header's and this device's: the header
+ *   counts every stored turn, this device may hold a spoken turn the server
+ *   has not stored yet, or only a window of the older ones.
+ * - The title: a queued rename; otherwise the row's own (the engine keeps a
+ *   held conversation's title in step with the server, and a title renamed on
+ *   this device before renames were synced — `titleLocked` — stays here).
+ */
+export declare function resolveRowControls(conversation: Pick<Conversation, "messages"> | null, header: AssistantHistoryHeader | null, pending?: readonly AssistantHistoryPendingUpdate[]): AssistantHistoryRowControls;
+/** The list's default: every conversation that is not archived. */
+export declare const DEFAULT_HISTORY_LIST_FILTER: Readonly<AssistantHistoryConversationFilter>;
+/**
+ * Does a row pass the filter — the server's rule, applied here to what the
+ * device holds: CHAT means it holds a typed person turn, VOICE a spoken one,
+ * and a MIXED row matches both. A row whose channel is unknown matches only
+ * ANY. Archived rows are left out unless asked for.
+ */
+export declare function matchesHistoryFilter(row: Pick<AssistantHistoryRowControls, "pinnedAt" | "archivedAt" | "channel">, filter?: Readonly<AssistantHistoryConversationFilter>): boolean;
+/**
+ * A filter as a stable key ("" for none): the list's "Show older" listing is
+ * paged per filter, and its `hasMore` answers for one key only.
+ */
+export declare function historyFilterKey(filter: Readonly<AssistantHistoryConversationFilter> | undefined): string;
+//# sourceMappingURL=historyControls.d.ts.map

package/dist/shared/assistant/history/historyControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historyControls.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/history/historyControls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,kCAAkC,EAClC,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,2BAA2B,EAC5B,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,yEAAyE;AACzE,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAOhD,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED,yCAAyC;AACzC,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,2BAA2B,EAClC,KAAK,EAAE,2BAA2B,GACjC,2BAA2B,CAK7B;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAQ9E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG,uBAAuB,GAAG,IAAI,CAa3G;AASD,oDAAoD;AACpD,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,2BAA2B,CAAC;IACnC,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,+EAA+E;AAC/E,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,0BAA0B,EAAE,EAC7C,QAAQ,EAAE,wBAAwB,GAAG,IAAI,GACxC,MAAM,CAAC,uBAAuB,EAAE,6BAA6B,EAAE,CAAC,CAQlE;AAED,2CAA2C;AAC3C,MAAM,WAAW,2BAA2B;IAC1C,iFAAiF;IACjF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACxC,iGAAiG;IACjG,KAAK,EAAE,OAAO,CAAC;IACf,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG,IAAI,EACnD,MAAM,EAAE,sBAAsB,GAAG,IAAI,EACrC,OAAO,GAAE,SAAS,6BAA6B,EAAO,GACrD,2BAA2B,CAkC7B;AAED,mEAAmE;AACnE,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,kCAAkC,CAIpF,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,IAAI,CAAC,2BAA2B,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS,CAAC,EAC7E,MAAM,GAAE,QAAQ,CAAC,kCAAkC,CAA+B,GACjF,OAAO,CAWT;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,kCAAkC,CAAC,GAAG,SAAS,GAAG,MAAM,CAIzG"}