dsh-codex-subscription 3.0.0 → 3.0.1

package/lib/index.js

@@ -2,6 +2,8 @@ import { createRequire } from "node:module";
 import { createHash, randomBytes, randomUUID } from "node:crypto";
 import { closeOpenAICodexWebSocketSessions, getOpenAICodexWebSocketDebugStats, resetOpenAICodexWebSocketDebugStats } from "@earendil-works/pi-ai/api/openai-codex-responses";
 import { execFile, spawn } from "node:child_process";
+import { appendFileSync, constants, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from "node:fs";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { request } from "node:https";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { PassThrough, Readable } from "node:stream";
@@ -10,8 +12,6 @@ import { HttpsProxyAgent } from "https-proxy-agent";
 import WebSocket from "ws";
 import { clientRequestSchema } from "@deepseek-ai/dsh-client-connection";
 import { lstat, mkdir, open, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
-import { constants, readFileSync, readdirSync, statSync } from "node:fs";
-import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import * as dshLlm from "@deepseek-ai/dsh-llm";
@@ -340,6 +340,51 @@ const OUTPUT_VERBOSITY_DEFAULT = "default";
 const OUTPUT_VERBOSITY_MEDIUM = "medium";
 const OUTPUT_VERBOSITY_HIGH = "high";
 const DEFAULT_OUTPUT_VERBOSITY = OUTPUT_VERBOSITY_DEFAULT;
+const VOICE_CALL_FIELD = "voiceCall";
+const VOICE_VOICE_FIELD = "voiceVoice";
+const VOICE_VOICES = Object.freeze([
+	"cove",
+	"juniper",
+	"maple",
+	"spruce",
+	"ember",
+	"vale",
+	"breeze",
+	"arbor",
+	"sol",
+	"aube",
+	"bubbie",
+	"haetsal",
+	"hanul",
+	"himari",
+	"leher",
+	"miko",
+	"neer",
+	"porto",
+	"rindo",
+	"rio",
+	"rivage",
+	"selva",
+	"sonna",
+	"tinta",
+	"viola"
+]);
+const VOICE_LANGUAGE_FIELD = "voiceLanguage";
+const VOICE_LANGUAGES = Object.freeze([
+	"auto",
+	"zh",
+	"en",
+	"ja",
+	"ko",
+	"es",
+	"fr",
+	"de",
+	"pt",
+	"ru"
+]);
+const normalizeVoiceCall = (value) => value === "off" ? "off" : "on";
+const normalizeVoiceVoice = (value) => VOICE_VOICES.includes(value) ? value : "cove";
+const normalizeVoiceLanguage = (value) => VOICE_LANGUAGES.includes(value) ? value : "auto";
 const REASONING_SUMMARY_FIELD = "reasoningSummary";
 const REASONING_SUMMARIES = Object.freeze([
 	"auto",
@@ -572,6 +617,21 @@ const PREFERENCE_FIELDS = Object.freeze({
 		default: 10,
 		error: "Invalid stream idle timeout preference"
 	},
+	[VOICE_CALL_FIELD]: {
+		choices: ["off", "on"],
+		default: "on",
+		error: "Invalid voice call setting"
+	},
+	[VOICE_VOICE_FIELD]: {
+		choices: VOICE_VOICES,
+		default: "cove",
+		error: "Invalid voice preference"
+	},
+	[VOICE_LANGUAGE_FIELD]: {
+		choices: VOICE_LANGUAGES,
+		default: "auto",
+		error: "Invalid voice language preference"
+	},
 	[CONTEXT_MODE_FIELD]: {
 		choices: [
 			CONTEXT_MODE_STANDARD,
@@ -631,6 +691,108 @@ function createDiagnosticEvents({ limit = 32, now = Date.now } = {}) {
 	};
 }
 //#endregion
+//#region src/diagnostic-log-format.js
+const MAX_MESSAGE = 300;
+function sanitizeLogText(value) {
+	let text = typeof value === "string" ? value : String(value?.message ?? value ?? "");
+	text = text.replace(/Bearer\s+[\w.~+/=-]+/giu, "Bearer ***").replace(/\beyJ[\w-]{8,}\.[\w-]{8,}(?:\.[\w-]*)?/gu, "***").replace(/\b(token|access_token|refresh_token|id_token|code|key|secret|password|authorization)=[^\s&"']+/giu, "$1=***").replace(/(["']?(?:access|refresh|id)_?token["']?\s*[:=]\s*)["'][^"']+["']/giu, "$1\"***\"").replace(/[\w.+-]+@[\w-]+(?:\.[\w-]+)+/gu, "***@***").replace(/https?:\/\/[^\s"'<>)]+/giu, (url) => url.split(/[?#]/u)[0]).replace(/[A-Za-z]:[\\/]Users[\\/][^\\/\s"']+/gu, "~").replace(/\/(?:home|Users)\/[^/\s"']+/gu, "~").replace(/\b[0-9a-f]{32,}\b/giu, "***").replace(/\b[A-Za-z0-9_-]{40,}\b/gu, "***").replace(/\s+/gu, " ").trim();
+	return text.length > MAX_MESSAGE ? `${text.slice(0, MAX_MESSAGE)}…` : text;
+}
+//#endregion
+//#region src/diagnostic-log.js
+const LEVELS$1 = [
+	"info",
+	"warn",
+	"error"
+];
+const MAX_ENTRIES$1 = 400;
+const FILE_LIMIT = 256 * 1024;
+function createDiagnosticLog({ now = Date.now, limit = MAX_ENTRIES$1 } = {}) {
+	let entries = [];
+	let dropped = 0;
+	let sequence = 0;
+	let file;
+	let lastWritten = "";
+	const persist = (entry) => {
+		if (file === void 0) return;
+		try {
+			try {
+				if (statSync(file).size > FILE_LIMIT) renameSync(file, `${file}.1`);
+			} catch {}
+			appendFileSync(file, `${JSON.stringify(entry)}\n`);
+		} catch {}
+	};
+	const log = (level, area, message, detail) => {
+		try {
+			if (!LEVELS$1.includes(level)) return;
+			const text = sanitizeLogText(message);
+			if (text === "" && detail === void 0) return;
+			const entry = {
+				sequence: ++sequence,
+				time: now(),
+				level,
+				area: String(area).slice(0, 24),
+				message: text
+			};
+			if (detail !== void 0) entry.detail = sanitizeLogText(detail);
+			const signature = `${level}|${entry.area}|${text}|${entry.detail ?? ""}`;
+			const previous = entries.at(-1);
+			if (previous !== void 0 && signature === lastWritten) {
+				previous.count = (previous.count ?? 1) + 1;
+				previous.lastTime = entry.time;
+				return;
+			}
+			lastWritten = signature;
+			entries.push(entry);
+			if (entries.length > limit) {
+				entries = entries.slice(-limit);
+				dropped++;
+			}
+			persist(entry);
+		} catch {}
+	};
+	return {
+		log,
+		info: (area, message, detail) => log("info", area, message, detail),
+		warn: (area, message, detail) => log("warn", area, message, detail),
+		error: (area, message, detail) => log("error", area, message, detail),
+		/** Keep a copy on disk, and start from what the last run left behind. */
+		attach(path) {
+			try {
+				mkdirSync(dirname(path), { recursive: true });
+				file = path;
+				entries = [...readFileSync(path, "utf8").trim().split("\n").slice(-Math.floor(limit / 2)).flatMap((line) => {
+					try {
+						const value = JSON.parse(line);
+						return LEVELS$1.includes(value?.level) && Number.isSafeInteger(value?.time) && typeof value?.message === "string" ? [{
+							...value,
+							sequence: ++sequence,
+							area: String(value.area ?? "").slice(0, 24),
+							message: sanitizeLogText(value.message),
+							earlier: true
+						}] : [];
+					} catch {
+						return [];
+					}
+				}), ...entries];
+			} catch {
+				file = file ?? path;
+			}
+		},
+		snapshot: (max = 200) => ({
+			dropped,
+			entries: entries.slice(-max).map((value) => ({ ...value }))
+		}),
+		clear() {
+			entries = [];
+			dropped = 0;
+			lastWritten = "";
+		}
+	};
+}
+/** The log every part of the plugin writes to. */
+const diagnosticLog = createDiagnosticLog();
+//#endregion
 //#region src/oauth-network.js
 const execFileAsync = promisify(execFile);
 const CODEX_AUTH_HOST = "auth.openai.com";
@@ -876,8 +1038,13 @@ function createCodexNetworkTransport(options = {}) {
 	const now = options.now ?? Date.now;
 	const evidence = createDiagnosticEvents({ now });
 	const remember = (area, value) => {
+		const before = attempts.get(area);
 		attempts.set(area, value);
 		evidence.record(area, value);
+		if (value.status === "failed") {
+			const what = value.stage === "http" ? `HTTP ${value.httpStatus}` : `network ${value.code}`;
+			diagnosticLog.log(value.stage === "http" && value.httpStatus < 500 && value.httpStatus !== 401 && value.httpStatus !== 403 ? "warn" : "error", area, `request failed: ${what} (${value.route}, ${value.elapsed})`);
+		} else if (before?.status === "failed") diagnosticLog.info(area, "request works again");
 	};
 	const run = async (area, operation, connection = {}) => {
 		const startedAt = now();
@@ -1215,6 +1382,11 @@ const RPC_ENDPOINTS = Object.freeze([
 	"runtime/cancel",
 	"storage/status",
 	"storage/clear-forecast",
+	"voice/start",
+	"voice/stop",
+	"voice/status",
+	"voice/preview",
+	"voice/catalog",
 	"remote/status",
 	"remote/enable",
 	"remote/disable",
@@ -2182,10 +2354,14 @@ function inheritedOriginalImageRef(session, assetId) {
 }
 //#endregion
 //#region src/version.js
-const PACKAGE_VERSION = "3.0.0";
+const PACKAGE_VERSION = "3.0.1";
 const USER_AGENT = `dsh-codex-subscription/${PACKAGE_VERSION}`;
 //#endregion
 //#region src/http-failure.js
+let logAuthFailure;
+const setAuthFailureLogger = (fn) => {
+	logAuthFailure = fn;
+};
 const SIGN_IN_RENEW = "ChatGPT sign-in needs to be renewed";
 const REQUEST_BLOCKED = "ChatGPT blocked this request before it reached your account (HTTP 403); your sign-in is fine, try again later or check your network, proxy or VPN";
 const CHALLENGE_MARKERS = /just a moment|cf-chl|_cf_chl_opt|attention required|enable javascript and cookies|challenge-platform/iu;
@@ -2207,9 +2383,16 @@ async function isBlockedByNetwork(response) {
 }
 /** The error message for a 401 or 403 answer, or undefined for any other status. */
 async function authFailureMessage(response) {
-	if (response?.status === 401) return SIGN_IN_RENEW;
-	if (response?.status !== 403) return void 0;
-	return await isBlockedByNetwork(response) ? REQUEST_BLOCKED : SIGN_IN_RENEW;
+	if (response?.status !== 401 && response?.status !== 403) return void 0;
+	const blocked = response.status === 403 && await isBlockedByNetwork(response);
+	await noteAuthFailure(response, blocked);
+	return blocked ? REQUEST_BLOCKED : SIGN_IN_RENEW;
+}
+async function noteAuthFailure(response, blocked) {
+	try {
+		const text = blocked || typeof response.clone !== "function" ? "" : (await response.clone().text()).slice(0, 400);
+		logAuthFailure?.(blocked ? "HTTP 403 from the network layer in front of ChatGPT" : `ChatGPT answered HTTP ${response.status}`, text === "" ? void 0 : text);
+	} catch {}
 }
 //#endregion
 //#region src/codex-images.js
@@ -2237,7 +2420,7 @@ const FULL_ATTACHMENT_ID = /^sha256:[0-9a-f]{64}$/u;
 const BARE_ATTACHMENT_DIGEST = /^[0-9a-f]{64}$/iu;
 const PATH_LIKE_ATTACHMENT_ID = /[\\/]/u;
 const FILE_NAME_ATTACHMENT_ID = /\.[A-Za-z0-9]{1,16}$/u;
-const record$7 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const record$8 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
 const nonEmpty$2 = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
 const NETWORK_REASONS = {
 	UND_ERR_HEADERS_TIMEOUT: "the image service sent no response within 5 minutes",
@@ -2323,7 +2506,7 @@ function decodeCodexPng(value, maximumBytes) {
 	return new Uint8Array(data);
 }
 function imageReference(value) {
-	const originalDimensions = record$7(value.originalDimensions) ? {
+	const originalDimensions = record$8(value.originalDimensions) ? {
 		width: value.originalDimensions.width,
 		height: value.originalDimensions.height
 	} : void 0;
@@ -2351,7 +2534,7 @@ function invalidAttachmentId(value) {
 function referenceOf(value, attachments) {
 	const attachmentId = normalizeAttachmentId(value?.attachmentId);
 	if (attachmentId === void 0) invalidAttachmentId(value);
-	if (!record$7(value) || !attachments.imageLimits.mediaTypes.includes(value.mediaType) || !Number.isSafeInteger(value.bytes) || value.bytes <= 0 || !Number.isSafeInteger(value.width) || value.width <= 0 || !Number.isSafeInteger(value.height) || value.height <= 0 || value.name !== void 0 && (typeof value.name !== "string" || value.name.length > 256) || value.originalDimensions !== void 0 && (!record$7(value.originalDimensions) || !Number.isSafeInteger(value.originalDimensions.width) || value.originalDimensions.width <= 0 || !Number.isSafeInteger(value.originalDimensions.height) || value.originalDimensions.height <= 0)) throw new Error("referenceImages contains an invalid image reference");
+	if (!record$8(value) || !attachments.imageLimits.mediaTypes.includes(value.mediaType) || !Number.isSafeInteger(value.bytes) || value.bytes <= 0 || !Number.isSafeInteger(value.width) || value.width <= 0 || !Number.isSafeInteger(value.height) || value.height <= 0 || value.name !== void 0 && (typeof value.name !== "string" || value.name.length > 256) || value.originalDimensions !== void 0 && (!record$8(value.originalDimensions) || !Number.isSafeInteger(value.originalDimensions.width) || value.originalDimensions.width <= 0 || !Number.isSafeInteger(value.originalDimensions.height) || value.originalDimensions.height <= 0)) throw new Error("referenceImages contains an invalid image reference");
 	return imageReference({
 		...value,
 		attachmentId
@@ -2361,7 +2544,7 @@ function sessionImageReferences(messages) {
 	const references = /* @__PURE__ */ new Map();
 	const visit = (content) => {
 		if (!Array.isArray(content)) return;
-		for (const block of content) if (block?.type === "image" && record$7(block.attachment)) {
+		for (const block of content) if (block?.type === "image" && record$8(block.attachment)) {
 			const id = normalizeAttachmentId(block.attachment.attachmentId);
 			if (id !== void 0) references.set(id, block.attachment);
 		} else if (block?.type === "tool-result") visit(block.content);
@@ -2526,7 +2709,7 @@ async function limitMessage(response, now = Date.now()) {
 	} catch {
 		return fallback;
 	}
-	if (!record$7(error)) return fallback;
+	if (!record$8(error)) return fallback;
 	const at = Number.isSafeInteger(error.resets_at) && error.resets_at > 0 ? error.resets_at * 1e3 : Number.isSafeInteger(error.resets_in_seconds) && error.resets_in_seconds > 0 ? now + error.resets_in_seconds * 1e3 : void 0;
 	if (at === void 0) return fallback;
 	const minutes = Math.max(1, Math.ceil((at - now) / 6e4));
@@ -2548,7 +2731,7 @@ async function readTextWithin(response, maximumBytes) {
 }
 function responseMetadata(value) {
 	const data = Array.isArray(value?.data) ? value.data[0] : void 0;
-	const encoded = record$7(data) ? data.b64_json : void 0;
+	const encoded = record$8(data) ? data.b64_json : void 0;
 	if (typeof encoded !== "string") throw new Error("Codex returned no image data");
 	return {
 		encoded,
@@ -2883,7 +3066,8 @@ const METHOD_NOT_FOUND = -32601;
 const INVALID_PARAMS = -32602;
 const INTERNAL_ERROR = -32603;
 const MAX_SEEN = 128;
-const QUIET = /* @__PURE__ */ new Set([
+const STREAMING = /delta$|outputDelta|tokenUsage|summaryPartAdded/u;
+const QUIET$1 = /* @__PURE__ */ new Set([
 	"command/exec",
 	"thread/attachment/list",
 	"thread/list",
@@ -2903,16 +3087,21 @@ const invalidParams = (message) => new RpcError(INVALID_PARAMS, message);
 * One host per relay; each remote client gets its own connection.
 * @param {{ methods: Record<string, (params: any, context: { client: object, signal: AbortSignal, notify: (method: string, params?: object) => Promise<void> }) => any>, notifications?: Record<string, Function>, onConnection?: (client: object) => void, onClose?: (client: object) => void }} options
 */
-function createRemoteControlHost({ methods, notifications = {}, onConnection, onActive, onClose, debug = false }) {
+function createRemoteControlHost({ methods, notifications = {}, onConnection, onActive, onClose, debug = false, debugFile }) {
 	const seen = /* @__PURE__ */ new Map();
 	const trace = [];
 	const record = (entry) => {
 		if (!debug) return;
-		trace.push({
+		const value = {
 			at: Date.now(),
 			...entry
-		});
+		};
+		trace.push(value);
 		if (trace.length > 60) trace.shift();
+		if (debugFile !== void 0) try {
+			appendFileSync(debugFile, `${JSON.stringify(value)}
+`);
+		} catch {}
 	};
 	const note = (kind, method) => {
 		const key = `${kind}:${method}`;
@@ -2932,6 +3121,14 @@ function createRemoteControlHost({ methods, notifications = {}, onConnection, on
 			let initialized = false;
 			let active = false;
 			const notify = async (method, params) => {
+				if (debug && !STREAMING.test(method)) record({
+					method: `notify:${method}`,
+					params: JSON.stringify({
+						threadId: params?.threadId,
+						status: params?.status?.type,
+						message: params?.message
+					})
+				});
 				await client.send(params === void 0 ? { method } : {
 					method,
 					params
@@ -3029,16 +3226,16 @@ function createRemoteControlHost({ methods, notifications = {}, onConnection, on
 						active = true;
 						onActive?.(client, notify);
 					}
-					if (debug && !QUIET.has(method)) record({
+					if (debug && !QUIET$1.has(method)) record({
 						method: `request:${method}`,
-						params: JSON.stringify(params ?? null).slice(0, 700)
+						params: JSON.stringify(params ?? null).slice(0, /realtime/u.test(method) ? 8e3 : 700)
 					});
 					const handler = methods[method];
 					if (!handler) {
 						record({
 							method,
 							missing: true,
-							params: JSON.stringify(params ?? null).slice(0, 600)
+							params: JSON.stringify(params ?? null).slice(0, /realtime/u.test(method) ? 8e3 : 600)
 						});
 						fail(id, new RpcError(METHOD_NOT_FOUND, `Method not found: ${method}`)).catch(() => {});
 						return;
@@ -3050,7 +3247,7 @@ function createRemoteControlHost({ methods, notifications = {}, onConnection, on
 						...context,
 						signal: controller.signal
 					})).then((result) => reply(id, result ?? {}), (error) => {
-						if (!QUIET.has(method)) record({
+						if (!QUIET$1.has(method)) record({
 							method,
 							error: String(error?.message ?? error).slice(0, 300),
 							params: JSON.stringify(params ?? null).slice(0, 600)
@@ -3081,6 +3278,7 @@ const CONFLICT_RENEW_MS = 15 * 6e4;
 const MAX_RECONNECT_MS = 3e4;
 const REQUEST_TIMEOUT_MS = 3e4;
 const REFRESH_MARGIN_MS = 5 * 6e4;
+const CLIENT_IDLE_MS = 10 * 6e4;
 const PING_MS = 1e4;
 const PONG_TIMEOUT_MS = 6e4;
 const STABLE_MS = 6e4;
@@ -3167,6 +3365,7 @@ function createRemoteControlRelay(options) {
 	let stop;
 	let running;
 	let socket;
+	let subscribeCursor;
 	const clients = /* @__PURE__ */ new Map();
 	const assemblies = /* @__PURE__ */ new Map();
 	const sequences = /* @__PURE__ */ new Map();
@@ -3213,7 +3412,7 @@ function createRemoteControlRelay(options) {
 			installation_id: installation,
 			server_id: enrolled.serverId
 		} : {
-			app_server_version: options.userAgent.split("/").at(-1),
+			app_server_version: options.appServerVersion ?? options.userAgent.split("/").at(-1),
 			arch: process.arch,
 			installation_id: installation,
 			name: options.hostName,
@@ -3380,7 +3579,17 @@ function createRemoteControlRelay(options) {
 	const deliver = async (envelope) => {
 		const streamId = envelope.stream_id ?? randomUUID();
 		const key = `${envelope.client_id}\u0000${streamId}`;
+		const starts = envelope.message?.method === "initialize" && envelope.message?.id !== void 0;
 		let client = clients.get(key);
+		if (client && starts) {
+			clients.delete(key);
+			lastInbound.delete(key);
+			sequences.delete(key);
+			outbound.delete(key);
+			client.close();
+			client = void 0;
+		}
+		if (!client && !starts) return;
 		if (!client) {
 			let closed = false;
 			const connection = options.serve({
@@ -3396,6 +3605,7 @@ function createRemoteControlRelay(options) {
 			});
 			client = {
 				receive: connection.receive,
+				lastActivity: now(),
 				close: () => {
 					closed = true;
 					connection.close();
@@ -3403,16 +3613,11 @@ function createRemoteControlRelay(options) {
 			};
 			clients.set(key, client);
 		}
-		if (!(Number.isInteger(envelope.seq_id) && (lastInbound.get(key) ?? -1) >= envelope.seq_id)) {
+		if (!(!starts && Number.isInteger(envelope.seq_id) && (lastInbound.get(key) ?? -1) >= envelope.seq_id)) {
 			if (Number.isInteger(envelope.seq_id)) lastInbound.set(key, envelope.seq_id);
 			client.receive(envelope.message);
 		}
-		if (Number.isInteger(envelope.seq_id)) await sendEnvelope({
-			client_id: envelope.client_id,
-			seq_id: envelope.seq_id,
-			stream_id: streamId,
-			type: "ack"
-		});
+		client.lastActivity = now();
 	};
 	const receiveChunk = (envelope) => {
 		const streamId = envelope.stream_id ?? randomUUID();
@@ -3444,6 +3649,15 @@ function createRemoteControlRelay(options) {
 			type: "client_message"
 		};
 	};
+	const sweepIdle = () => {
+		for (const [key, client] of clients) if (now() - client.lastActivity >= CLIENT_IDLE_MS) {
+			clients.delete(key);
+			sequences.delete(key);
+			outbound.delete(key);
+			lastInbound.delete(key);
+			client.close();
+		}
+	};
 	const receive = async (raw) => {
 		const envelope = JSON.parse(raw);
 		if (typeof envelope?.client_id !== "string" || envelope.client_id.length === 0) return;
@@ -3454,13 +3668,18 @@ function createRemoteControlRelay(options) {
 		} else if (envelope.type === "ack") {
 			if (typeof envelope.stream_id === "string" && Number.isInteger(envelope.seq_id)) acknowledge(`${envelope.client_id}\u0000${envelope.stream_id}`, envelope.seq_id, Number.isInteger(envelope.segment_id) ? envelope.segment_id : void 0);
 		} else if (envelope.type === "client_closed") closeClient(envelope.client_id, envelope.stream_id);
-		else if (envelope.type === "ping") await sendEnvelope({
-			client_id: envelope.client_id,
-			seq_id: envelope.seq_id ?? 0,
-			status: "active",
-			stream_id: envelope.stream_id ?? randomUUID(),
-			type: "pong"
-		});
+		else if (envelope.type === "ping") {
+			const known = typeof envelope.stream_id === "string" ? clients.get(`${envelope.client_id}\u0000${envelope.stream_id}`) : void 0;
+			if (known) known.lastActivity = now();
+			await sendEnvelope({
+				client_id: envelope.client_id,
+				seq_id: envelope.seq_id ?? 0,
+				status: known ? "active" : "unknown",
+				stream_id: envelope.stream_id ?? randomUUID(),
+				type: "pong"
+			});
+		}
+		if (typeof envelope.cursor === "string" && envelope.cursor !== "") subscribeCursor = envelope.cursor;
 	};
 	const connectOnce = async (signal) => {
 		const current = await ensureEnrollment(signal);
@@ -3471,7 +3690,8 @@ function createRemoteControlRelay(options) {
 				"x-codex-installation-id": installation,
 				"x-codex-name": Buffer.from(options.hostName).toString("base64"),
 				"x-codex-protocol-version": PROTOCOL_VERSION,
-				"x-codex-server-id": current.serverId
+				"x-codex-server-id": current.serverId,
+				...subscribeCursor === void 0 ? {} : { "x-codex-subscribe-cursor": subscribeCursor }
 			} });
 			socket = ws;
 			let queue = Promise.resolve();
@@ -3496,10 +3716,12 @@ function createRemoteControlRelay(options) {
 				state.status = "connected";
 				state.connectedAt = now();
 				state.lastError = void 0;
+				diagnosticLog.info("phone", "connected to the Codex relay");
 				replay(ws);
 				if (typeof ws.ping === "function") {
 					hearFrom();
 					ping = setInterval(() => {
+						sweepIdle();
 						try {
 							ws.ping();
 						} catch {}
@@ -3509,7 +3731,8 @@ function createRemoteControlRelay(options) {
 			ws.on("pong", hearFrom);
 			ws.on("unexpected-response", (request, response) => {
 				stopBeat();
-				const error = new RemoteControlError("socket", `Unexpected server response: ${response?.statusCode}`);
+				const error = new RemoteControlError(response?.statusCode === 401 || response?.statusCode === 403 ? "unauthorized" : "socket", `Unexpected server response: ${response?.statusCode}`);
+				if (response?.statusCode === 404) enrolled = void 0;
 				if (response?.statusCode === 429 || response?.statusCode >= 500) error.retryAfterMs = retryAfterMs$1(String(response.headers?.["retry-after"] ?? ""), now());
 				try {
 					request?.destroy?.();
@@ -3556,6 +3779,7 @@ function createRemoteControlRelay(options) {
 					state.status = "waiting";
 					state.lastError = "conflict";
 				}
+				diagnosticLog.log(conflicts > 0 ? "warn" : "error", "phone", conflicts > 0 ? "relay refused the connection: another host with the same identity is connected (409)" : `connection to the relay failed (${state.lastError})`, conflicts > 0 ? void 0 : error?.message);
 				if (error?.code === "unauthorized" || conflicts >= 3) enrolled = void 0;
 				if (conflicts >= 3 && now() - conflictSince >= (options.conflictRenewMs ?? CONFLICT_RENEW_MS) && options.renewInstallation) {
 					installation = await options.renewInstallation();
@@ -3642,7 +3866,8 @@ function createRemoteControl(options) {
 			phones.delete(client.id);
 			options.onClose?.(client, notify);
 		},
-		debug: process.env.DSH_CODEX_REMOTE_DEBUG === "1"
+		debug: process.env.DSH_CODEX_REMOTE_DEBUG === "1",
+		debugFile: options.debugFile
 	});
 	let relay;
 	let starting;
@@ -3656,6 +3881,7 @@ function createRemoteControl(options) {
 			renewInstallation: () => installationId(options.stateFile, true),
 			hostName: options.hostName,
 			userAgent: options.userAgent,
+			appServerVersion: options.appServerVersion,
 			base: options.base,
 			serve: (client) => host.serve(client)
 		});
@@ -3909,6 +4135,447 @@ async function searchFiles({ roots, query, folders, now = Date.now }) {
 	return found.sort((a, b) => b.score - a.score || a.path.length - b.path.length).slice(0, RESULTS);
 }
 //#endregion
+//#region src/remote-control-realtime.js
+const SIDEBAND_BASES = ["wss://api.openai.com/v1/live", "wss://realtime.chatgpt.com/v1/live"];
+const ACTIVATION_RETRY_MS = [
+	100,
+	300,
+	800
+];
+const CONTEXT_APPEND_MAX_BYTES = 500;
+const CHANNEL_PREFIXES = {
+	final: ["[FINAL]", "[COMPLETE]"],
+	commentary: ["[COMMENTARY]", "[STATUS]"],
+	analysis: ["[ANALYSIS]"]
+};
+const DELEGATION_FIELD_MAX = 4 * 1024;
+const bounded = (text) => text.length > DELEGATION_FIELD_MAX ? `${text.slice(0, DELEGATION_FIELD_MAX - 1)}…` : text;
+/** A spoken request reaches the agent, and so the conversation, as the plain message it is. */
+const delegationText = (input) => bounded(input).trim();
+const dialogue = (transcript) => transcript.map((entry) => `${entry.role === "user" ? "You" : "Voice"}: ${entry.text.replace(/\s+/gu, " ").trim()}`).join("\n");
+/** What the conversation keeps of a finished call: the dialogue, and a plain request to wrap it up. */
+function callRecord(transcript) {
+	return `${dialogue(transcript)}\n\nThe voice call has ended. Summarise it in a sentence or two, and carry on with anything that was left unfinished.`;
+}
+/** The same dialogue as a note for the conversation's context: kept for the next message, with no turn of its own. */
+function callNote(transcript) {
+	return `Part of the voice call that was not handed over as a request:\n${dialogue(transcript)}`;
+}
+/** Which side channel an agent message belongs on: progress is commentary, an answer is spoken. */
+function channelOf(text, prefixes = CHANNEL_PREFIXES) {
+	for (const [name, list] of Object.entries(prefixes)) if (Array.isArray(list) && list.some((prefix) => prefix !== "" && text.startsWith(prefix))) return name === "final" ? "speakable" : name === "analysis" ? void 0 : "commentary";
+	return "speakable";
+}
+/** Cut a long text on character boundaries into pieces the voice service accepts as one append. */
+function appendChunks(text, limit = CONTEXT_APPEND_MAX_BYTES) {
+	const chunks = [];
+	let current = "";
+	let bytes = 0;
+	for (const char of text) {
+		const size = Buffer.byteLength(char);
+		if (bytes + size > limit) {
+			chunks.push(current);
+			current = "";
+			bytes = 0;
+		}
+		current += char;
+		bytes += size;
+	}
+	if (current !== "") chunks.push(current);
+	return chunks;
+}
+/**
+* A short utterance that could be a goodbye or a request to hang up, in the languages the voice speaks. It only decides when the agent
+* is asked; the agent decides whether the person really means to end the call (as in Codex), so a word inside other talk does no harm.
+*/
+const isGoodbye = (text) => {
+	const said = String(text).trim().split(" ").filter(Boolean).join(" ");
+	return said.length > 0 && said.length <= 30 && /(拜拜|再见|再會|(?<![a-z])bye(?![a-z])|goodbye|hang up|end (the )?call|挂断|結束通話|结束通话|结束语音|さようなら|バイバイ|またね|じゃあね|안녕히|잘 가|adiós|au revoir|tschüss|tchau|до свидания)/iu.test(said);
+};
+const content = (text) => [{
+	type: "input_text",
+	text
+}];
+const outbound = {
+	sessionAppend: (text, channel) => ({
+		type: "session.context.append",
+		...channel ? { channel } : {},
+		content: content(text)
+	}),
+	delegationAppend: (delegationItemId, text, channel) => ({
+		type: "delegation.context.append",
+		delegation_item_id: delegationItemId,
+		...channel ? { channel } : {},
+		content: content(text)
+	}),
+	close: () => ({ type: "session.close" })
+};
+/** What the voice service sends, as the phone-facing notifications and the work to do. */
+function parseEvent(payload) {
+	let value;
+	try {
+		value = JSON.parse(payload);
+	} catch {
+		return;
+	}
+	switch (value?.type) {
+		case "session.started":
+		case "session.updated": return { kind: "session" };
+		case "input_transcript.added": return typeof value.item?.text === "string" ? {
+			kind: "delta",
+			role: "user",
+			text: value.item.text
+		} : void 0;
+		case "output_transcript.added": return typeof value.item?.text === "string" ? {
+			kind: "delta",
+			role: "assistant",
+			text: value.item.text
+		} : void 0;
+		case "turn.done": {
+			const role = value.turn?.role;
+			return (role === "user" || role === "assistant") && typeof value.turn?.transcript === "string" ? {
+				kind: "done",
+				role,
+				text: value.turn.transcript
+			} : void 0;
+		}
+		case "delegation.created": {
+			const item = value.item;
+			if (item?.type !== "delegation" || item?.target !== "client" || typeof item.id !== "string") return void 0;
+			const text = (Array.isArray(item.content) ? item.content : []).filter((part) => part?.type === "input_text" && typeof part.text === "string").map((part) => part.text).join("");
+			return {
+				kind: "delegation",
+				id: item.id,
+				text
+			};
+		}
+		case "error": return {
+			kind: "error",
+			message: String(value.error?.message ?? value.message ?? "The voice service reported an error").slice(0, 300)
+		};
+		default: return;
+	}
+}
+/**
+* @param {{ WebSocket: Function, credentials: (signal?: AbortSignal) => Promise<{ access: string, accountId: string }>, userAgent: string, bases?: string[], log?: { info: Function, warn: Function, error: Function }, trace?: Function, delegate: (threadId: string, text: string, onMessage: (text: string) => void) => Promise<void> }} options
+*/
+/**
+* Ask the ChatGPT backend for a voice call: the browser's WebRTC offer goes in with the session settings, the answer
+* comes back as plain SDP and the call id in the Location header. The same request the phone makes for its own call.
+*/
+async function createVoiceCall({ fetch, credentials, userAgent, sdp, session, base = "https://chatgpt.com/backend-api", threadId }) {
+	const { access, accountId } = await credentials();
+	const response = await fetch(`${base}/wham/realtime/calls?intent=quicksilver&architecture=avas`, {
+		method: "POST",
+		headers: {
+			authorization: `Bearer ${access}`,
+			"chatgpt-account-id": accountId,
+			"content-type": "application/json",
+			accept: "application/sdp, application/json",
+			"openai-alpha": "quicksilver=v2",
+			"session-id": crypto.randomUUID(),
+			"thread-id": threadId ?? crypto.randomUUID(),
+			"user-agent": userAgent
+		},
+		body: JSON.stringify({
+			sdp,
+			session
+		}),
+		signal: AbortSignal.timeout(2e4)
+	});
+	const answer = await response.text();
+	if (!response.ok) throw new Error(`the voice backend refused the call (HTTP ${response.status}): ${answer.slice(0, 200)}`);
+	const callId = String(response.headers?.get?.("location") ?? "").replace(/[?#].*$/u, "").split("/").filter(Boolean).at(-1);
+	if (!/^rtc_[A-Za-z0-9_-]{8,80}$/u.test(callId ?? "")) throw new Error("the voice backend returned no call id");
+	if (!answer.startsWith("v=0")) throw new Error("the voice backend returned no session description");
+	return {
+		callId,
+		answer
+	};
+}
+const LANGUAGE_NAMES = {
+	zh: "Chinese (Mandarin)",
+	en: "English",
+	ja: "Japanese",
+	ko: "Korean",
+	es: "Spanish",
+	fr: "French",
+	de: "German",
+	pt: "Portuguese",
+	ru: "Russian"
+};
+/** What the voice model is told when the call starts from the computer. */
+function desktopInstructions(language) {
+	const spoken = LANGUAGE_NAMES[language];
+	return [
+		"You are the voice of DeepSeek Harness (DSH), a coding agent that works on the user's computer.",
+		"Talk like a calm, brief colleague: short sentences, no lists, no markup.",
+		"You cannot read files, run commands, search or change anything yourself. Hand every request that needs the computer, files, code, the web or any tool to the agent by delegating it, and say in a few words what you are handing over.",
+		"Chat that needs nothing from the computer (greetings, small talk, questions you can answer) you answer yourself. You cannot hang up yourself. When the user may want to end the call (goodbye, that is all, hang up), do not say that you are hanging up: hand their own words over to the agent and let it decide.",
+		"When the agent reports back, tell the user the result in your own words. Messages that start with [STATUS] are progress; messages that start with [COMPLETE] are final answers.",
+		spoken ? `Speak and answer in ${spoken} unless the user clearly speaks another language.` : "Answer in the language the user speaks."
+	].join(" ");
+}
+function createRealtimeVoice(options) {
+	const bases = options.bases ?? SIDEBAND_BASES;
+	const log = options.log ?? {
+		info() {},
+		warn() {},
+		error() {}
+	};
+	const sessions = /* @__PURE__ */ new Map();
+	const connect = (base, callId, headers) => new Promise((resolve, reject) => {
+		const url = `${base.replace(/\/$/, "")}/${encodeURIComponent(callId)}`;
+		const ws = new options.WebSocket(url, { headers });
+		let settled = false;
+		const fail = (error) => {
+			if (!settled) {
+				settled = true;
+				reject(error);
+			}
+		};
+		ws.on("open", () => {
+			if (!settled) {
+				settled = true;
+				resolve(ws);
+			}
+		});
+		ws.on("unexpected-response", (request, response) => {
+			try {
+				request?.destroy?.();
+			} catch {}
+			const error = /* @__PURE__ */ new Error(`HTTP ${response?.statusCode}`);
+			error.status = response?.statusCode;
+			fail(error);
+		});
+		ws.on("error", (error) => fail(error));
+		ws.on("close", () => fail(/* @__PURE__ */ new Error("closed before it opened")));
+	});
+	async function join(callId, headers) {
+		let last;
+		for (const base of bases) {
+			const host = new URL(base).host;
+			for (let attempt = 0; attempt <= ACTIVATION_RETRY_MS.length; attempt++) try {
+				const ws = await connect(base, callId, headers);
+				log.info("voice", `joined the voice call on ${host}`);
+				return ws;
+			} catch (error) {
+				last = error;
+				if (error?.status === 404 && attempt < ACTIVATION_RETRY_MS.length) {
+					await new Promise((resolve) => setTimeout(resolve, ACTIVATION_RETRY_MS[attempt]));
+					continue;
+				}
+				log.warn("voice", `could not join the voice call on ${host}`, String(error?.message ?? error));
+				break;
+			}
+		}
+		throw last ?? /* @__PURE__ */ new Error("no voice endpoint answered");
+	}
+	const flushTail = (threadId, session) => {
+		if (!session.flushTail || session.tail.length === 0) return;
+		const transcript = session.tail.splice(0);
+		const save = session.silent && options.record ? () => options.record(threadId, callNote(transcript)) : () => options.delegate(threadId, callRecord(transcript), () => {});
+		session.chain = session.chain.then(save).catch((error) => log.warn("voice", "could not save the voice transcript to the conversation", String(error?.message ?? error)));
+	};
+	const stop = (threadId, reason = "requested") => {
+		const session = sessions.get(threadId);
+		if (!session) return false;
+		sessions.delete(threadId);
+		session.ended = true;
+		clearTimeout(session.goodbye);
+		clearTimeout(session.closeTimer);
+		flushTail(threadId, session);
+		try {
+			session.ws.send(JSON.stringify(outbound.close()));
+		} catch {}
+		try {
+			session.ws.close();
+		} catch {}
+		session.notify("thread/realtime/closed", {
+			threadId,
+			reason
+		}).catch(() => {});
+		return true;
+	};
+	async function start(params, notify) {
+		const threadId = typeof params?.threadId === "string" ? params.threadId : "";
+		const callId = params?.transport?.type === "existingCall" ? params.transport.callId : void 0;
+		if (threadId === "") throw new Error("The voice start has no thread");
+		if (typeof callId !== "string" || callId === "") throw new Error("Live voice needs a call the phone has already set up");
+		stop(threadId, "replaced");
+		const { access, accountId } = await options.credentials();
+		const ws = await join(callId, {
+			authorization: `Bearer ${access}`,
+			"chatgpt-account-id": accountId,
+			"openai-alpha": "quicksilver=v2",
+			"user-agent": options.userAgent,
+			...typeof params.realtimeSessionId === "string" ? { "x-session-id": params.realtimeSessionId } : {},
+			...typeof params.voiceSessionId === "string" ? { "voice-session-id": params.voiceSessionId } : {}
+		});
+		const session = {
+			ws,
+			notify,
+			ended: false,
+			chain: Promise.resolve(),
+			tail: [],
+			lines: [],
+			working: 0,
+			flushTail: params.flushTranscriptTailOnSessionEnd !== false,
+			silent: params.silentTailRecord === true,
+			hangUp: params.hangUpOnGoodbye === true
+		};
+		sessions.set(threadId, session);
+		const send = (message) => {
+			try {
+				ws.send(JSON.stringify(message));
+			} catch (error) {
+				log.warn("voice", "could not send to the voice call", String(error?.message ?? error));
+			}
+		};
+		const speak = (delegationId, text) => {
+			const channel = channelOf(text, params.codexResponseHandoffChannelPrefixes ?? CHANNEL_PREFIXES);
+			if (channel === void 0) return;
+			for (const piece of appendChunks(text)) send(delegationId ? outbound.delegationAppend(delegationId, piece, channel) : outbound.sessionAppend(piece, channel));
+		};
+		session.speak = speak;
+		const runRequest = (input, delegationId) => {
+			session.chain = session.chain.then(async () => {
+				if (session.ended) return;
+				try {
+					session.working += 1;
+					try {
+						await options.delegate(threadId, delegationText(input), (text) => {
+							if (!session.ended) speak(delegationId, text);
+						});
+					} finally {
+						session.working -= 1;
+					}
+				} catch (error) {
+					log.warn("voice", "the agent could not take the voice request", String(error?.message ?? error));
+					if (!session.ended) speak(delegationId, `[COMPLETE] I could not do that: ${String(error?.message ?? "the task could not start").slice(0, 160)}`);
+				}
+			});
+		};
+		const seenTypes = /* @__PURE__ */ new Set();
+		ws.on("message", (data) => {
+			const event = parseEvent(String(data));
+			if (!event) try {
+				const type = JSON.parse(String(data))?.type;
+				if (typeof type === "string" && !seenTypes.has(type) && seenTypes.size < 40) {
+					seenTypes.add(type);
+					log.info("voice", `voice service message: ${type}`);
+				}
+			} catch {}
+			if (!event || session.ended) return;
+			if (event.kind === "delta") notify("thread/realtime/transcript/delta", {
+				threadId,
+				role: event.role,
+				delta: event.text
+			}).catch(() => {});
+			else if (event.kind === "done") {
+				if (event.text.trim() !== "") {
+					session.tail.push({
+						role: event.role,
+						text: event.text
+					});
+					if (session.tail.length > 200) session.tail.shift();
+					session.lines.push({
+						role: event.role,
+						text: event.text.slice(0, 400)
+					});
+					if (session.lines.length > 12) session.lines.shift();
+				}
+				notify("thread/realtime/transcript/done", {
+					threadId,
+					role: event.role,
+					text: event.text
+				}).catch(() => {});
+				if (session.hangUp && event.role === "user" && isGoodbye(event.text)) {
+					clearTimeout(session.goodbye);
+					const said = Date.now();
+					session.goodbye = setTimeout(() => {
+						session.goodbye = void 0;
+						if (!session.ended && !(session.delegatedAt > said - 4e3)) runRequest(event.text.trim(), void 0);
+					}, 2500);
+				}
+			} else if (event.kind === "error") {
+				log.error("voice", "the voice service reported an error", event.message);
+				notify("thread/realtime/error", {
+					threadId,
+					message: event.message
+				}).catch(() => {});
+			} else if (event.kind === "delegation") {
+				if (event.text === "") return;
+				clearTimeout(session.goodbye);
+				session.goodbye = void 0;
+				session.delegatedAt = Date.now();
+				runRequest(event.text, event.id);
+			}
+		});
+		ws.on("close", () => {
+			if (session.ended || sessions.get(threadId) !== session) return;
+			sessions.delete(threadId);
+			session.ended = true;
+			flushTail(threadId, session);
+			log.warn("voice", "the voice call closed");
+			notify("thread/realtime/closed", {
+				threadId,
+				reason: "transportClosed"
+			}).catch(() => {});
+		});
+		ws.on("error", (error) => log.warn("voice", "the voice connection failed", String(error?.message ?? error)));
+		notify("thread/realtime/started", {
+			threadId,
+			version: params.version ?? "v3",
+			realtimeSessionId: params.realtimeSessionId ?? null
+		}).catch(() => {});
+		return {};
+	}
+	const append = (threadId, text, channel) => {
+		const session = sessions.get(threadId);
+		if (!session || typeof text !== "string" || text === "") return false;
+		for (const piece of appendChunks(text)) try {
+			session.ws.send(JSON.stringify(outbound.sessionAppend(piece, channel)));
+		} catch {
+			return false;
+		}
+		return true;
+	};
+	return {
+		start,
+		stop,
+		appendText: (threadId, text) => append(threadId, text, void 0),
+		appendSpeech: (threadId, text) => append(threadId, text, "speakable"),
+		active: (threadId) => sessions.has(threadId),
+		/** Ask for the call to end once the voice has finished speaking (the window does it); closes by itself after a while if nobody does. */
+		requestClose(threadId) {
+			const session = sessions.get(threadId);
+			if (!session) return false;
+			session.closing = true;
+			session.closeTimer ??= setTimeout(() => stop(threadId, "requested"), 2e4);
+			return true;
+		},
+		/** What the voice stage shows: the last spoken lines, whether the agent is working on a request, whether the call is about to end. */
+		status(threadId) {
+			const session = sessions.get(threadId);
+			return session ? {
+				active: true,
+				working: session.working > 0,
+				closing: session.closing === true,
+				lines: session.lines.slice(-6)
+			} : {
+				active: false,
+				working: false,
+				closing: false,
+				lines: []
+			};
+		},
+		closeAll: () => {
+			for (const threadId of [...sessions.keys()]) stop(threadId, "shutdown");
+		}
+	};
+}
+//#endregion
 //#region src/remote-control-dsh.js
 /** A folder the phone named, only when it is an existing absolute folder on this machine. */
 function localFolder(value) {
@@ -4259,7 +4926,7 @@ function projectTurns(messages, at = Date.now(), imageUrls = /* @__PURE__ */ new
 	close();
 	return turns;
 }
-function thread({ id, title, preview, cwd, createdAt, updatedAt, running, turns = [], projectId = null }) {
+function thread({ id, title, preview, cwd, createdAt, updatedAt, running, turns = [], projectId = null, threadSource = "dsh" }) {
 	return {
 		id,
 		sessionId: id,
@@ -4279,7 +4946,7 @@ function thread({ id, title, preview, cwd, createdAt, updatedAt, running, turns
 		cwd: cwd ?? "",
 		cliVersion: "dsh",
 		source: { custom: "dsh" },
-		threadSource: "dsh",
+		threadSource,
 		agentNickname: null,
 		agentRole: null,
 		gitInfo: null,
@@ -4298,8 +4965,94 @@ function thread({ id, title, preview, cwd, createdAt, updatedAt, running, turns
 */
 const PHONE_RETURN_MS = 12e4;
 const ADOPT_WITHIN_MS = 6e5;
-function createDshRemoteControl({ controller, agents, permissions = () => void 0, workspaces = () => void 0, attachments = () => void 0, usage = () => void 0, usageProfile = () => void 0, projections = () => void 0, skills = () => void 0, commands = () => void 0, llm = () => void 0, trace = () => {}, phoneReturnMs = PHONE_RETURN_MS, userAgent }) {
+const V1_VOICES = [
+	"juniper",
+	"maple",
+	"spruce",
+	"ember",
+	"vale",
+	"breeze",
+	"arbor",
+	"sol",
+	"cove"
+];
+const REALTIME_VOICES = {
+	v1: V1_VOICES,
+	v2: [
+		"alloy",
+		"ash",
+		"ballad",
+		"coral",
+		"echo",
+		"sage",
+		"shimmer",
+		"verse",
+		"marin",
+		"cedar"
+	],
+	v3: [
+		...V1_VOICES,
+		"aube",
+		"bubbie",
+		"haetsal",
+		"hanul",
+		"himari",
+		"leher",
+		"miko",
+		"neer",
+		"porto",
+		"rindo",
+		"rio",
+		"rivage",
+		"selva",
+		"sonna",
+		"tinta",
+		"viola"
+	],
+	defaultV1: "cove",
+	defaultV2: "marin"
+};
+/** The phone's saved defaults, nested like a config file and kept across restarts. */
+function createPhoneConfig(file) {
+	let value = {};
+	try {
+		if (file) value = JSON.parse(readFileSync(file, "utf8"));
+	} catch {}
+	if (value === null || typeof value !== "object" || Array.isArray(value)) value = {};
+	const save = () => {
+		if (!file) return;
+		try {
+			mkdirSync(dirname(file), { recursive: true });
+			writeFileSync(file, JSON.stringify(value));
+		} catch {}
+	};
+	const FORBIDDEN = /* @__PURE__ */ new Set([
+		"__proto__",
+		"constructor",
+		"prototype"
+	]);
+	return {
+		read: () => structuredClone(value),
+		write(edits) {
+			if (!Array.isArray(edits)) return;
+			for (const edit of edits.slice(0, 50)) {
+				const path = typeof edit?.keyPath === "string" ? edit.keyPath.split(".").filter(Boolean) : [];
+				if (path.length === 0 || path.length > 6 || path.some((part) => FORBIDDEN.has(part))) continue;
+				let node = value;
+				for (const part of path.slice(0, -1)) {
+					if (node[part] === null || typeof node[part] !== "object") node[part] = {};
+					node = node[part];
+				}
+				if (edit.value === null || edit.value === void 0) delete node[path.at(-1)];
+				else node[path.at(-1)] = edit.value;
+			}
+			save();
+		}
+	};
+}
+function createDshRemoteControl({ controller, agents, permissions = () => void 0, workspaces = () => void 0, attachments = () => void 0, usage = () => void 0, usageProfile = () => void 0, projections = () => void 0, skills = () => void 0, commands = () => void 0, llm = () => void 0, speed = void 0, trace = () => {}, phoneReturnMs = PHONE_RETURN_MS, userAgent, appServerUserAgent = userAgent, configFile = void 0, voice = void 0 }) {
 	const subscribers = /* @__PURE__ */ new Map();
+	const threadSources = /* @__PURE__ */ new Map();
 	const active = /* @__PURE__ */ new Map();
 	const queues = /* @__PURE__ */ new Map();
 	let catalog;
@@ -4312,6 +5065,9 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 	const openedBy = /* @__PURE__ */ new Map();
 	const subscribe = (threadId, notify) => {
 		const set = subscribers.get(threadId) ?? /* @__PURE__ */ new Set();
+		if (notify.clientId) {
+			for (const other of [...set]) if (other !== notify && other.clientId === notify.clientId) set.delete(other);
+		}
 		set.add(notify);
 		subscribers.set(threadId, set);
 		if (notify.clientId) {
@@ -4404,7 +5160,7 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 			reasoningEffort: current?.reasoningEffort ?? null,
 			runtimeWorkspaceRoots: cwd ? [cwd] : [],
 			sandbox: sandboxFor(preset, cwd),
-			serviceTier: null,
+			serviceTier: shownTier(),
 			turnsBackwardsCursor: null
 		};
 	};
@@ -4472,7 +5228,21 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 		return urls;
 	};
 	/** The turn DSH is running, as the phone should see it now: what is committed, plus the reply still being written. */
-	const withLiveTurn = (id, turns) => {
+	const aliases = /* @__PURE__ */ new Map();
+	const keepShownId = (threadId, committed, shown) => {
+		if (committed === shown) return;
+		aliases.set(`${threadId}\0${committed}`, shown);
+		if (aliases.size > 2e3) aliases.delete(aliases.keys().next().value);
+	};
+	const withShownIds = (id, turns) => aliases.size === 0 ? turns : turns.map((turn) => ({
+		...turn,
+		items: turn.items.map((item) => aliases.has(`${id}\0${item.id}`) ? {
+			...item,
+			id: aliases.get(`${id}\0${item.id}`)
+		} : item)
+	}));
+	const withLiveTurn = (id, shownTurns) => {
+		const turns = withShownIds(id, shownTurns);
 		const live = active.get(id);
 		if (!live) return turns;
 		const typed = (item) => (item?.content ?? []).filter((part) => part.type === "text").map((part) => part.text).join("");
@@ -4483,7 +5253,11 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 		}] : [];
 		const last = turns.at(-1);
 		const ours = last?.items[0]?.type === "userMessage" && typed(last.items[0]) === typed(live.userItem);
-		const items = ours ? [...last.items, ...tail] : [live.userItem, ...tail];
+		const items = ours ? [
+			live.userItem,
+			...last.items.slice(1),
+			...tail
+		] : [live.userItem, ...tail];
 		return [...ours ? turns.slice(0, -1) : turns, {
 			...live.turn,
 			items,
@@ -4510,12 +5284,44 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 				createdAt: session.meta?.createdAt,
 				running: active.has(id),
 				projectId: projectIdOf(id),
+				threadSource: threadSources.get(id),
 				preview: first ? visibleText(first.content).slice(0, 200) : "",
 				turns: withLiveTurn(id, projectTurns(messages, session.meta?.createdAt, imageUrls, cwd))
 			})
 		};
 	};
 	/** Apply a model or effort the phone picked; DSH validates it against its own catalog. */
+	const TIER_OF = {
+		fast: "priority",
+		ultrafast: "ultrafast"
+	};
+	const MODE_OF = {
+		priority: "fast",
+		fast: "fast",
+		ultrafast: "ultrafast",
+		default: "standard"
+	};
+	const tiersOf = (provider, model) => {
+		try {
+			return speed?.tiers?.(provider, model) ?? [];
+		} catch {
+			return [];
+		}
+	};
+	const shownTier = () => {
+		try {
+			return TIER_OF[speed?.current?.()] ?? null;
+		} catch {
+			return null;
+		}
+	};
+	/** A tier the phone picked: a string id, "default" or null for standard speed; undefined leaves the setting alone. */
+	const applySpeed = async (tier) => {
+		if (tier === void 0 || !speed?.set) return;
+		const mode = tier === null ? "standard" : MODE_OF[tier];
+		if (mode === void 0 || mode === speed.current?.()) return;
+		await speed.set(mode);
+	};
 	const applySelection = async (agent, sessionId, params) => {
 		const picked = parseModelKey(params?.model);
 		const effort = typeof params?.effort === "string" ? params.effort : void 0;
@@ -4656,6 +5462,9 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 		subscribe(id, notify);
 		await applySelection(agent, id, params);
 		applyPermissions(agent, params);
+		const speedBefore = speed?.current?.();
+		const speedForTurn = typeof params?.serviceTierForTurn === "string" ? params.serviceTierForTurn : void 0;
+		await applySpeed(speedForTurn ?? (Object.hasOwn(params ?? {}, "serviceTier") ? params.serviceTier : void 0));
 		const turn = emptyTurn();
 		const userItem = {
 			type: "userMessage",
@@ -4727,6 +5536,12 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 				});
 			}
 			turn.completedAt = seconds(Date.now());
+			if (speedForTurn !== void 0 && speedBefore !== void 0 && speed?.current?.() !== speedBefore) Promise.resolve(speed.set?.(speedBefore)).catch(() => {});
+			const sentText = visibleText(userItem.content.filter((part) => part.type === "text"));
+			try {
+				const committedUser = agent.session.deriveMessages().findLast((message) => typedText(message) !== "" && typedText(message) === sentText);
+				if (committedUser) keepShownId(id, committedUser.id, userItem.id);
+			} catch {}
 			active.delete(id);
 			compactions.delete(id);
 			const usageNow = tokenUsage(agent.session);
@@ -4791,6 +5606,54 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 		const needle = typeof term === "string" ? term.trim().toLocaleLowerCase() : "";
 		return needle === "" || snippets.has(entry.id) || `${entry.name ?? ""} ${entry.preview}`.toLocaleLowerCase().includes(needle);
 	};
+	/** Run a request the voice model handed over as a turn, and pass each message the agent finishes back to it. */
+	const delegateToAgent = async (threadId, text, onMessage) => {
+		for (let waited = 0; active.has(threadId) && waited < 6e5; waited += 500) await new Promise((resolve) => setTimeout(resolve, 500));
+		let finish;
+		const finished = new Promise((resolve) => {
+			finish = resolve;
+		});
+		const observer = async (method, params) => {
+			if (params?.threadId !== threadId) return;
+			if (method === "item/completed" && params.item?.type === "agentMessage" && typeof params.item.text === "string" && params.item.text.trim() !== "") onMessage(params.item.text);
+			else if (method === "turn/completed") finish();
+		};
+		try {
+			await startTurn({
+				threadId,
+				input: [{
+					type: "text",
+					text,
+					text_elements: []
+				}]
+			}, observer);
+			await finished;
+		} finally {
+			subscribers.get(threadId)?.delete(observer);
+		}
+	};
+	/** Leave text in the conversation's context for its next message, without starting a turn. */
+	const recordToAgent = async (threadId, text) => {
+		const agent = await agentFor(threadId);
+		if (typeof agent.inject !== "function") return;
+		agent.inject({
+			id: randomUUID(),
+			role: "user",
+			content: [{
+				type: "text",
+				text
+			}],
+			source: { kind: "user" }
+		});
+	};
+	const realtimeVoice = voice ? createRealtimeVoice({
+		...voice,
+		userAgent,
+		log: diagnosticLog,
+		delegate: delegateToAgent,
+		record: recordToAgent
+	}) : void 0;
+	const phoneConfig = createPhoneConfig(configFile);
 	const methods = {
 		initialize: () => ({
 			codexHome: "",
@@ -4799,7 +5662,7 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 				darwin: "macos",
 				win32: "windows"
 			}[process.platform] ?? process.platform,
-			userAgent
+			userAgent: appServerUserAgent
 		}),
 		"account/read": async () => ({
 			account: {
@@ -4847,11 +5710,12 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 						defaultReasoningEffort: model.reasoning?.defaultEffort ?? supported[0].reasoningEffort,
 						inputModalities: modalities.get(model.id)?.length ? modalities.get(model.id) : ["text"],
 						supportsPersonality: false,
-						additionalSpeedTiers: [],
+						additionalSpeedTiers: tiersOf(group.id, model.id).map((tier) => tier.id),
 						upgrade: null,
 						upgradeInfo: null,
 						availabilityNux: null,
-						serviceTiers: []
+						serviceTiers: tiersOf(group.id, model.id),
+						defaultServiceTier: null
 					});
 				}
 			}
@@ -4869,18 +5733,22 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 			const agent = await agentFor(params?.threadId);
 			await applySelection(agent, params.threadId, params);
 			applyPermissions(agent, params);
+			if (Object.hasOwn(params ?? {}, "serviceTier")) await applySpeed(params.serviceTier);
 			return {};
 		},
 		"thread/attachment/list": () => ({
 			data: [],
 			nextCursor: null
 		}),
-		"config/batchWrite": () => ({
-			status: "ok",
-			version: "1",
-			filePath: process.platform === "win32" ? "C:dshconfig.toml" : "/dsh/config.toml",
-			overriddenMetadata: null
-		}),
+		"config/batchWrite": (params) => {
+			phoneConfig.write(params?.edits);
+			return {
+				status: "ok",
+				version: "1",
+				filePath: process.platform === "win32" ? "C:dshconfig.toml" : "/dsh/config.toml",
+				overriddenMetadata: null
+			};
+		},
 		"command/exec": async (params) => {
 			const folders = await conversationFolders();
 			try {
@@ -4908,6 +5776,51 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 		},
 		"fs/readDirectory": (params) => ({ entries: readFolder(params?.path) }),
 		"collaborationMode/list": () => ({ data: [] }),
+		"thread/realtime/listVoices": () => {
+			return { voices: REALTIME_VOICES };
+		},
+		"thread/realtime/start": async (params, { notify }) => {
+			const threadId = typeof params?.threadId === "string" ? params.threadId : "";
+			const fail = (message) => {
+				setTimeout(() => {
+					notify("thread/realtime/error", {
+						threadId,
+						message
+					}).catch(() => {});
+					notify("thread/realtime/closed", {
+						threadId,
+						reason: "error"
+					}).catch(() => {});
+				}, 50);
+				return {};
+			};
+			if (!realtimeVoice) return fail("Live voice is not available on this DSH");
+			subscribe(threadId, notify);
+			realtimeVoice.start(params, notify).catch((error) => {
+				diagnosticLog.error("voice", "live voice could not start", String(error?.message ?? error));
+				notify("thread/realtime/error", {
+					threadId,
+					message: "Live voice could not connect to the voice service"
+				}).catch(() => {});
+				notify("thread/realtime/closed", {
+					threadId,
+					reason: "error"
+				}).catch(() => {});
+			});
+			return {};
+		},
+		"thread/realtime/stop": (params) => {
+			realtimeVoice?.stop(params?.threadId);
+			return {};
+		},
+		"thread/realtime/appendText": (params) => {
+			realtimeVoice?.appendText(params?.threadId, params?.text);
+			return {};
+		},
+		"thread/realtime/appendSpeech": (params) => {
+			realtimeVoice?.appendSpeech(params?.threadId, params?.text);
+			return {};
+		},
 		"permissionProfile/list": () => ({
 			data: [],
 			nextCursor: null
@@ -4922,7 +5835,7 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 			nextCursor: null
 		}),
 		"config/read": () => ({
-			config: {},
+			config: phoneConfig.read(),
 			origins: {},
 			layers: null
 		}),
@@ -5106,8 +6019,14 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 			const cwd = localFolder(params?.cwd);
 			const project = typeof params?.projectId === "string" ? workspaceList().find((entry) => String(entry.id) === params.projectId) : void 0;
 			const created = await service().create(project ? { workspaceId: project.id } : cwd ? { cwd } : {});
+			if (typeof params?.threadSource === "string" && params.threadSource !== "") threadSources.set(created.sessionId, params.threadSource.slice(0, 64));
 			const agent = await agentFor(created.sessionId);
-			await applySelection(agent, created.sessionId, params);
+			const saved = phoneConfig.read();
+			await applySelection(agent, created.sessionId, {
+				...params,
+				model: params?.model ?? saved.model,
+				effort: params?.effort ?? saved.model_reasoning_effort
+			});
 			const { thread: value } = await openThread(created.sessionId, notify);
 			emit(created.sessionId, "thread/started", { thread: value });
 			return {
@@ -5221,6 +6140,10 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 				sessionId: params?.threadId,
 				title: String(params?.name ?? "")
 			});
+			emit(params?.threadId, "thread/name/updated", {
+				threadId: params?.threadId,
+				threadName: String(params?.name ?? "")
+			});
 			return {};
 		},
 		"thread/queue/list": (params) => ({
@@ -5569,6 +6492,7 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 			if (reuse && item.type === "agentMessage") {
 				const shown = reuse;
 				reuse = void 0;
+				keepShownId(session.id, item.id, shown.id);
 				shown.text = item.text;
 				emit(session.id, "item/completed", {
 					threadId: session.id,
@@ -5614,6 +6538,42 @@ function createDshRemoteControl({ controller, agents, permissions = () => void 0
 	};
 	return {
 		methods,
+		desktopVoice: realtimeVoice === void 0 ? void 0 : Object.freeze({
+			async start({ sessionId, sdp, voice: voiceName, language }) {
+				if (typeof sdp !== "string" || !sdp.startsWith("v=0") || sdp.length > 64 * 1024) throw new RpcError(-32602, "Invalid voice offer");
+				const agent = await agentFor(sessionId);
+				diagnosticLog.info("voice", "the conversation can take a context note", String(typeof agent.inject === "function"));
+				const session = {
+					audio: { output: { voice: typeof voiceName === "string" && /^[a-z]{2,16}$/u.test(voiceName) ? voiceName : "cove" } },
+					delegation: { type: "client" },
+					instructions: desktopInstructions(language),
+					model: "gpt-live-1.1-codex"
+				};
+				const { callId, answer } = await createVoiceCall({
+					fetch: voice.fetch,
+					credentials: voice.credentials,
+					userAgent,
+					sdp,
+					session,
+					threadId: sessionId
+				});
+				await realtimeVoice.start({
+					threadId: sessionId,
+					transport: {
+						type: "existingCall",
+						callId
+					},
+					flushTranscriptTailOnSessionEnd: true,
+					silentTailRecord: true,
+					hangUpOnGoodbye: true,
+					version: "v3"
+				}, async () => {});
+				return { answer };
+			},
+			stop: (sessionId) => realtimeVoice.stop(sessionId),
+			end: (sessionId) => realtimeVoice.requestClose(sessionId),
+			status: (sessionId) => realtimeVoice.status(sessionId)
+		}),
 		onSessionEvent,
 		onStream,
 		onApproval,
@@ -6431,6 +7391,7 @@ var CodexLoginCoordinator = class {
 					return;
 				}
 			} catch {}
+			diagnosticLog.error("login", `sign-in failed (${classifyLoginFailure(error)})`, error);
 			session.view = {
 				id,
 				provider: "openai-codex",
@@ -6866,6 +7827,7 @@ function openaiCodexSubscriptionProvider({ resolveSpeedMode = () => void 0, reso
 	};
 	const noteStreamFailure = (stage, error, source) => {
 		streamFailure.count += 1;
+		diagnosticLog.error("model", `request failed while ${stage === "prepare" ? "preparing" : stage === "request" ? "sending" : stage === "payload" ? "building the payload" : "streaming"}`, error);
 		streamFailure.stage = stage;
 		try {
 			streamFailure.request = source === void 0 ? void 0 : redactRequest(source);
@@ -7022,11 +7984,11 @@ const LEVELS = [
 	"max"
 ];
 const DEFAULT_REFRESH_TIMEOUT_MS = 1e4;
-const record$6 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const record$7 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
 const nonEmpty$1 = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
 const positiveInteger = (value) => Number.isSafeInteger(value) && value > 0 ? value : void 0;
 function upgradeModelId(value) {
-	return (typeof value.upgrade === "string" ? nonEmpty$1(value.upgrade) : record$6(value.upgrade) ? nonEmpty$1(value.upgrade.model) : void 0) ?? (record$6(value.upgrade_info) ? nonEmpty$1(value.upgrade_info.model) : void 0) ?? (record$6(value.upgradeInfo) ? nonEmpty$1(value.upgradeInfo.model) : void 0);
+	return (typeof value.upgrade === "string" ? nonEmpty$1(value.upgrade) : record$7(value.upgrade) ? nonEmpty$1(value.upgrade.model) : void 0) ?? (record$7(value.upgrade_info) ? nonEmpty$1(value.upgrade_info.model) : void 0) ?? (record$7(value.upgradeInfo) ? nonEmpty$1(value.upgradeInfo.model) : void 0);
 }
 function retirementMillis(value) {
 	for (const source of [
@@ -7035,7 +7997,7 @@ function retirementMillis(value) {
 		value.upgrade_info,
 		value.upgradeInfo
 	]) {
-		if (!record$6(source)) continue;
+		if (!record$7(source)) continue;
 		for (const raw of [source.retirement_at, source.retirementAt]) {
 			const seconds = positiveInteger(raw);
 			if (seconds !== void 0 && Number.isSafeInteger(seconds * 1e3)) return seconds * 1e3;
@@ -7047,7 +8009,7 @@ function retirementMillis(value) {
 	}
 }
 function retirementNotice(value, now = Date.now(), targetDisplayName) {
-	if (!record$6(value) || !Number.isFinite(now)) return void 0;
+	if (!record$7(value) || !Number.isFinite(now)) return void 0;
 	const at = retirementMillis(value);
 	if (at === void 0 || at <= now) return void 0;
 	const date = new Date(at);
@@ -7063,7 +8025,7 @@ function retirementNotice(value, now = Date.now(), targetDisplayName) {
 	};
 }
 function reasoningMap(levels) {
-	const supported = new Set((Array.isArray(levels) ? levels : []).map((level) => nonEmpty$1(record$6(level) ? level.effort : void 0)).filter(Boolean));
+	const supported = new Set((Array.isArray(levels) ? levels : []).map((level) => nonEmpty$1(record$7(level) ? level.effort : void 0)).filter(Boolean));
 	const map = Object.fromEntries(LEVELS.map((level) => [level, null]));
 	if (supported.has("none")) map.off = "none";
 	for (const level of LEVELS.slice(1)) if (supported.has(level)) map[level] = level;
@@ -7071,6 +8033,24 @@ function reasoningMap(levels) {
 }
 const capabilityNames = (values) => [...new Set(values.filter((value) => typeof value === "string" && /^[a-z][a-z0-9_-]{0,31}$/u.test(value)))].sort().slice(0, 16);
 const speedTierIds = (value) => [...Array.isArray(value.additional_speed_tiers) ? value.additional_speed_tiers : [], ...Array.isArray(value.service_tiers) ? value.service_tiers.map((tier) => tier?.id) : []];
+const HONOURED_TIERS = /* @__PURE__ */ new Set([
+	"priority",
+	"fast",
+	"ultrafast"
+]);
+function serviceTierEntries(value) {
+	const found = (Array.isArray(value.service_tiers) ? value.service_tiers : []).flatMap((tier) => record$7(tier) && typeof tier.id === "string" && HONOURED_TIERS.has(tier.id) ? [{
+		id: tier.id,
+		name: nonEmpty$1(tier.name) ?? tier.id,
+		description: nonEmpty$1(tier.description) ?? ""
+	}] : []);
+	for (const id of Array.isArray(value.additional_speed_tiers) ? value.additional_speed_tiers : []) if (typeof id === "string" && HONOURED_TIERS.has(id) && !found.some((tier) => tier.id === id)) found.push({
+		id,
+		name: id === "ultrafast" ? "Ultrafast" : "Fast",
+		description: ""
+	});
+	return found;
+}
 function unsupportedCapabilities(value) {
 	const reasoning = capabilityNames((value.supported_reasoning_levels ?? []).map((item) => item?.effort)).filter((level) => !["none", ...LEVELS.slice(1)].includes(level));
 	const inputs = capabilityNames(Array.isArray(value.input_modalities) ? value.input_modalities : []).filter((input) => !["text", "image"].includes(input));
@@ -7089,7 +8069,7 @@ function unsupportedCapabilities(value) {
 	};
 }
 function visibleModel(value, displayNames, now) {
-	if (!record$6(value)) return void 0;
+	if (!record$7(value)) return void 0;
 	const id = nonEmpty$1(value.slug);
 	const reserve = id === "gpt-reserve" && ["list", "hide"].includes(value.visibility);
 	if (id === void 0 || value.visibility !== "list" && !reserve) return void 0;
@@ -7124,6 +8104,7 @@ function visibleModel(value, displayNames, now) {
 			"medium",
 			"high"
 		].includes(value.default_verbosity) ? value.default_verbosity : void 0,
+		serviceTiers: serviceTierEntries(value),
 		supportsFast: speedTierIds(value).some((tier) => tier === "fast" || tier === "priority"),
 		supportsUltrafast: speedTierIds(value).includes("ultrafast")
 	};
@@ -7134,22 +8115,22 @@ function visibleModel(value, displayNames, now) {
 * visibility), with low reasoning when the reviewer supports it.
 */
 function officialReviewModel(value, parentId) {
-	if (!record$6(value) || !Array.isArray(value.models)) return void 0;
-	const parent = value.models.find((model) => record$6(model) && model.slug === parentId);
+	if (!record$7(value) || !Array.isArray(value.models)) return void 0;
+	const parent = value.models.find((model) => record$7(model) && model.slug === parentId);
 	const id = nonEmpty$1(parent?.auto_review_model_override) ?? "codex-auto-review";
-	const preset = value.models.find((model) => record$6(model) && model.slug === id);
+	const preset = value.models.find((model) => record$7(model) && model.slug === id);
 	if (preset === void 0) return void 0;
-	const effort = (Array.isArray(preset.supported_reasoning_levels) ? preset.supported_reasoning_levels : []).some((level) => (record$6(level) ? level.effort : level) === "low") ? "low" : nonEmpty$1(preset.default_reasoning_level);
+	const effort = (Array.isArray(preset.supported_reasoning_levels) ? preset.supported_reasoning_levels : []).some((level) => (record$7(level) ? level.effort : level) === "low") ? "low" : nonEmpty$1(preset.default_reasoning_level);
 	return {
 		id,
 		...effort === void 0 ? {} : { effort }
 	};
 }
 function parseOfficialModelCatalog(value, now = Date.now()) {
-	if (!record$6(value) || !Array.isArray(value.models)) throw new Error("Codex returned a malformed model catalog");
+	if (!record$7(value) || !Array.isArray(value.models)) throw new Error("Codex returned a malformed model catalog");
 	const displayNames = /* @__PURE__ */ new Map();
 	for (const model of value.models) {
-		if (!record$6(model)) continue;
+		if (!record$7(model)) continue;
 		const id = nonEmpty$1(model.slug);
 		const name = nonEmpty$1(model.display_name);
 		if (id !== void 0 && name !== void 0 && !displayNames.has(id)) displayNames.set(id, name);
@@ -7312,6 +8293,115 @@ function createOfficialModelCatalog(options = {}) {
 	});
 }
 //#endregion
+//#region src/deepseek-account-search.js
+const DSH_ACCOUNT_SEARCH_PROVIDER_ID = "codex-subscription-dsh";
+const DEFAULT_BASE_URL = "https://api.deepseek.com/v1/tools";
+const DEFAULT_COUNT = 10;
+const MAX_QUESTION = 128;
+const record$6 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const missing = (message) => new WebError(message, "WEB_PROVIDER_CREDENTIAL_MISSING");
+function parseSources(value) {
+	if (!record$6(value) || !Array.isArray(value.results)) throw new WebError("DeepSeek returned an invalid search response", "WEB_PROVIDER_ERROR");
+	return {
+		sources: value.results.flatMap((item) => {
+			if (!record$6(item) || typeof item.url !== "string" || item.url.length === 0) return [];
+			return [{
+				url: item.url,
+				...typeof item.title === "string" && item.title.length > 0 ? { title: item.title } : {},
+				...typeof item.snippet === "string" && item.snippet.length > 0 ? { snippet: item.snippet } : {},
+				...typeof item.date === "string" && item.date.length > 0 ? { publishedAt: item.date } : {}
+			}];
+		}),
+		truncated: false
+	};
+}
+/**
+* Search through DeepSeek's Search API with the signed-in DeepSeek account, for conversations whose
+* model is not a DeepSeek Account one (DSH itself only hands the account token to those).
+*/
+async function searchWithDeepSeekAccount(options, request, signal) {
+	signal?.throwIfAborted();
+	const account = options.resolveAccount?.();
+	if (typeof account?.resolveToken !== "function") throw missing("DeepSeek account sign-in is not available");
+	const config = options.resolveConfig?.() ?? {};
+	const baseURL = typeof config.baseURL === "string" && config.baseURL.length > 0 ? config.baseURL : DEFAULT_BASE_URL;
+	const count = Number.isInteger(config.count) && config.count > 0 ? config.count : DEFAULT_COUNT;
+	let endpoint;
+	try {
+		endpoint = `${new URL(baseURL).href.replace(/\/+$/u, "")}/search`;
+	} catch {
+		throw new WebError("DeepSeek search base URL is invalid", "WEB_PROVIDER_ERROR");
+	}
+	let token;
+	try {
+		token = await account.resolveToken(endpoint);
+	} catch {
+		throw missing("DeepSeek account sign-in could not be read");
+	}
+	if (typeof token !== "string" || token.length === 0) throw missing("DeepSeek account is not signed in");
+	const question = config.sendOriginalQuestion === false ? void 0 : Array.from((options.resolveQuestion?.() ?? "").replace(/\s+/gu, " ").trim()).slice(0, MAX_QUESTION).join("");
+	let response;
+	try {
+		response = await (options.fetch ?? fetch)(endpoint, {
+			method: "POST",
+			redirect: "error",
+			headers: {
+				"x-dsh-auth-token": token,
+				"content-type": "application/json",
+				accept: "application/json",
+				"user-agent": USER_AGENT
+			},
+			body: JSON.stringify({
+				query: request.query,
+				count: Math.min(count, request.maxResults ?? count),
+				need_content: false,
+				...question ? { ori_question: question } : {}
+			}),
+			signal
+		});
+	} catch (error) {
+		if (signal?.aborted || error?.name === "AbortError") throw new WebError("DeepSeek web request aborted", "WEB_ABORTED", { cause: error });
+		throw new WebError("DeepSeek web request failed", "WEB_PROVIDER_ERROR", { cause: error });
+	}
+	if (!response.ok) throw response.status === 401 ? new WebError("DeepSeek rejected the account sign-in used for web search; sign in to DeepSeek again", "WEB_PROVIDER_ERROR") : new WebError(`DeepSeek search request failed (HTTP ${response.status})`, "WEB_PROVIDER_ERROR");
+	let body;
+	try {
+		body = await response.json();
+	} catch (error) {
+		throw new WebError("DeepSeek returned an unreadable search response", "WEB_PROVIDER_ERROR", { cause: error });
+	}
+	return parseSources(body);
+}
+/**
+* The DSH search source with the account fallback: DSH's own provider goes first, and only when it
+* reports a missing credential (no API key, model not a DeepSeek Account one) the account token is used.
+*/
+function createDshAccountSearchProvider(options) {
+	return Object.freeze({
+		id: DSH_ACCOUNT_SEARCH_PROVIDER_ID,
+		available: () => true,
+		async search(request, signal) {
+			const provider = options.resolveDshProvider?.();
+			if (provider === void 0 || provider.id === "codex-subscription-dsh" || provider.available() !== true) throw new WebError("DSH default search is unavailable", "WEB_PROVIDER_UNAVAILABLE");
+			try {
+				const result = await provider.search(request, signal);
+				options.report?.(`answered by DSH provider ${provider.id}`);
+				return result;
+			} catch (error) {
+				if (error?.code !== "WEB_PROVIDER_CREDENTIAL_MISSING" || signal?.aborted) throw error;
+				try {
+					const result = await searchWithDeepSeekAccount(options, request, signal);
+					options.report?.("answered by DeepSeek account fallback");
+					return result;
+				} catch (fallback) {
+					options.report?.(`DeepSeek account fallback failed: ${fallback?.message}`);
+					throw fallback?.code === "WEB_PROVIDER_CREDENTIAL_MISSING" ? error : fallback;
+				}
+			}
+		}
+	});
+}
+//#endregion
 //#region src/codex-search.js
 const CODEX_SEARCH_PROVIDER_ID = "codex-subscription";
 const CODEX_AUTO_SEARCH_PROVIDER_ID = "codex-subscription-auto";
@@ -7437,16 +8527,43 @@ function createCodexSearchProvider(options) {
 		}
 	});
 }
-/** Route each request by its initiating model without changing the user's explicit overrides. */
+const UNAVAILABLE_CODES = /* @__PURE__ */ new Set([
+	"WEB_PROVIDER_CREDENTIAL_MISSING",
+	"WEB_PROVIDER_UNAVAILABLE",
+	"WEB_PROVIDER_CONFIGURED_MISSING",
+	"WEB_PROVIDER_CONFIGURED_UNAVAILABLE"
+]);
+const unavailable = (error) => typeof error?.code === "string" && UNAVAILABLE_CODES.has(error.code);
+/** Route each request by its initiating model; when that side has no sign-in or key, use the other one. */
 function createCodexAutoSearchProvider(options) {
+	const dsh = () => {
+		const provider = options.resolveDshProvider?.();
+		if (provider === void 0 || provider.id === "codex-subscription-auto" || provider.id === "codex-subscription" || provider.available() !== true) throw new WebError("DSH default search is unavailable", "WEB_PROVIDER_UNAVAILABLE");
+		return provider;
+	};
+	const viaDsh = (request, signal) => {
+		try {
+			return Promise.resolve(dsh().search(request, signal));
+		} catch (error) {
+			return Promise.reject(error);
+		}
+	};
+	const viaCodex = (request, signal) => options.codex.search(request, signal);
 	return Object.freeze({
 		id: CODEX_AUTO_SEARCH_PROVIDER_ID,
 		available: () => true,
 		async search(request, signal) {
-			if (options.resolveModelProvider?.() === "openai-codex") return options.codex.search(request, signal);
-			const provider = options.resolveDshProvider?.();
-			if (provider === void 0 || provider.id === "codex-subscription-auto" || provider.id === "codex-subscription" || provider.available() !== true) throw new WebError("DSH default search is unavailable", "WEB_PROVIDER_UNAVAILABLE");
-			return provider.search(request, signal);
+			const [first, second] = options.resolveModelProvider?.() === "openai-codex" ? [viaCodex, viaDsh] : [viaDsh, viaCodex];
+			try {
+				return await first(request, signal);
+			} catch (error) {
+				if (!unavailable(error) || signal?.aborted) throw error;
+				try {
+					return await second(request, signal);
+				} catch (fallbackError) {
+					throw unavailable(fallbackError) ? error : fallbackError;
+				}
+			}
 		}
 	});
 }
@@ -7810,6 +8927,11 @@ const actions = Object.freeze({
 	codex_image_generate: "images",
 	codex_sketch: "sketch"
 });
+const QUIET = /* @__PURE__ */ new Set([
+	"usage",
+	"storage/status",
+	"preferences/models"
+]);
 function safeOperations(raw) {
 	if (!Array.isArray(raw?.events)) return void 0;
 	return {
@@ -7849,6 +8971,8 @@ function createDiagnosticOperations({ now = Date.now } = {}) {
 			status,
 			observedAt: now()
 		});
+		if (status === "failed") diagnosticLog.error(actions[action], `${action} failed`);
+		else if (status === "completed" && !QUIET.has(action)) diagnosticLog.info(actions[action], `${action} completed`);
 		if (events.length > 32) {
 			events.shift();
 			dropped++;
@@ -7863,12 +8987,21 @@ function createDiagnosticOperations({ now = Date.now } = {}) {
 				return result;
 			} catch (error) {
 				record(endpoint, signal?.aborted ? "cancelled" : "failed");
+				if (!signal?.aborted) diagnosticLog.error(actions[endpoint] ?? "rpc", `${endpoint} threw`, error);
 				throw error;
 			}
 		},
 		tool: (exec, result) => {
 			if (!["codex_image_generate", "codex_sketch"].includes(exec?.name)) return;
 			record(exec.name, exec.signal?.aborted ? "cancelled" : result?.isError === true ? "failed" : result?.isError === false ? "completed" : "failed", "tool");
+			if (result?.isError === true && !exec.signal?.aborted) {
+				const text = [
+					result.content,
+					result.output,
+					result.error
+				].flat().map((part) => typeof part === "string" ? part : part?.text).find((part) => typeof part === "string" && part !== "");
+				if (text !== void 0) diagnosticLog.error(actions[exec.name], `${exec.name} said`, text);
+			}
 		},
 		snapshot: () => ({
 			scope: "plugin-process",
@@ -8141,6 +9274,7 @@ async function createSubscriptionDiagnostics({ auth, preferences, login = { phas
 		account,
 		login,
 		requests: collected.requests ?? {},
+		log: diagnosticLog.snapshot(300),
 		...collected.history ? { requestHistory: collected.history } : {},
 		...collected.operations ? { operations: collected.operations } : {},
 		...collected.websocket ? { websocket: collected.websocket } : {},
@@ -9946,7 +11080,7 @@ async function settlesLive(preferences, patch, signal, { attempts = 8, delayMs =
 	}
 	return live();
 }
-function createSubscriptionRpcHandler({ authHandler, usageReader, accountUsageReader, planHistoryReader, usageProfileReader, resetCreditService, preferences, defaultModel, runtimeManagement, remoteControl, diagnosticsReader, modelCatalog, originalImages, resolveInheritedOriginal, closeConnections, onAccountChanged, onCleanupFailure }) {
+function createSubscriptionRpcHandler({ authHandler, usageReader, accountUsageReader, planHistoryReader, usageProfileReader, resetCreditService, preferences, defaultModel, runtimeManagement, remoteControl, desktopVoice, voicePreview, diagnosticsReader, modelCatalog, originalImages, resolveInheritedOriginal, closeConnections, onAccountChanged, onCleanupFailure }) {
 	return async (endpoint, payload, signal) => {
 		if (endpoint === "default-model/status" || endpoint === "default-model/select") try {
 			signal.throwIfAborted();
@@ -9961,6 +11095,59 @@ function createSubscriptionRpcHandler({ authHandler, usageReader, accountUsageRe
 			if (error?.code === "unavailable") return publicError("unavailable", endpoint === "default-model/status" ? "The default model is unavailable" : "Could not save the default model");
 			return publicError("internal", endpoint === "default-model/status" ? "Could not read the default model" : "Could not save the default model");
 		}
+		if (endpoint === "voice/status") try {
+			signal.throwIfAborted();
+			if (!desktopVoice || typeof payload?.sessionId !== "string") return publicError("unavailable", "Voice is unavailable");
+			return {
+				ok: true,
+				value: desktopVoice.status(payload.sessionId)
+			};
+		} catch (error) {
+			if (signal.aborted) throw error;
+			return publicError("operation-error", "Could not read the voice status");
+		}
+		if (endpoint === "voice/start" || endpoint === "voice/stop") try {
+			signal.throwIfAborted();
+			if (!desktopVoice) return publicError("unavailable", "Voice is unavailable");
+			if (typeof payload?.sessionId !== "string" || payload.sessionId.length === 0 || payload.sessionId.length > 512) return publicError("invalid-input", "Invalid voice request");
+			if (endpoint === "voice/stop") {
+				desktopVoice.stop(payload.sessionId);
+				return {
+					ok: true,
+					value: {}
+				};
+			}
+			const current = preferences?.status?.() ?? {};
+			if (current.voiceCall !== "on") return publicError("unavailable", "Voice is turned off");
+			return {
+				ok: true,
+				value: await desktopVoice.start({
+					sessionId: payload.sessionId,
+					sdp: payload.sdp,
+					voice: current.voiceVoice,
+					language: current.voiceLanguage
+				})
+			};
+		} catch (error) {
+			if (signal.aborted) throw error;
+			return publicError("operation-error", "Could not start the voice call");
+		}
+		if (endpoint === "voice/catalog" || endpoint === "voice/preview") try {
+			signal.throwIfAborted();
+			if (!voicePreview) return publicError("unavailable", "Voice preview is unavailable");
+			if (endpoint === "voice/catalog") return {
+				ok: true,
+				value: { voices: await voicePreview.available() }
+			};
+			const value = await voicePreview.preview(payload?.voice);
+			return value === void 0 ? publicError("not-found", "No sample for this voice") : {
+				ok: true,
+				value
+			};
+		} catch (error) {
+			if (signal.aborted) throw error;
+			return publicError("operation-error", "Could not load the voice sample");
+		}
 		if ([
 			"remote/status",
 			"remote/enable",
@@ -10226,6 +11413,130 @@ function createSubscriptionRpcHandler({ authHandler, usageReader, accountUsageRe
 	};
 }
 //#endregion
+//#region src/voice-preview.js
+const BASE = "https://chatgpt.com/backend-api";
+const CATALOG_TTL_MS = 10 * 6e4;
+const MAX_CLIP_BYTES = 2 * 1024 * 1024;
+const PREVIEW_HOSTS = /^https:\/\/[a-z0-9.-]*oaistatic\.com\//u;
+function createVoicePreview({ fetch, credentials, userAgent, now = Date.now, base = BASE }) {
+	let catalog;
+	const clips = /* @__PURE__ */ new Map();
+	const readCatalog = async () => {
+		if (catalog && now() - catalog.at < CATALOG_TTL_MS) return catalog.voices;
+		const { access, accountId } = await credentials();
+		const response = await fetch(`${base}/settings/voices`, {
+			headers: {
+				authorization: `Bearer ${access}`,
+				"chatgpt-account-id": accountId,
+				accept: "application/json",
+				"user-agent": userAgent
+			},
+			signal: AbortSignal.timeout(15e3)
+		});
+		if (!response.ok) throw new Error(`voice catalog HTTP ${response.status}`);
+		const value = await response.json();
+		const voices = (Array.isArray(value?.voices) ? value.voices : []).filter((entry) => typeof entry?.name === "string" && typeof entry?.preview_url === "string" && PREVIEW_HOSTS.test(entry.preview_url));
+		catalog = {
+			at: now(),
+			voices
+		};
+		return voices;
+	};
+	return {
+		/** Which voices ChatGPT's own catalog offers right now (lower-case names), so the settings can mark the others unavailable. */
+		async available() {
+			return (await readCatalog()).map((entry) => entry.name.toLowerCase());
+		},
+		/** The clip of one voice (by its Codex name, e.g. "spruce") as a data URL, with the catalog's description. */
+		async preview(voice) {
+			if (typeof voice !== "string" || !/^[a-z]{2,16}$/u.test(voice)) return void 0;
+			if (clips.has(voice)) return clips.get(voice);
+			const entry = (await readCatalog()).find((item) => item.name.toLowerCase() === voice || item.voice === voice);
+			if (!entry) return void 0;
+			const response = await fetch(entry.preview_url, { signal: AbortSignal.timeout(15e3) });
+			if (!response.ok) throw new Error(`voice sample HTTP ${response.status}`);
+			const bytes = Buffer.from(await response.arrayBuffer());
+			if (bytes.byteLength === 0 || bytes.byteLength > MAX_CLIP_BYTES) throw new Error("voice sample has an unexpected size");
+			const type = /\.mp3(?:$|\?)/u.test(entry.preview_url) ? "audio/mpeg" : "audio/mp4";
+			const result = {
+				name: entry.name,
+				description: typeof entry.description === "string" ? entry.description.slice(0, 120) : "",
+				accent: typeof entry.accent === "string" ? entry.accent.slice(0, 60) : "",
+				audio: `data:${type};base64,${bytes.toString("base64")}`
+			};
+			if (clips.size < 40) clips.set(voice, result);
+			return result;
+		}
+	};
+}
+//#endregion
+//#region src/voice-tools.js
+/**
+* The one tool the agent gets while a voice call is running, like Codex's end_realtime_voice_call: the voice model hands
+* "the user said goodbye" over as a request, and the agent hangs up. The voice model itself has no tools.
+*/
+function createEndVoiceCallTool({ end, isActive }) {
+	return defineTool({
+		name: "end_voice_call",
+		description: "End the current voice call. The user is talking to you through a live voice call, so a message that is or ends with a farewell (bye, goodbye, 拜拜, 再见, I am leaving, 先走了) or asks to end the call is a request to end it: call this tool, then say a short goodbye. The words may be rough or have a little more after them. Stopping work, stopping speech or pausing does not end a call. Never call it from a text conversation.",
+		parameters: {},
+		isConcurrencySafe: () => false,
+		async execute(_args, exec) {
+			const sessionId = exec.agent?.id;
+			if (typeof sessionId !== "string" || !isActive(sessionId)) return {
+				ended: false,
+				message: "There is no voice call running in this conversation."
+			};
+			end(sessionId);
+			return {
+				ended: true,
+				message: "The voice call is ending; it closes once the voice has finished speaking. Say a short goodbye."
+			};
+		},
+		output: {
+			schema: {
+				type: "object",
+				additionalProperties: true
+			},
+			render: (_args, value) => [{
+				type: "text",
+				text: value.message
+			}]
+		}
+	});
+}
+/** The desktop voice object, with the end-call tool registered for as long as at least one call is open. */
+function withEndCallTool(desktopVoice, register) {
+	if (!desktopVoice) return desktopVoice;
+	const open = /* @__PURE__ */ new Set();
+	let dispose;
+	const release = (sessionId) => {
+		open.delete(sessionId);
+		if (open.size === 0 && dispose) {
+			dispose();
+			dispose = void 0;
+		}
+	};
+	return Object.freeze({
+		async start(params) {
+			const result = await desktopVoice.start(params);
+			open.add(params.sessionId);
+			dispose ??= register(createEndVoiceCallTool({
+				end: (id) => desktopVoice.end(id),
+				isActive: (id) => desktopVoice.status(id).active
+			}));
+			return result;
+		},
+		stop(sessionId) {
+			const result = desktopVoice.stop(sessionId);
+			release(sessionId);
+			return result;
+		},
+		end: (sessionId) => desktopVoice.end(sessionId),
+		status: (sessionId) => desktopVoice.status(sessionId)
+	});
+}
+//#endregion
 //#region src/index.js
 const z = createRequire(import.meta.resolve("@deepseek-ai/dsh-settings"))("@deepseek-ai/schemastery");
 const name = "codex-subscription";
@@ -10251,25 +11562,28 @@ const REQUEST_IMAGE_MAX_BYTES = 1024 * 1024;
 function createSearchProviderSwitcher(loader) {
 	const webEntry = () => [...loader.entries()].find((entry) => entry.options?.id === WEB_ENTRY_ID);
 	const dshProviderId = () => {
-		const baseConfig = webEntry()?.options?.config ?? {};
-		return typeof baseConfig.searchProvider === "string" && baseConfig.searchProvider.length > 0 ? baseConfig.searchProvider : DSH_SEARCH_PROVIDER_FALLBACK;
-	};
+		const configured = webEntry()?.options?.config?.searchProvider;
+		return typeof configured === "string" && configured.length > 0 ? configured : DSH_SEARCH_PROVIDER_FALLBACK;
+	};
+	const current = () => {
+		const value = webEntry()?.fiber?.config?.searchProvider;
+		return typeof value === "string" ? value : value?.get?.();
+	};
+	const writeProvider = async (provider) => {
+		const entry = webEntry();
+		const fiber = entry?.fiber;
+		if (entry === void 0 || fiber === void 0 || typeof fiber.update !== "function") throw new Error("DSH web runtime is unavailable");
+		if (current() === provider) return;
+		await fiber.update({
+			...entry.options?.config ?? {},
+			searchProvider: provider
+		}, true);
+	};
+	const select = (selection) => writeProvider(selection === "codex" ? CODEX_SEARCH_PROVIDER_ID : selection === "auto" ? CODEX_AUTO_SEARCH_PROVIDER_ID : DSH_ACCOUNT_SEARCH_PROVIDER_ID);
 	return Object.freeze({
 		dshProviderId,
-		async select(selection) {
-			const entry = webEntry();
-			const fiber = entry?.fiber;
-			if (entry === void 0 || fiber === void 0 || typeof fiber.update !== "function") throw new Error("DSH web runtime is unavailable");
-			const baseConfig = entry.options?.config ?? {};
-			const currentConfig = fiber.config ?? baseConfig;
-			const dshProvider = dshProviderId();
-			const provider = selection === "codex" ? CODEX_SEARCH_PROVIDER_ID : selection === "auto" ? CODEX_AUTO_SEARCH_PROVIDER_ID : dshProvider;
-			if (currentConfig.searchProvider === provider) return;
-			await fiber.update({
-				...currentConfig,
-				searchProvider: provider
-			}, true);
-		}
+		current,
+		select
 	});
 }
 const settingsFields = {
@@ -10299,6 +11613,9 @@ const Config = z.object(Object.fromEntries(Object.entries(settingsFields).map(([
 function apply(ctx, config = {}) {
 	const settings = createSettingsAdapter(ctx, config);
 	const searchProvider = createSearchProviderSwitcher(ctx.loader);
+	if (!process.env.NODE_TEST_CONTEXT) diagnosticLog.attach(dshHomePath("state", "codex-subscription", "diagnostic-log.jsonl"));
+	diagnosticLog.info("plugin", `loaded ${PACKAGE_VERSION}`, `DSH ${hostDshVersion() ?? "unknown"}, node ${process.version}, ${process.platform}`);
+	setAuthFailureLogger((message, detail) => diagnosticLog.error("auth", message, detail));
 	const network = createCodexNetworkTransport();
 	const diagnosticOperations = createDiagnosticOperations();
 	ctx.effect(() => ctx.on?.("tools/result", (exec, result) => diagnosticOperations.tool(exec, result)), "codex-subscription: operation evidence");
@@ -10385,6 +11702,9 @@ function apply(ctx, config = {}) {
 				[OUTPUT_VERBOSITY_FIELD]: normalizeOutputVerbosity(settings.get()[OUTPUT_VERBOSITY_FIELD]),
 				[INPUT_IMAGE_DETAIL_FIELD]: normalizeInputImageDetail(settings.get()[INPUT_IMAGE_DETAIL_FIELD]),
 				[REASONING_SUMMARY_FIELD]: normalizeReasoningSummary(settings.get()[REASONING_SUMMARY_FIELD]),
+				[VOICE_CALL_FIELD]: normalizeVoiceCall(settings.get()[VOICE_CALL_FIELD]),
+				[VOICE_VOICE_FIELD]: normalizeVoiceVoice(settings.get()[VOICE_VOICE_FIELD]),
+				[VOICE_LANGUAGE_FIELD]: normalizeVoiceLanguage(settings.get()[VOICE_LANGUAGE_FIELD]),
 				[RETRY_POLICY_FIELD]: normalizeRetryPolicy(settings.get()[RETRY_POLICY_FIELD]),
 				[CONNECTORS_FIELD]: normalizeConnectorMode(settings.get()[CONNECTORS_FIELD]),
 				[STREAM_IDLE_TIMEOUT_MINUTES_FIELD]: normalizeStreamIdleTimeoutMinutes(settings.get()[STREAM_IDLE_TIMEOUT_MINUTES_FIELD]),
@@ -10580,18 +11900,43 @@ function apply(ctx, config = {}) {
 		resolveSessionId: () => currentAgent()?.session.id,
 		fetch: (input, init) => network.fetch("search", input, init)
 	});
-	ctx.web.registerSearchProvider(codexSearch);
+	const searchTrace = (route) => diagnosticLog.info("search", `web search: ${route}`);
+	const tracedCodexSearch = Object.freeze({
+		id: codexSearch.id,
+		available: () => codexSearch.available(),
+		async search(request, signal) {
+			const result = await codexSearch.search(request, signal);
+			searchTrace("answered by Codex subscription");
+			return result;
+		}
+	});
+	ctx.web.registerSearchProvider(tracedCodexSearch);
+	const dshSearch = createDshAccountSearchProvider({
+		report: searchTrace,
+		resolveDshProvider: () => ctx.web.searchProviders?.get(searchProvider.dshProviderId()),
+		resolveAccount: () => ctx.get?.("deepseekAccount"),
+		resolveConfig: () => {
+			const config = [...ctx.loader.entries()].find((entry) => entry.options?.id === "web-deepseek-api")?.options?.config;
+			return config !== null && typeof config === "object" ? config : {};
+		},
+		resolveQuestion: () => {
+			return (currentAgent()?.session.deriveMessages?.() ?? []).findLast((message) => message.role === "user" && message.source?.kind === "user")?.content?.flatMap((block) => block.type === "text" ? [block.text] : []).join(" ");
+		}
+	});
+	ctx.web.registerSearchProvider(dshSearch);
 	ctx.web.registerSearchProvider(createCodexAutoSearchProvider({
-		codex: codexSearch,
+		codex: tracedCodexSearch,
 		resolveModelProvider: () => currentAgent()?.session.requestContext?.()?.provider,
-		resolveDshProvider: () => ctx.web.searchProviders?.get(searchProvider.dshProviderId())
+		resolveDshProvider: () => dshSearch
 	}));
 	ctx.effect(() => {
 		const select = async (value) => {
 			try {
 				await searchProvider.select(value[SEARCH_PROVIDER_FIELD]);
+				diagnosticLog.info("search", `web search source is ${searchProvider.current()}`);
 			} catch (error) {
 				ctx.logger?.warn?.("could not select the configured web search provider: %s", error.message);
+				diagnosticLog.warn("search", "could not select the web search provider", error.message);
 			}
 		};
 		select(settings.get());
@@ -10619,12 +11964,26 @@ function apply(ctx, config = {}) {
 		skills: () => ctx.get?.("skills"),
 		commands: () => ctx.get?.("commands"),
 		llm: () => ctx.llm,
+		speed: {
+			tiers: (provider, model) => provider === PROVIDER ? modelCatalog.metadata(model)?.serviceTiers ?? [] : [],
+			current: () => settings.get()[SPEED_MODE_FIELD],
+			set: (mode) => settings.update({ [SPEED_MODE_FIELD]: mode })
+		},
 		trace: (entry) => {
 			try {
 				remoteControl.host.note(entry);
 			} catch {}
 		},
-		userAgent: USER_AGENT
+		userAgent: USER_AGENT,
+		configFile: dshHomePath("state", "codex-subscription", "remote-config.json"),
+		voice: {
+			WebSocket,
+			fetch: (input, init) => network.fetch("remote", input, init),
+			credentials: (signal) => readSubscriptionCredentials(resolveAuth, (options) => store.read(PROVIDER, {
+				...options,
+				signal
+			}), signal)
+		}
 	});
 	const remoteControl = createRemoteControl({
 		credentials: (signal) => readSubscriptionCredentials(resolveAuth, (options) => store.read(PROVIDER, {
@@ -10634,6 +11993,7 @@ function apply(ctx, config = {}) {
 		WebSocket,
 		fetch: (input, init) => network.fetch("remote", input, init),
 		stateFile: dshHomePath("state", "codex-subscription", "remote-control.json"),
+		debugFile: dshHomePath("state", "codex-subscription", "remote-debug.jsonl"),
 		hostName: `DSH (${hostname()})`,
 		userAgent: USER_AGENT,
 		base: process.env.DSH_CODEX_REMOTE_BASE || void 0,
@@ -10792,6 +12152,15 @@ function apply(ctx, config = {}) {
 		defaultModel,
 		runtimeManagement,
 		remoteControl,
+		desktopVoice: withEndCallTool(remoteBridge.desktopVoice, (tool) => ctx.tools.register(tool)),
+		voicePreview: createVoicePreview({
+			fetch: (input, init) => network.fetch("remote", input, init),
+			credentials: (signal) => readSubscriptionCredentials(resolveAuth, (options) => store.read(PROVIDER, {
+				...options,
+				signal
+			}), signal),
+			userAgent: USER_AGENT
+		}),
 		onAccountChanged: () => {
 			connectorsClient.clear();
 			usageProfileReader.clear();