@burdenoff/fe-libs 2026.926.1 → 2026.926.3

package/dist/shared/assistant/turnTimeline.js

@@ -7,6 +7,8 @@ var e = [
 	"accepted",
 	"cleared",
 	"attemptStarted",
+	"prewarmJoined",
+	"bootAdopted",
 	"provisionStarted",
 	"createRequested",
 	"sandboxRunning",
@@ -22,6 +24,8 @@ var e = [
 	"firstAudio"
 ], t = [
 	"attemptStarted",
+	"prewarmJoined",
+	"bootAdopted",
 	"provisionStarted",
 	"createRequested",
 	"sandboxRunning",
@@ -32,14 +36,19 @@ var e = [
 	"firstOutput",
 	"firstText",
 	"answerDone"
-], n = "burdenoff:assistant-turn-timeline", r = 50, i = /* @__PURE__ */ new Map();
-function a() {
+], n = "burdenoff:assistant-turn-timeline", r = 50, i = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Set();
+function o(e) {
+	return a.add(e), () => {
+		a.delete(e);
+	};
+}
+function s() {
 	try {
 		if (typeof performance < "u" && typeof performance?.now == "function") return performance.now();
 	} catch {}
 	return Date.now();
 }
-function o() {
+function c() {
 	try {
 		let e = typeof window > "u" ? null : window;
 		return !e || typeof e.matchMedia != "function" ? "unknown" : e.matchMedia("(pointer: coarse)").matches ? "touch" : "pointer";
@@ -47,7 +56,7 @@ function o() {
 		return "unknown";
 	}
 }
-function s(e) {
+function l(e) {
 	return {
 		...e,
 		at: { ...e.at },
@@ -57,8 +66,11 @@ function s(e) {
 		})) } : {}
 	};
 }
-function c(e) {
-	let t = s(e), r = () => {
+function u(e) {
+	let t = l(e), r = () => {
+		for (let e of [...a]) try {
+			e(l(t));
+		} catch {}
 		try {
 			let e = typeof window > "u" ? null : window;
 			if (!e || typeof e.dispatchEvent != "function" || typeof CustomEvent != "function") return;
@@ -67,7 +79,7 @@ function c(e) {
 	};
 	typeof queueMicrotask == "function" ? queueMicrotask(r) : r();
 }
-function l(e, t, n) {
+function d(e, t, n) {
 	if (i.has(e)) return;
 	let a = {};
 	n?.speechEnded !== void 0 && (a.speechEnded = n.speechEnded), n?.graceStarted !== void 0 && (a.graceStarted = n.graceStarted), n?.graceEnded !== void 0 && (a.graceEnded = n.graceEnded), n?.handedOver !== void 0 && (a.handedOver = n.handedOver);
@@ -81,42 +93,42 @@ function l(e, t, n) {
 		if (e === void 0) break;
 		i.delete(e);
 	}
-	c(o);
+	u(o);
 }
-function u(e, t, n = a()) {
+function f(e, t, n = s()) {
 	let r = i.get(e);
-	!r || r.at[t] !== void 0 || (r.at[t] = n, c(r));
+	!r || r.at[t] !== void 0 || (r.at[t] = n, u(r));
 }
-function d(e, t) {
+function p(e, t) {
 	let n = i.get(e);
 	if (!n) return;
 	let r = !1;
-	t.runtime !== void 0 && n.runtime === void 0 && (n.runtime = t.runtime, r = !0), t.usedTools !== void 0 && n.usedTools === void 0 && (n.usedTools = t.usedTools, r = !0), t.deadSandboxProbe !== void 0 && n.deadSandboxProbe === void 0 && (n.deadSandboxProbe = t.deadSandboxProbe, r = !0), t.cacheProofFailed !== void 0 && n.cacheProofFailed === void 0 && (n.cacheProofFailed = t.cacheProofFailed, r = !0), t.prewarm !== void 0 && n.prewarm === void 0 && (n.prewarm = t.prewarm, r = !0), t.outcome !== void 0 && n.outcome === void 0 && (n.outcome = t.outcome, r = !0), r && c(n);
+	t.runtime !== void 0 && n.runtime === void 0 && (n.runtime = t.runtime, r = !0), t.usedTools !== void 0 && n.usedTools === void 0 && (n.usedTools = t.usedTools, r = !0), t.deadSandboxProbe !== void 0 && n.deadSandboxProbe === void 0 && (n.deadSandboxProbe = t.deadSandboxProbe, r = !0), t.cacheProofFailed !== void 0 && n.cacheProofFailed === void 0 && (n.cacheProofFailed = t.cacheProofFailed, r = !0), t.prewarm !== void 0 && n.prewarm === void 0 && (n.prewarm = t.prewarm, r = !0), t.outcome !== void 0 && n.outcome === void 0 && (n.outcome = t.outcome, r = !0), r && u(n);
 }
-function f(e, n = a()) {
+function m(e, n = s()) {
 	let r = i.get(e);
 	if (!r) return;
-	let o = {
+	let a = {
 		at: {},
 		endedAt: n
 	};
 	for (let e of t) {
 		let t = r.at[e];
-		t !== void 0 && (o.at[e] = t, delete r.at[e]);
+		t !== void 0 && (a.at[e] = t, delete r.at[e]);
 	}
-	r.runtime !== void 0 && (o.runtime = r.runtime), r.usedTools !== void 0 && (o.usedTools = r.usedTools), r.deadSandboxProbe !== void 0 && (o.deadSandboxProbe = r.deadSandboxProbe), r.cacheProofFailed !== void 0 && (o.cacheProofFailed = r.cacheProofFailed), r.prewarm !== void 0 && (o.prewarm = r.prewarm), delete r.runtime, delete r.usedTools, delete r.deadSandboxProbe, delete r.cacheProofFailed, delete r.prewarm, r.attempts = [...r.attempts ?? [], o], r.retried = !0, c(r);
+	r.runtime !== void 0 && (a.runtime = r.runtime), r.usedTools !== void 0 && (a.usedTools = r.usedTools), r.deadSandboxProbe !== void 0 && (a.deadSandboxProbe = r.deadSandboxProbe), r.cacheProofFailed !== void 0 && (a.cacheProofFailed = r.cacheProofFailed), r.prewarm !== void 0 && (a.prewarm = r.prewarm), delete r.runtime, delete r.usedTools, delete r.deadSandboxProbe, delete r.cacheProofFailed, delete r.prewarm, r.attempts = [...r.attempts ?? [], a], r.retried = !0, u(r);
 }
-function p(e) {
+function h(e) {
 	let t = i.get(e);
-	return t ? s(t) : void 0;
+	return t ? l(t) : void 0;
 }
-function m() {
-	return [...i.values()].map(s);
+function g() {
+	return [...i.values()].map(l);
 }
-function h() {
+function _() {
 	i.clear();
 }
-var g = [
+var v = [
 	{
 		name: "endpointing",
 		from: "speechEnded",
@@ -238,38 +250,38 @@ var g = [
 		to: "firstAudio"
 	}
 ];
-function _(e) {
+function y(e) {
 	let t = {};
-	for (let { name: n, from: r, to: i } of g) {
+	for (let { name: n, from: r, to: i } of v) {
 		let a = e.at[r], o = e.at[i];
 		a !== void 0 && o !== void 0 && o >= a && (t[n] = o - a);
 	}
 	return t;
 }
-function v(e, t) {
+function b(e, t) {
 	return e[Math.max(1, Math.ceil(t * e.length)) - 1];
 }
-function y(e) {
+function x(e) {
 	if (!e.length) return;
 	let t = [...e].sort((e, t) => e - t), n = Math.floor(t.length / 2), r = t.length % 2 ? t[n] : (t[n - 1] + t[n]) / 2;
 	return {
 		n: t.length,
 		median: r,
-		p90: v(t, .9),
+		p90: b(t, .9),
 		max: t[t.length - 1]
 	};
 }
-function b(e) {
+function S(e) {
 	return e.outcome === "answered" && !e.retried;
 }
-function x(e, t, n = b) {
+function C(e, t, n = S) {
 	let r = /* @__PURE__ */ new Map();
 	for (let i of e) {
 		if (!n(i)) continue;
 		let e = t(i), a = r.get(e) ?? /* @__PURE__ */ new Map();
 		r.set(e, a);
-		let o = _(i);
-		for (let { name: e } of g) {
+		let o = y(i);
+		for (let { name: e } of v) {
 			let t = o[e];
 			if (t === void 0) continue;
 			let n = a.get(e) ?? [];
@@ -280,7 +292,7 @@ function x(e, t, n = b) {
 	for (let [e, t] of r) {
 		let n = {};
 		for (let [e, r] of t) {
-			let t = y(r);
+			let t = x(r);
 			t && (n[e] = t);
 		}
 		i[e] = n;
@@ -288,4 +300,4 @@ function x(e, t, n = b) {
 	return i;
 }
 //#endregion
-export { e as TURN_MILESTONES, g as TURN_SEGMENTS, n as TURN_TIMELINE_EVENT, l as beginTurn, d as describeTurn, o as detectTurnDevice, b as isComparableTurn, u as markTurn, m as recentTurnTimelines, h as resetTurnTimelines, f as restartAttempt, y as segmentStats, x as summariseTurnTimelines, a as turnClockMs, _ as turnSegments, p as turnTimeline };
+export { e as TURN_MILESTONES, v as TURN_SEGMENTS, n as TURN_TIMELINE_EVENT, d as beginTurn, p as describeTurn, c as detectTurnDevice, S as isComparableTurn, f as markTurn, g as recentTurnTimelines, _ as resetTurnTimelines, m as restartAttempt, x as segmentStats, o as subscribeTurnTimelines, C as summariseTurnTimelines, s as turnClockMs, y as turnSegments, h as turnTimeline };

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

@@ -0,0 +1,86 @@
+import { TurnTimeline } from './turnTimeline';
+/**
+ * One finished turn as `reportMyAssistantTurnTimings` takes it
+ * (`AssistantTurnTimingInput`). Dimensions are plain strings: the service maps
+ * anything it does not know to `other` rather than failing the report.
+ */
+export interface AssistantTurnTimingReport {
+    product: string;
+    channel: string;
+    mode: string;
+    /** Raw, as the timeline recorded it; the service derives cold/warm. */
+    runtime?: string;
+    prewarm?: string;
+    outcome: string;
+    retried: boolean;
+    runtimeReadyMs?: number;
+    modelStartMs?: number;
+    firstVisibleOutputMs?: number;
+    firstUsefulOutputMs?: number;
+    firstAudioMs?: number;
+    completeMs: number;
+}
+/**
+ * How a RETRIED turn reads a stage (see the header):
+ * - `earliest`: the first time any attempt reached it — what the person saw;
+ * - `final`: from the attempt that finished the turn;
+ * - `omit`: not reported — it describes one attempt's runtime, not the turn's.
+ */
+export type TurnTimingRetryRule = "earliest" | "final" | "omit";
+/** Each operator stage, the timeline mark it is read from, and its retry rule. */
+export declare const TURN_TIMING_STAGES: readonly [{
+    readonly field: "runtimeReadyMs";
+    readonly milestone: "runtimeReady";
+    readonly onRetry: "omit";
+}, {
+    readonly field: "modelStartMs";
+    readonly milestone: "promptSent";
+    readonly onRetry: "omit";
+}, {
+    readonly field: "firstVisibleOutputMs";
+    readonly milestone: "firstOutput";
+    readonly onRetry: "earliest";
+}, {
+    readonly field: "firstUsefulOutputMs";
+    readonly milestone: "firstText";
+    readonly onRetry: "final";
+}, {
+    readonly field: "firstAudioMs";
+    readonly milestone: "firstAudio";
+    readonly onRetry: "final";
+}, {
+    readonly field: "completeMs";
+    readonly milestone: "complete";
+    readonly onRetry: "final";
+}];
+/**
+ * The outcome of a turn the page was left during (see the header). A report
+ * outcome only — a timeline never carries it.
+ */
+export declare const ABANDONED_TURN_OUTCOME = "abandoned";
+/**
+ * The longest turn the service accepts (its `maxStageMs`, two hours). An
+ * "abandoned" turn older than that was stuck, not waited on.
+ */
+export declare const MAX_REPORTED_TURN_MS: number;
+/** Every key a report may carry — the privacy allowlist, stated once. */
+export declare const TURN_TIMING_REPORT_FIELDS: readonly ["product", "channel", "mode", "runtime", "prewarm", "outcome", "retried", ...("runtimeReadyMs" | "modelStartMs" | "firstVisibleOutputMs" | "firstUsefulOutputMs" | "firstAudioMs" | "completeMs")[]];
+/**
+ * Finished: it has an outcome and it ended. Every exit path marks `complete`
+ * in a `finally`, and every one of them sets an outcome.
+ */
+export declare function isFinishedTurn(timeline: TurnTimeline): boolean;
+/**
+ * The report for a finished turn, or null when it cannot be reported (not
+ * finished, no product, or an end that came before its start).
+ */
+export declare function buildTurnTimingReport(timeline: TurnTimeline): AssistantTurnTimingReport | null;
+/**
+ * The report for a turn that was still running when the page was left at
+ * `leftAt` (a `turnClockMs` time): outcome {@link ABANDONED_TURN_OUTCOME},
+ * `completeMs` the time to leaving, and the stages it reached by then. Null
+ * when it is finished (it reports itself), was never accepted, has no
+ * product, or would be older than any turn the service accepts.
+ */
+export declare function buildAbandonedTurnReport(timeline: TurnTimeline, leftAt: number): AssistantTurnTimingReport | null;
+//# sourceMappingURL=turnTimingReport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"turnTimingReport.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/turnTimingReport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwFG;AAEH,OAAO,KAAK,EAKV,YAAY,EACb,MAAM,gBAAgB,CAAC;AAExB;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAUD;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAEhE,kFAAkF;AAClF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;EAW5B,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,sBAAsB,cAAc,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAAqB,CAAC;AAEvD,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,gNAS5B,CAAC;AAEX;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAM9D;AAmJD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,GACrB,yBAAyB,GAAG,IAAI,CAMlC;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,MAAM,GACb,yBAAyB,GAAG,IAAI,CAQlC"}

package/dist/shared/assistant/turnTimingReport.js

@@ -0,0 +1,123 @@
+//#region src/shared/assistant/turnTimingReport.ts
+var e = [
+	{
+		field: "runtimeReadyMs",
+		milestone: "runtimeReady",
+		onRetry: "omit"
+	},
+	{
+		field: "modelStartMs",
+		milestone: "promptSent",
+		onRetry: "omit"
+	},
+	{
+		field: "firstVisibleOutputMs",
+		milestone: "firstOutput",
+		onRetry: "earliest"
+	},
+	{
+		field: "firstUsefulOutputMs",
+		milestone: "firstText",
+		onRetry: "final"
+	},
+	{
+		field: "firstAudioMs",
+		milestone: "firstAudio",
+		onRetry: "final"
+	},
+	{
+		field: "completeMs",
+		milestone: "complete",
+		onRetry: "final"
+	}
+], t = "abandoned", n = 7200 * 1e3, r = [
+	"product",
+	"channel",
+	"mode",
+	"runtime",
+	"prewarm",
+	"outcome",
+	"retried",
+	...e.map((e) => e.field)
+];
+function i(e) {
+	return e.outcome !== void 0 && e.at.accepted !== void 0 && e.at.complete !== void 0;
+}
+function a(e, t) {
+	let n = Math.ceil(t - e);
+	return Number.isSafeInteger(n) ? n : void 0;
+}
+function o(e, t, n = !1) {
+	let r = e.at.accepted;
+	if (r === void 0) return;
+	let i = n ? [...(e.attempts ?? []).map((e) => e.at[t]), e.at[t]] : [e.at[t]], o;
+	for (let e of i) e === void 0 || e < r || (o === void 0 || e < o) && (o = e);
+	return o === void 0 ? void 0 : a(r, o);
+}
+var s = {
+	warm: 0,
+	"new-session": 1,
+	probed: 2,
+	adopted: 3,
+	cold: 4
+}, c = [
+	"createRequested",
+	"sandboxRunning",
+	"serviceReady"
+];
+function l(e) {
+	return e.runtime === void 0 ? c.some((t) => e.at[t] !== void 0) ? "cold" : e.at.bootAdopted === void 0 ? void 0 : "adopted" : e.runtime;
+}
+function u(e) {
+	return e.prewarm === void 0 ? e.runtime === void 0 && e.at.prewarmJoined !== void 0 ? "joined" : void 0 : e.prewarm;
+}
+var d = {
+	hit: 0,
+	joined: 1,
+	joinedFailed: 2
+};
+function f(e, t) {
+	let n;
+	for (let r of e) r !== void 0 && (n === void 0 || t[r] > t[n]) && (n = r);
+	return n;
+}
+function p(e) {
+	let t = [...e.attempts ?? [], e];
+	return {
+		runtime: f(t.map(l), s),
+		prewarm: f(t.map(u), d)
+	};
+}
+function m(e, t, n) {
+	return e === "firstUsefulOutputMs" ? t === "answered" : e === "firstAudioMs" ? t === "answered" && n === "voice" : !0;
+}
+function h(t, n, r) {
+	let i = t.retried === !0, { runtime: a, prewarm: s } = p(t), c = {
+		product: t.product,
+		channel: t.channel,
+		mode: t.mode,
+		outcome: n,
+		retried: i,
+		completeMs: r
+	};
+	a !== void 0 && (c.runtime = a), s !== void 0 && (c.prewarm = s);
+	for (let { field: r, milestone: a, onRetry: s } of e) {
+		if (r === "completeMs" || !m(r, n, t.channel) || i && s === "omit") continue;
+		let e = o(t, a, i && s === "earliest");
+		e !== void 0 && (c[r] = e);
+	}
+	return c;
+}
+function g(e) {
+	if (!i(e) || !e.outcome || !e.product) return null;
+	let t = o(e, "complete");
+	return t === void 0 ? null : h(e, e.outcome, t);
+}
+function _(e, n) {
+	let r = e.at.accepted;
+	if (i(e) || r === void 0 || !e.product || !Number.isFinite(n) || n < r) return null;
+	let o = a(r, n);
+	return o === void 0 || o > 72e5 ? null : h(e, t, o);
+}
+//#endregion
+export { t as ABANDONED_TURN_OUTCOME, n as MAX_REPORTED_TURN_MS, r as TURN_TIMING_REPORT_FIELDS, e as TURN_TIMING_STAGES, _ as buildAbandonedTurnReport, g as buildTurnTimingReport, i as isFinishedTurn };

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

@@ -0,0 +1,146 @@
+import { GraphQLFetchOptions, GraphQLResponse } from '../graphql';
+import { AssistantTurnTimingReport } from './turnTimingReport';
+import { TurnTimeline } from './turnTimeline';
+import { AssistantSandboxAuthContext } from './types';
+/** What the service did with a batch (`AssistantTurnTimingsReceipt`). */
+export interface AssistantTurnTimingsReceipt {
+    enabled: boolean;
+    accepted: number;
+    rejected: number;
+    duplicate: boolean;
+    rateLimited: boolean;
+}
+/** One request's worth of finished turns. */
+export interface TurnTimingBatch {
+    /** Random, per request — only so the service can ignore a repeat. */
+    nonce: string;
+    turns: AssistantTurnTimingReport[];
+    /** The page may be going away: send with fetch `keepalive`. */
+    keepalive: boolean;
+}
+/**
+ * What became of a batch, as far as the reporter needs to know:
+ * - `receipt`: the service answered;
+ * - `unsupported`: the supergraph does not know the mutation, or refused it in
+ *   a way the next batch would be refused too — stop for the page;
+ * - `dropped`: anything else (offline, a 5xx, an expired session). The batch
+ *   is gone; it is never re-sent.
+ */
+export type TurnTimingSendOutcome = {
+    kind: "receipt";
+    receipt: AssistantTurnTimingsReceipt;
+} | {
+    kind: "unsupported";
+} | {
+    kind: "dropped";
+};
+export type TurnTimingSender = (batch: TurnTimingBatch) => Promise<TurnTimingSendOutcome>;
+export declare const TURN_TIMING_REPORTING: {
+    /** Send once this many turns are queued. */
+    readonly flushAt: 5;
+    /** …or this long after the first one was. */
+    readonly flushAfterMs: 15000;
+    /** The queue's bound; the oldest turn is dropped past it. */
+    readonly maxQueued: 50;
+    /** The service's per-request limit. */
+    readonly maxTurnsPerRequest: 20;
+    /** How long a finished voice turn waits for its first audio. */
+    readonly voiceAudioWaitMs: 30000;
+    /** How long sending pauses after the service says `rateLimited`. */
+    readonly rateLimitPauseMs: 60000;
+    /** Turn ids remembered as already handled (the recorder keeps 50 turns). */
+    readonly rememberedTurns: 200;
+    /** Unfinished turns held for an `abandoned` report; the oldest is dropped past it. */
+    readonly maxRunningTurns: 20;
+};
+/** A fresh random UUID, or null when the page has no source of randomness. */
+export declare function createTurnTimingNonce(): string | null;
+/** Runs `callback` after `ms`; returns a cancel. */
+export type TurnTimingSchedule = (callback: () => void, ms: number) => () => void;
+export interface TurnTimingReporterOptions {
+    send: TurnTimingSender;
+    /** Timers — injectable for tests. */
+    schedule?: TurnTimingSchedule;
+    /** Wall clock in ms, for the rate-limit pause. */
+    now?: () => number;
+    nonce?: () => string | null;
+    /** The service answered: the mutation exists and collection is on. */
+    onSupported?: () => void;
+    /** Reporting stopped for the page (unknown mutation, or switched off). */
+    onUnsupported?: () => void;
+    /** The page is hidden: a queued turn is sent at once, with `keepalive`. */
+    isPageHidden?: () => boolean;
+    /**
+     * The turn clock (`turnClockMs`), for an abandoned turn's time to leaving —
+     * the clock its marks were taken on.
+     */
+    turnClock?: () => number;
+}
+export interface TurnTimingFlushOptions {
+    /**
+     * The page may be going away: send EVERYTHING now, not one request at a
+     * time, and (unless `keepAwaitingAudio`) release the voice turns still
+     * waiting for audio first.
+     */
+    final?: boolean;
+    /** Send with fetch `keepalive` (only meaningful with `final`). */
+    keepalive?: boolean;
+    /**
+     * With `final`: leave the voice turns waiting for their audio where they
+     * are — the page is hidden, not gone (see the header).
+     */
+    keepAwaitingAudio?: boolean;
+    /**
+     * With `final`: the page is being LEFT (`pagehide`, `freeze`) — report every
+     * turn still running as `abandoned`, at the time it was left.
+     */
+    abandonRunning?: boolean;
+}
+export interface TurnTimingReporter {
+    /** Every timeline change goes here. Never throws. */
+    observe(timeline: TurnTimeline): void;
+    /** Send what is queued. Never throws. */
+    flush(options?: TurnTimingFlushOptions): void;
+    /** A final flush, then nothing more is observed or sent. */
+    dispose(): void;
+    /** For tests and a console. */
+    stats(): {
+        queued: number;
+        awaitingAudio: number;
+        running: number;
+        stopped: boolean;
+    };
+}
+/**
+ * One reporter. The page-wide one is made by
+ * {@link startTurnTimingReporting}; tests build their own.
+ */
+export declare function createTurnTimingReporter(options: TurnTimingReporterOptions): TurnTimingReporter;
+/** Where a batch is sent from — read at SEND time, not when the turn ran. */
+export interface TurnTimingSendContext {
+    workspaceId: string;
+    authContext?: AssistantSandboxAuthContext;
+}
+export type TurnTimingFetcher = (options: GraphQLFetchOptions) => Promise<GraphQLResponse<unknown>>;
+/**
+ * Send one batch, ONCE (see the header) — `graphqlFetch` directly, not the
+ * retrying `executeSandboxGraphQL`. Never throws.
+ */
+export declare function sendAssistantTurnTimings(batch: TurnTimingBatch, context: TurnTimingSendContext, fetcher?: TurnTimingFetcher): Promise<TurnTimingSendOutcome>;
+export interface TurnTimingReportingOptions {
+    /** How this panel sends a batch — reading workspace and credentials when it does. */
+    send: TurnTimingSender;
+}
+/**
+ * Report this page's finished turns. The first call starts the page-wide
+ * reporter, which runs for the page load (see the header); each panel lends it
+ * a sender for as long as it is mounted.
+ *
+ * Does nothing once the `turnTimings` capability is `unsupported` for the page.
+ *
+ * @returns Withdraw this panel's sender.
+ */
+export declare function startTurnTimingReporting(options: TurnTimingReportingOptions): () => void;
+/** Tests only: stop the page-wide reporter and forget every sender. */
+export declare function resetTurnTimingReporting(): void;
+//# sourceMappingURL=turnTimingReporter.d.ts.map

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

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