@burdenoff/fe-libs 2026.928.3 → 2026.930.1

package/dist/shared/assistant/writeProposalDiscovery.js

@@ -0,0 +1,246 @@
+import { WriteProposalError as e, isWriteProposalError as t } from "./writeProposals.js";
+//#region src/shared/assistant/writeProposalDiscovery.ts
+var n = /^wp_[0-9a-f]{32}$/;
+function r(e) {
+	let t = e?.writeProposalRefs;
+	if (!Array.isArray(t)) return [];
+	let r = [], i = /* @__PURE__ */ new Set();
+	for (let e of t) {
+		if (typeof e != "object" || !e) continue;
+		let { proposalId: t, sandboxId: a, sessionId: o } = e;
+		typeof t != "string" || !n.test(t) || i.has(t) || typeof a != "string" || !a || typeof o != "string" || !o || (i.add(t), r.push({
+			proposalId: t,
+			sandboxId: a,
+			sessionId: o
+		}));
+	}
+	return r;
+}
+function i(e, t) {
+	return (e.sessionId === null || e.sessionId === t.sessionId) && (e.conversationId === null || e.conversationId === t.conversationId);
+}
+function a(e) {
+	let t = /* @__PURE__ */ new Map();
+	for (let n of e.messages) for (let i of r(n.metadata)) t.set(f(i), {
+		session: {
+			sandboxId: i.sandboxId,
+			sessionId: i.sessionId,
+			conversationId: e.id
+		},
+		issuing: !0
+	});
+	let n = e.backendSessionId;
+	if (n) for (let r = e.messages.length - 1; r >= 0; --r) {
+		let i = e.messages[r]?.metadata;
+		if (i?.sessionId !== n || typeof i.sandboxId != "string" || !i.sandboxId) continue;
+		let a = f({
+			sandboxId: i.sandboxId,
+			sessionId: n
+		}), o = t.get(a);
+		t.set(a, {
+			session: {
+				sandboxId: i.sandboxId,
+				sessionId: n,
+				conversationId: e.id
+			},
+			issuing: (o?.issuing ?? !1) || i.mode === "api-calls"
+		});
+		break;
+	}
+	return [...t.values()];
+}
+var o = 2e3, s = 5;
+function c(e) {
+	return e?.proposals === !0 && e.writeApprovalMode === "proposal-v1";
+}
+function l() {
+	let e = typeof crypto < "u" && typeof crypto.randomUUID == "function" ? crypto.randomUUID() : `${Math.random().toString(36).slice(2)}${Math.random().toString(36).slice(2)}`;
+	return `wpr-${Date.now().toString(36)}-${e}`;
+}
+function u(n) {
+	return t(n) ? n : new e({
+		status: 0,
+		code: "UNKNOWN",
+		message: n instanceof Error ? n.message : String(n)
+	});
+}
+var d = {
+	set: (e, t) => setTimeout(e, t),
+	clear: (e) => clearTimeout(e)
+}, f = (e) => `${e.sandboxId}\u0000${e.sessionId}`;
+function p(e, t) {
+	return e ? {
+		reason: e.reason === "turn" ? "turn" : t.reason,
+		turnMessageId: t.turnMessageId ?? e.turnMessageId
+	} : t;
+}
+function m(e) {
+	let t = e.timers ?? d, n = e.pollMs ?? 2e3, r = e.maxPollFailures ?? 5, a = e.requestId ?? l, o = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Set(), m = !1, h = (t) => !m && c(e.capabilitiesOf(t.sandboxId)), g = (e) => h(e) && !s.has(e.sandboxId);
+	function _(e) {
+		let t = f(e), n = o.get(t);
+		return n ? n.session = e : (n = {
+			session: e,
+			since: null,
+			running: null,
+			queuedRun: null,
+			queued: null,
+			timer: null,
+			hasTimer: !1,
+			failures: 0,
+			failureReported: !1,
+			executing: /* @__PURE__ */ new Set()
+		}, o.set(t, n)), n;
+	}
+	function v(e) {
+		e.hasTimer &&= (t.clear(e.timer), e.timer = null, !1);
+	}
+	function y(e, t) {
+		t.status === "executing" ? e.executing.add(t.proposalId) : e.executing.delete(t.proposalId);
+	}
+	function b(e) {
+		m || e.hasTimer || e.running || e.queuedRun || e.executing.size === 0 || e.failures >= r || (e.hasTimer = !0, e.timer = t.set(() => {
+			e.timer = null, e.hasTimer = !1, C(e.session, "poll");
+		}, n));
+	}
+	function x(t, n) {
+		m || (y(t, n), e.onView(t.session, n), b(t));
+	}
+	async function S(t, n) {
+		if (v(t), !h(t.session)) return;
+		let a = e.actorOf?.() ?? null, o = (async () => {
+			let o;
+			try {
+				o = await e.client.list(t.session, {
+					status: "all",
+					...t.since === null ? {} : { since: t.since }
+				});
+			} catch (i) {
+				if (m) return;
+				t.failures += 1, (n.reason === "turn" || n.reason === "poll" && t.failures >= r) && !t.failureReported && (t.failureReported = !0, e.onError(t.session, u(i), "list"));
+				return;
+			}
+			if (m || a !== null && (e.actorOf?.() ?? null) !== a) return;
+			t.since = o.serverNow, t.failures = 0, t.failureReported = !1;
+			let s = o.proposals.filter((e) => i(e, t.session));
+			for (let e of s) y(t, e);
+			e.onList(t.session, s.length === o.proposals.length ? o : {
+				...o,
+				proposals: s
+			}, n);
+		})();
+		t.running = o;
+		try {
+			await o;
+		} finally {
+			t.running === o && (t.running = null), b(t);
+		}
+	}
+	function C(e, t, n = {}) {
+		if (!h(e)) return Promise.resolve();
+		let r = _(e), i = {
+			reason: t,
+			turnMessageId: n.turnMessageId ?? null
+		};
+		if (r.queuedRun) return r.queued = p(r.queued, i), r.queuedRun;
+		if (r.running) {
+			r.queued = i;
+			let e = r.running.then(() => {
+				let e = r.queued ?? i;
+				return r.queued = null, r.queuedRun = null, S(r, e);
+			});
+			return r.queuedRun = e, e;
+		}
+		return S(r, i);
+	}
+	async function w(t, n, r) {
+		if (!g(t)) return;
+		let i = _(t), o = !0;
+		try {
+			let s = await e.client.approve({
+				...t,
+				proposalId: n.proposalId
+			}, {
+				payloadHash: n.payloadHash,
+				surface: r,
+				clientRequestId: a()
+			});
+			if (m) return;
+			s.kind === "settled" ? (x(i, s.proposal), o = !1) : s.proposal ? x(i, s.proposal) : i.executing.add(n.proposalId);
+		} catch (t) {
+			if (m) return;
+			let n = u(t);
+			n.current && x(i, n.current), e.onError(i.session, n, "approve");
+		}
+		o && await C(i.session, "refresh");
+	}
+	async function T(t, n, r, i, o) {
+		if (!g(t)) return;
+		let s = _(t);
+		try {
+			x(s, await e.client.decline({
+				...t,
+				proposalId: n.proposalId
+			}, {
+				reason: r,
+				method: i,
+				...o ? { surface: o } : {},
+				clientRequestId: a()
+			}));
+		} catch (t) {
+			if (m) return;
+			let n = u(t);
+			n.current && x(s, n.current), e.onError(s.session, n, "decline");
+		}
+	}
+	async function E(t, n, r) {
+		if (!g(t) || n.status !== "pending") return;
+		let i = _(t);
+		try {
+			x(i, await e.client.presented({
+				...t,
+				proposalId: n.proposalId
+			}, {
+				payloadHash: n.payloadHash,
+				surface: r,
+				clientRequestId: a()
+			}));
+		} catch (e) {
+			if (m) return;
+			let t = u(e);
+			t.current && x(i, t.current);
+		}
+	}
+	async function D(t, n, r, i = {}) {
+		if (!h(t)) return !1;
+		let o = _(t);
+		try {
+			await e.client.declineAll(t, {
+				reason: n,
+				method: r,
+				clientRequestId: a()
+			});
+		} catch (t) {
+			return m || i.report && e.onError(o.session, u(t), "decline"), !1;
+		}
+		return m || i.refresh !== !1 && await C(o.session, "refresh"), !0;
+	}
+	return {
+		discover: C,
+		approve: w,
+		decline: T,
+		presented: E,
+		declineAll: D,
+		retire: (e) => {
+			s.add(e);
+		},
+		isRetired: (e) => s.has(e),
+		isPolling: (e) => !!o.get(f(e))?.hasTimer,
+		dispose: () => {
+			m = !0;
+			for (let e of o.values()) v(e);
+			o.clear();
+		}
+	};
+}
+//#endregion
+export { s as WRITE_PROPOSAL_MAX_POLL_FAILURES, o as WRITE_PROPOSAL_POLL_MS, u as asWriteProposalError, m as createWriteProposalDiscovery, l as newWriteProposalRequestId, r as readWriteProposalRefs, i as writeProposalBelongsTo, a as writeProposalSessionsToReopen, c as writeProposalsEnabledFor };

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

@@ -0,0 +1,135 @@
+import { WriteProposalError } from './writeProposals';
+/**
+ * What the panel says in the thread when a write-proposal call is refused or
+ * fails (BOFF-7803 5a, unit FE7). Rendered as a system message through
+ * `tr(line.key, line.fallback)`, and read into the i18n manifest from this
+ * table.
+ *
+ * ★★ 5a is a safety floor, not the final security boundary: these lines report
+ * what the issuing sandbox or wspace-sandbox-svc decided. None of them invites
+ * a person to get round a refusal, and none claims a change ran or did not run
+ * beyond what the answer says. An approve whose answer never arrived is
+ * `indeterminate`: it MAY have run, and the card's record decides.
+ *
+ * ★ `EXECUTION_NOT_ENABLED` has two readings, told apart by the answer's
+ * `reason`: `admin_required` (the live admin re-check refused) and `fenced`
+ * (the session may prepare but not run changes before 5b). An unknown reason
+ * reads as `fenced`, the one that promises nothing.
+ *
+ * Kept free of runtime imports: the manifest imports this table.
+ */
+export interface WriteProposalErrorLine {
+    readonly key: string;
+    readonly fallback: string;
+}
+export declare const WRITE_PROPOSAL_ERROR_COPY: Readonly<{
+    notFound: Readonly<{
+        key: "writeProposal.error.notFound";
+        fallback: "That change can't be found any more, so nothing was done. Ask the assistant to prepare it again.";
+    }>;
+    sessionMismatch: Readonly<{
+        key: "writeProposal.error.sessionMismatch";
+        fallback: "That change belongs to a different assistant session, so nothing was done.";
+    }>;
+    conversationMismatch: Readonly<{
+        key: "writeProposal.error.conversationMismatch";
+        fallback: "That change was prepared in a different conversation, so nothing was done.";
+    }>;
+    actorMismatch: Readonly<{
+        key: "writeProposal.error.actorMismatch";
+        fallback: "That change was prepared for someone else, so you can't confirm or cancel it.";
+    }>;
+    hashMismatch: Readonly<{
+        key: "writeProposal.error.hashMismatch";
+        fallback: "That change no longer matches what you were shown, so nothing was done. Ask the assistant to prepare it again.";
+    }>;
+    methodNotAllowed: Readonly<{
+        key: "writeProposal.error.methodNotAllowed";
+        fallback: "That change can only be confirmed with its button. Nothing was done.";
+    }>;
+    superseded: Readonly<{
+        key: "writeProposal.error.superseded";
+        fallback: "That change was replaced by a newer one, so nothing was done.";
+    }>;
+    declined: Readonly<{
+        key: "writeProposal.error.declined";
+        fallback: "That change was cancelled, so nothing was done.";
+    }>;
+    notPending: Readonly<{
+        key: "writeProposal.error.notPending";
+        fallback: "That change is no longer waiting for a decision.";
+    }>;
+    expired: Readonly<{
+        key: "writeProposal.error.expired";
+        fallback: "That change expired, so nothing was done. Ask the assistant to prepare it again.";
+    }>;
+    evicted: Readonly<{
+        key: "writeProposal.error.evicted";
+        fallback: "Too many changes were waiting, so this one was dropped. Nothing was done.";
+    }>;
+    executionFenced: Readonly<{
+        key: "writeProposal.error.executionFenced";
+        fallback: "Running changes from the assistant isn't available in this session yet, so nothing was done. You can still review or cancel the change.";
+    }>;
+    executionAdminRequired: Readonly<{
+        key: "writeProposal.error.executionAdminRequired";
+        fallback: "Only workspace admins can run changes from the assistant right now, so nothing was done.";
+    }>;
+    readOnly: Readonly<{
+        key: "writeProposal.error.readOnly";
+        fallback: "This assistant session can't make changes, so nothing was done.";
+    }>;
+    turnInProgress: Readonly<{
+        key: "writeProposal.error.turnInProgress";
+        fallback: "The assistant is still replying, so nothing was done. Confirm the change once it finishes.";
+    }>;
+    contextChanged: Readonly<{
+        key: "writeProposal.error.contextChanged";
+        fallback: "The workspace changed since this was prepared, so nothing was done. Ask the assistant to prepare it again.";
+    }>;
+    storeUnavailable: Readonly<{
+        key: "writeProposal.error.storeUnavailable";
+        fallback: "Prepared changes are unavailable right now. Nothing was confirmed. Try again shortly.";
+    }>;
+    approvalModeMismatch: Readonly<{
+        key: "writeProposal.error.approvalModeMismatch";
+        fallback: "This assistant session confirms changes a different way, so nothing was done. Start a new conversation and try again.";
+    }>;
+    panelUpgradeRequired: Readonly<{
+        key: "writeProposal.error.panelUpgradeRequired";
+        fallback: "Reload the page to confirm changes from the assistant. Nothing was done.";
+    }>;
+    notProposalOwner: Readonly<{
+        key: "writeProposal.error.notProposalOwner";
+        fallback: "Only the person who asked for this change can confirm or cancel it.";
+    }>;
+    invalidRequest: Readonly<{
+        key: "writeProposal.error.invalidRequest";
+        fallback: "That request couldn't be sent, so nothing was confirmed.";
+    }>;
+    malformedResponse: Readonly<{
+        key: "writeProposal.error.malformedResponse";
+        fallback: "The assistant's answer couldn't be read, so nothing was confirmed.";
+    }>;
+    unknown: Readonly<{
+        key: "writeProposal.error.unknown";
+        fallback: "That didn't go through, and nothing was confirmed. Try again.";
+    }>;
+    /** Approve only: no readable answer. It MAY have run. */
+    indeterminate: Readonly<{
+        key: "writeProposal.error.indeterminate";
+        fallback: "No answer came back, so this change may or may not have run. Check its card before trying again.";
+    }>;
+    /** A read of the prepared changes failed (not a decision). */
+    listFailed: Readonly<{
+        key: "writeProposal.error.listFailed";
+        fallback: "The change the assistant prepared couldn't be loaded. Nothing has been confirmed.";
+    }>;
+}>;
+/**
+ * The line for a failed call. `action` is what was being done: an approve
+ * with no readable answer is `indeterminate`, whatever its code; a failed
+ * list says the prepared change could not be loaded.
+ */
+export declare function writeProposalErrorLine(error: Pick<WriteProposalError, "code" | "reason" | "indeterminate">, action: "approve" | "decline" | "list"): WriteProposalErrorLine;
+//# sourceMappingURL=writeProposalErrorCopy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writeProposalErrorCopy.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/writeProposalErrorCopy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8GpC,yDAAyD;;;;;IAMzD,8DAA8D;;;;;EAMH,CAAC;AAwC9D;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,QAAQ,GAAG,eAAe,CAAC,EACpE,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GACrC,sBAAsB,CAaxB"}

package/dist/shared/assistant/writeProposalErrorCopy.js

@@ -0,0 +1,135 @@
+//#region src/shared/assistant/writeProposalErrorCopy.ts
+var e = Object.freeze({
+	notFound: Object.freeze({
+		key: "writeProposal.error.notFound",
+		fallback: "That change can't be found any more, so nothing was done. Ask the assistant to prepare it again."
+	}),
+	sessionMismatch: Object.freeze({
+		key: "writeProposal.error.sessionMismatch",
+		fallback: "That change belongs to a different assistant session, so nothing was done."
+	}),
+	conversationMismatch: Object.freeze({
+		key: "writeProposal.error.conversationMismatch",
+		fallback: "That change was prepared in a different conversation, so nothing was done."
+	}),
+	actorMismatch: Object.freeze({
+		key: "writeProposal.error.actorMismatch",
+		fallback: "That change was prepared for someone else, so you can't confirm or cancel it."
+	}),
+	hashMismatch: Object.freeze({
+		key: "writeProposal.error.hashMismatch",
+		fallback: "That change no longer matches what you were shown, so nothing was done. Ask the assistant to prepare it again."
+	}),
+	methodNotAllowed: Object.freeze({
+		key: "writeProposal.error.methodNotAllowed",
+		fallback: "That change can only be confirmed with its button. Nothing was done."
+	}),
+	superseded: Object.freeze({
+		key: "writeProposal.error.superseded",
+		fallback: "That change was replaced by a newer one, so nothing was done."
+	}),
+	declined: Object.freeze({
+		key: "writeProposal.error.declined",
+		fallback: "That change was cancelled, so nothing was done."
+	}),
+	notPending: Object.freeze({
+		key: "writeProposal.error.notPending",
+		fallback: "That change is no longer waiting for a decision."
+	}),
+	expired: Object.freeze({
+		key: "writeProposal.error.expired",
+		fallback: "That change expired, so nothing was done. Ask the assistant to prepare it again."
+	}),
+	evicted: Object.freeze({
+		key: "writeProposal.error.evicted",
+		fallback: "Too many changes were waiting, so this one was dropped. Nothing was done."
+	}),
+	executionFenced: Object.freeze({
+		key: "writeProposal.error.executionFenced",
+		fallback: "Running changes from the assistant isn't available in this session yet, so nothing was done. You can still review or cancel the change."
+	}),
+	executionAdminRequired: Object.freeze({
+		key: "writeProposal.error.executionAdminRequired",
+		fallback: "Only workspace admins can run changes from the assistant right now, so nothing was done."
+	}),
+	readOnly: Object.freeze({
+		key: "writeProposal.error.readOnly",
+		fallback: "This assistant session can't make changes, so nothing was done."
+	}),
+	turnInProgress: Object.freeze({
+		key: "writeProposal.error.turnInProgress",
+		fallback: "The assistant is still replying, so nothing was done. Confirm the change once it finishes."
+	}),
+	contextChanged: Object.freeze({
+		key: "writeProposal.error.contextChanged",
+		fallback: "The workspace changed since this was prepared, so nothing was done. Ask the assistant to prepare it again."
+	}),
+	storeUnavailable: Object.freeze({
+		key: "writeProposal.error.storeUnavailable",
+		fallback: "Prepared changes are unavailable right now. Nothing was confirmed. Try again shortly."
+	}),
+	approvalModeMismatch: Object.freeze({
+		key: "writeProposal.error.approvalModeMismatch",
+		fallback: "This assistant session confirms changes a different way, so nothing was done. Start a new conversation and try again."
+	}),
+	panelUpgradeRequired: Object.freeze({
+		key: "writeProposal.error.panelUpgradeRequired",
+		fallback: "Reload the page to confirm changes from the assistant. Nothing was done."
+	}),
+	notProposalOwner: Object.freeze({
+		key: "writeProposal.error.notProposalOwner",
+		fallback: "Only the person who asked for this change can confirm or cancel it."
+	}),
+	invalidRequest: Object.freeze({
+		key: "writeProposal.error.invalidRequest",
+		fallback: "That request couldn't be sent, so nothing was confirmed."
+	}),
+	malformedResponse: Object.freeze({
+		key: "writeProposal.error.malformedResponse",
+		fallback: "The assistant's answer couldn't be read, so nothing was confirmed."
+	}),
+	unknown: Object.freeze({
+		key: "writeProposal.error.unknown",
+		fallback: "That didn't go through, and nothing was confirmed. Try again."
+	}),
+	indeterminate: Object.freeze({
+		key: "writeProposal.error.indeterminate",
+		fallback: "No answer came back, so this change may or may not have run. Check its card before trying again."
+	}),
+	listFailed: Object.freeze({
+		key: "writeProposal.error.listFailed",
+		fallback: "The change the assistant prepared couldn't be loaded. Nothing has been confirmed."
+	})
+}), t = {
+	NOT_FOUND: e.notFound,
+	SESSION_MISMATCH: e.sessionMismatch,
+	CONVERSATION_MISMATCH: e.conversationMismatch,
+	ACTOR_MISMATCH: e.actorMismatch,
+	HASH_MISMATCH: e.hashMismatch,
+	METHOD_NOT_ALLOWED: e.methodNotAllowed,
+	SUPERSEDED: e.superseded,
+	DECLINED: e.declined,
+	NOT_PENDING: e.notPending,
+	EXPIRED: e.expired,
+	EVICTED: e.evicted,
+	READ_ONLY: e.readOnly,
+	TURN_IN_PROGRESS: e.turnInProgress,
+	CONTEXT_CHANGED: e.contextChanged,
+	STORE_UNAVAILABLE: e.storeUnavailable,
+	APPROVAL_MODE_MISMATCH: e.approvalModeMismatch,
+	PANEL_UPGRADE_REQUIRED: e.panelUpgradeRequired,
+	NOT_PROPOSAL_OWNER: e.notProposalOwner,
+	INVALID_REQUEST: e.invalidRequest,
+	MALFORMED_RESPONSE: e.malformedResponse,
+	UNKNOWN: e.unknown
+}, n = new Set([
+	"UNKNOWN",
+	"MALFORMED_RESPONSE",
+	"STORE_UNAVAILABLE",
+	"INVALID_REQUEST"
+]);
+function r(r, i) {
+	return i === "approve" && r.indeterminate ? e.indeterminate : r.code === "EXECUTION_NOT_ENABLED" ? r.reason === "admin_required" ? e.executionAdminRequired : e.executionFenced : i === "list" && n.has(r.code) ? e.listFailed : t[r.code];
+}
+//#endregion
+export { e as WRITE_PROPOSAL_ERROR_COPY, r as writeProposalErrorLine };

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

@@ -0,0 +1,133 @@
+import { AssistantTr } from './i18n';
+import { AssistantMode } from './types';
+import { SandboxWriteCapabilities, WriteApprovalMode, WriteProposalReadbackParts, WriteProposalView } from './writeProposals';
+/**
+ * The mode whose sandbox holds changes as proposals — the value of
+ * `WRITE_PROPOSAL_SANDBOX_MODE`, written out so this module loads nothing at
+ * run time (`writeProposalVoice.test.ts` pins the two together).
+ */
+export declare const VOICE_PROPOSAL_MODE: AssistantMode;
+export interface VoiceProposalBoundInput {
+    /** The mode the spoken turn goes into. */
+    mode: AssistantMode;
+    /** The product's flag (`AssistantProductCapabilities.writeApproval`). */
+    productWriteApproval: WriteApprovalMode;
+    /**
+     * What the sandbox that would take the turn said about writes in its own
+     * `/health`. Absent: not read in this page, which is never proposal-bound.
+     */
+    capabilities: SandboxWriteCapabilities | null | undefined;
+}
+/**
+ * Does every change a spoken turn in `mode` could make wait for an on-screen
+ * button? Only then may voice be used there (FE9's layers, in contract §4.7
+ * order: the send refusal, the mic gate, force-end, the refusal's copy,
+ * prewarm, and auto-routing last).
+ *
+ * ★ Every condition must hold, and each doubt keeps the ban: only the
+ * proposal sandbox's mode (a build mode writes directly), only the exact flag
+ * value, and only a `/health` that reported proposals AND the proposal flow.
+ */
+export declare function isVoiceProposalBound({ mode, productWriteApproval, capabilities, }: VoiceProposalBoundInput): boolean;
+/** How a sensitive value reads: it is never shown or spoken. */
+export declare const WRITE_PROPOSAL_READBACK_HIDDEN = "(hidden)";
+/**
+ * The readback of a change, rendered from the server's `readbackParts` alone:
+ * `Create task: title "Water beds", due "Friday"`, `Delete 3 listings`.
+ *
+ * ★ The same words the sandbox builds its `description.readback` from — the
+ * verb, the count, the noun, then each field's label and value — so what is
+ * spoken is what the card shows. A sensitive field says `(hidden)`, never its
+ * value; fields past the server's cap are counted, not listed.
+ */
+export declare function renderWriteProposalReadback(parts: WriteProposalReadbackParts): string;
+/** A line the voice says, through `tr()`. */
+export interface WriteProposalVoiceLine {
+    readonly key: string;
+    readonly fallback: string;
+}
+/**
+ * Everything FE9 adds to what the panel says. Rendered through
+ * `tr(line.key, line.fallback, values)`, and read into the i18n manifest from
+ * this table.
+ *
+ * ★ The two closing lines never end on an affirmative word, so the last thing
+ * the readback says cannot be heard back as a "yes".
+ */
+export declare const WRITE_PROPOSAL_VOICE_COPY: Readonly<{
+    useButtonVoice: Readonly<{
+        key: "writeProposal.useButtonVoice";
+        fallback: "To make this change, press “{{label}}” on screen. You can ask me to change it, or say cancel to drop it.";
+    }>;
+    fencedVoice: Readonly<{
+        key: "writeProposal.fencedVoice";
+        fallback: "This change can't be run from this session yet; that becomes available once secure confirmation is enabled. You can ask me to change it, or say cancel to drop it.";
+    }>;
+    chipOne: Readonly<{
+        key: "writeProposal.voiceChip";
+        fallback: "Change waiting: {{label}}";
+    }>;
+    chipMany: Readonly<{
+        key: "writeProposal.voiceChipMany";
+        fallback: "{{count}} changes waiting";
+    }>;
+    trayClose: Readonly<{
+        key: "writeProposal.voiceTrayClose";
+        fallback: "Hide the change";
+    }>;
+}>;
+/**
+ * A line of this table, translated. The one place FE9's copy reaches `tr`, so
+ * the i18n manifest's inventory has one call to account for.
+ */
+export declare function writeProposalVoiceLine(tr: AssistantTr, line: WriteProposalVoiceLine, values?: Record<string, string | number>): string;
+export interface WriteProposalVoiceReadback {
+    /** What is said: the record's readback, then the closing line. */
+    text: string;
+    /**
+     * Whether the closing line came back translated. The readback's own words
+     * are the server's, in English; the caller picks the voice from this.
+     */
+    translated: boolean;
+}
+/**
+ * What the voice says about a change waiting for its button: the readback
+ * from `readbackParts`, then "press … on screen" — or, where the card offers
+ * no confirm button (a fenced session), the fenced line, so the voice never
+ * points to a button that is not there.
+ *
+ * `offersConfirm` is the card's own rule for the same view and sandbox
+ * (`writeProposalConfirmState(view, capabilities).offerConfirm`).
+ */
+export declare function writeProposalVoiceReadback(view: WriteProposalView, offersConfirm: boolean, tr: AssistantTr): WriteProposalVoiceReadback;
+/** One proposal the panel holds, as far as the voice view needs it. */
+export interface VoiceProposalEntry {
+    view: WriteProposalView;
+    session: {
+        sandboxId: string;
+        conversationId: string;
+    };
+}
+/**
+ * The changes of `conversationId` still waiting for a person, oldest first. A
+ * change of a sandbox a failover replaced (`retired`) is an inert record and
+ * waits for nothing.
+ */
+export declare function voiceWaitingProposals<T extends VoiceProposalEntry>(entries: readonly T[], conversationId: string | null | undefined, retired?: ReadonlySet<string>): T[];
+/** The voice view's chip: the newest waiting change, and how many wait. */
+export declare function voiceProposalChip<T extends VoiceProposalEntry>(waiting: readonly T[]): {
+    entry: T;
+    count: number;
+} | null;
+/** The chip's words: the change's confirm label, or how many changes wait. */
+export declare function voiceProposalChipText(chip: {
+    entry: VoiceProposalEntry;
+    count: number;
+}, tr: AssistantTr): string;
+/**
+ * The waiting changes to read out now: bound to their conversation
+ * (`approvable` — a card that is not ready says so, and so would the voice)
+ * and not read out before (`seen`). Oldest first.
+ */
+export declare function voiceReadbacksDue<T extends VoiceProposalEntry>(waiting: readonly T[], seen: ReadonlySet<string>): T[];
+//# sourceMappingURL=writeProposalVoice.d.ts.map

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

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