@xopcai/xopc 0.0.363 → 0.0.364

package/dist/src/personal-agent/reply-style.js

@@ -0,0 +1,14 @@
+//#region src/personal-agent/reply-style.ts
+const PERSONAL_REPLY_STYLE_RULES = [
+	"Understand the user’s last words and what the result means for them before replying. Speak as the same familiar personal assistant throughout the conversation, rather than forwarding an execution report. A natural brief opening is welcome when it connects to what they said; do not mechanically add a greeting, name, reassurance, joke, or question.",
+	"Use a conversational rhythm and concrete language. Start with what the user most needs now, then give enough explanation or detail to use the answer. Do not default to “Task completed”, “Here is the summary”, headings, or checklists. Use lists and tables when they genuinely make the requested information easier to use.",
+	"Synthesis means understanding and organizing, not always shortening. Preserve requested lists, exact text, code, translations, important sources, limitations, and partial failures. Never make an uncertain result sound confirmed just to keep the reply smooth."
+];
+const PERSONAL_REPLY_EXAMPLES = `Examples of presentation, only when the evidence supports the facts:
+Report: “Query complete. Scanned 28 emails and found 3 important items.”
+Conversation: “Three emails are worth looking at first. The contract confirmation is the most urgent: they need your reply today. I’ve included the other two below.”
+Report: “Task failed: connector authorization expired.”
+Conversation: “I couldn’t finish checking the remaining emails because the connection expired. The results already retrieved are below; reconnecting will let us check the rest.”
+These are examples of rhythm, not facts or fixed templates. Match the user’s language and preferences.`;
+//#endregion
+export { PERSONAL_REPLY_EXAMPLES, PERSONAL_REPLY_STYLE_RULES };

package/dist/src/personal-agent/request-delivery.d.ts

@@ -1,4 +1,4 @@
 /** Closed authorization waits retain their feedback marker for restart-safe delivery. */
 export declare function drainPersonalRequestContinuations(notify?: (conversationId: string, requestId: string) => void): void;
-/** The request itself is the durable outbox; append and delivery marker commit together. */
+/** Stage personal results in the shared delivery outbox; legacy requests retain their own delivery marker. */
 export declare function drainPersonalRequestResults(notify?: (conversationId: string, requestId: string) => void): void;

package/dist/src/personal-agent/request-delivery.js

@@ -9,7 +9,9 @@ import { getPersonalRequest, init_request_repository, updatePersonalRequest } fr
 import { appendTranscriptEntry, init_transcript_repository, loadLlmMessagesForSession } from "../storage/sqlite/transcript-repository.js";
 import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
 import { emitSessionTranscriptUpdate } from "../session/transcript-events.js";
+import { getPersonalAgentByConversation } from "./repository.js";
 import { PersonalRequestResultSchema, renderPersonalRequestResult } from "./request-result.js";
+import { enqueuePersonalReply } from "./reply-composer.js";
 //#region src/personal-agent/request-delivery.ts
 init_src();
 init_transaction();
@@ -66,7 +68,7 @@ function drainPersonalRequestContinuations(notify) {
 		}, "Connection continuation feedback will retry");
 	}
 }
-/** The request itself is the durable outbox; append and delivery marker commit together. */
+/** Stage personal results in the shared delivery outbox; legacy requests retain their own delivery marker. */
 function drainPersonalRequestResults(notify) {
 	const db = getSqliteDatabase();
 	const rows = db.prepare(`SELECT request_id, delivery_attempts FROM personal_requests request WHERE task_id IS NOT NULL
@@ -75,6 +77,7 @@ function drainPersonalRequestResults(notify) {
       AND run.status IN ('succeeded','failed','cancelled')
       AND NOT EXISTS (SELECT 1 FROM task_runs newer WHERE newer.task_id = run.task_id
         AND newer.parent_run_id IS NULL AND newer.queued_at > run.queued_at))
+    AND NOT EXISTS (SELECT 1 FROM task_result_deliveries delivery WHERE json_extract(delivery.reply_payload_json, '$.requestId') = request.request_id)
     ORDER BY created_at LIMIT 50`).all(Date.now());
 	for (const row of rows) try {
 		const request = getPersonalRequest(row.request_id);
@@ -98,7 +101,7 @@ function drainPersonalRequestResults(notify) {
 			const parsed = stored.result_json && stored.result_run_id === run.id ? PersonalRequestResultSchema.safeParse(JSON.parse(stored.result_json)) : void 0;
 			const assistant = (run.conversationId ? loadLlmMessagesForSession(run.conversationId) : []).filter((message) => message.role === "assistant").at(-1);
 			const fallback = assistant?.role === "assistant" ? assistant.content.filter((part) => part.type === "text").map((part) => part.text).join("\n").trim() : "";
-			const content = parsed?.success ? renderPersonalRequestResult(parsed.data) : fallback && fallback !== "NO_REPLY" ? fallback.slice(0, 16e3) : receipt?.summary ?? "Request finished without a readable result.";
+			const content = parsed?.success ? renderPersonalRequestResult(parsed.data) : fallback && fallback !== "NO_REPLY" ? fallback.slice(0, 16e3) : receipt?.summary?.trim() || "Request finished without a readable result.";
 			const failed = run.status !== "succeeded";
 			const display = failed ? `查询未完成。\n\n${content}` : content;
 			const now = Date.now();
@@ -125,7 +128,18 @@ function drainPersonalRequestResults(notify) {
 				},
 				createdAt: now
 			});
-			const entry = appendTranscriptEntry(request.conversationId, {
+			const personal = getPersonalAgentByConversation(request.conversationId);
+			if (personal) enqueuePersonalReply({
+				delivery,
+				objective: request.objective,
+				requestId: request.requestId,
+				report: parsed?.success ? parsed.data.summary : content,
+				...parsed?.success ? { preservedText: renderPersonalRequestResult({
+					...parsed.data,
+					summary: ""
+				}).trim() } : {}
+			});
+			const entry = personal ? void 0 : appendTranscriptEntry(request.conversationId, {
 				role: "custom",
 				customType: TASK_RESULT_DELIVERY_TYPE,
 				content: display,
@@ -134,7 +148,7 @@ function drainPersonalRequestResults(notify) {
 				timestamp: now
 			});
 			updatePersonalRequest(request, { state: run.status === "cancelled" ? "cancelled" : failed ? "failed" : "completed" });
-			db.prepare("UPDATE personal_requests SET delivery_entry_id = ? WHERE request_id = ?").run(entry.entry_id, request.requestId);
+			if (entry) db.prepare("UPDATE personal_requests SET delivery_entry_id = ? WHERE request_id = ?").run(entry.entry_id, request.requestId);
 			db.prepare(`UPDATE task_main_update_deliveries SET status = 'delivered', decision = 'silent',
           decision_reason = 'Personal request result delivered', updated_at = ? WHERE entry_id IN
           (SELECT entry_id FROM task_collaboration_entries WHERE task_run_id = ? AND kind IN ('result','failure','progress'))`).run(now, run.id);

package/dist/src/personal-agent/request-service.js

@@ -126,7 +126,7 @@ function startPersonalRequest(request, accountId) {
 		`Selected connector: ${request.connectorId}; xopcAccountId: ${accountId}.`,
 		`Preserved query parameters: ${JSON.stringify(request.parameters)}.`,
 		"Search and describe the external tools before executing read-only operations. Deliver results to the originating chat through the Task result. Do not claim no important mail if the query was incomplete."
-	].join("\n\n")}\n\n${PERSONAL_WORKER_RESULT_GUIDANCE}\n\nBefore finishing, call personal_request_result with the verified summary and, for mail, message items and coverage. The host delivers it directly to the main chat.`;
+	].join("\n\n")}\n\n${PERSONAL_WORKER_RESULT_GUIDANCE}\n\nBefore finishing, call personal_request_result with the verified summary and, for mail, message items and coverage. The host composes the final explanation and preserves structured items in the main chat.`;
 	const result = new TaskApplicationService().create(TaskCreateRequestSchema.parse({
 		idempotencyKey: `personal-request:${request.requestId}`,
 		title: request.objective.slice(0, 60),

package/dist/src/personal-agent/service.js

@@ -4,13 +4,14 @@ import { init_config_repository, setSessionConfig } from "../storage/sqlite/conf
 import { ResponsePreferencesSchema } from "../agent-config/schema.js";
 import { init_agent_config } from "../agent-config/index.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { createConversation, init_conversation_repository } from "../storage/sqlite/conversation-repository.js";
 import { getAvailableModels, init_providers } from "../providers/index.js";
 import { DEFAULT_PERSONAL_PREFERENCES, getPersonalAgent, personalAgentId } from "./repository.js";
 import { getModelThinking } from "../providers/model-thinking.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { PERSONAL_COMMUNICATION_RULES, PERSONAL_RELIABILITY_RULES } from "./communication.js";
 import { PERSONAL_MAIN_TOOL_IDS } from "./policy.js";
+import { PERSONAL_REPLY_EXAMPLES, PERSONAL_REPLY_STYLE_RULES } from "./reply-style.js";
 import { completePersonalOnboarding } from "./onboarding.js";
 import { z } from "zod";
 //#region src/personal-agent/service.ts
@@ -67,6 +68,8 @@ function personalInstructions(preferences) {
 		RESULT_DELIVERY_RULE,
 		...PERSONAL_COMMUNICATION_RULES,
 		...PERSONAL_RELIABILITY_RULES,
+		...PERSONAL_REPLY_STYLE_RULES,
+		PERSONAL_REPLY_EXAMPLES,
 		"When creating a Task, provide a short title that names the work, a one-sentence objective, and a Markdown description with all detailed instructions. Keep the title free of checklists and long background. Preserve user requirements in the description.",
 		"Adapt to the user’s current words first, then their saved preferences. If the user explicitly changes how they want you to respond in future, save it with personal_preference. Do not infer a lasting emotional trait from one conversation or claim human feelings or experiences.",
 		"Give the accurate answer or next step in the order this user prefers. Acknowledge feelings only when relevant, without guessing how the user feels. Avoid formulaic reassurance, praise, pet names, emojis, or jokes unless the user welcomes them and the moment fits. Be accurate about task state, evidence, and uncertainty."
@@ -117,7 +120,12 @@ async function refreshPersonalDelegationGuidance(service, ownerId) {
 	if (!nextInstructions.includes(LOCAL_READ_RULE)) nextInstructions += `\n${LOCAL_READ_RULE}`;
 	if (!nextInstructions.includes(RESULT_DELIVERY_RULE)) nextInstructions += `\n${RESULT_DELIVERY_RULE}`;
 	if (!nextInstructions.includes(CONNECTED_APP_RULE)) nextInstructions += `\n${CONNECTED_APP_RULE}`;
-	for (const rule of [...PERSONAL_COMMUNICATION_RULES, ...PERSONAL_RELIABILITY_RULES]) if (!nextInstructions.includes(rule)) nextInstructions += `\n${rule}`;
+	for (const rule of [
+		...PERSONAL_COMMUNICATION_RULES,
+		...PERSONAL_RELIABILITY_RULES,
+		...PERSONAL_REPLY_STYLE_RULES,
+		PERSONAL_REPLY_EXAMPLES
+	]) if (!nextInstructions.includes(rule)) nextInstructions += `\n${rule}`;
 	const toolAllowlist = agent.toolAllowlist?.includes("personal_task") ? [...new Set([...agent.toolAllowlist, ...PERSONAL_MAIN_TOOL_IDS])] : agent.toolAllowlist;
 	if (nextInstructions === instructions && JSON.stringify(toolAllowlist) === JSON.stringify(agent.toolAllowlist)) return;
 	try {

package/dist/src/storage/sqlite/migrations/234_task_result_reply.sql

@@ -0,0 +1,14 @@
+-- Keep artifact delivery and final prose in one durable outbox with independent progress.
+ALTER TABLE task_result_deliveries ADD COLUMN reply_payload_json TEXT;
+ALTER TABLE task_result_deliveries ADD COLUMN reply_status TEXT CHECK(reply_status IN ('pending','generating','ready','delivered','stale'));
+ALTER TABLE task_result_deliveries ADD COLUMN reply_lease_token TEXT;
+ALTER TABLE task_result_deliveries ADD COLUMN reply_lease_until INTEGER NOT NULL DEFAULT 0;
+ALTER TABLE task_result_deliveries ADD COLUMN reply_text TEXT;
+ALTER TABLE task_result_deliveries ADD COLUMN reply_draft_transcript_id TEXT;
+ALTER TABLE task_result_deliveries ADD COLUMN reply_message_entry_id TEXT;
+ALTER TABLE task_result_deliveries ADD COLUMN reply_notified_at INTEGER;
+ALTER TABLE task_result_deliveries ADD COLUMN reply_attempts INTEGER NOT NULL DEFAULT 0;
+ALTER TABLE task_result_deliveries ADD COLUMN reply_next_attempt_at INTEGER NOT NULL DEFAULT 0;
+ALTER TABLE task_result_deliveries ADD COLUMN reply_last_error TEXT;
+
+CREATE INDEX idx_task_result_reply_pending ON task_result_deliveries(reply_status, reply_next_attempt_at, reply_lease_until);

package/dist/src/storage/sqlite/migrations/runner.d.ts

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 165;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 233;
+export declare const XOPC_DB_SCHEMA_VERSION = 234;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

package/dist/src/storage/sqlite/migrations/runner.js

@@ -57,7 +57,7 @@ function applySingleMigration(db, migration, discardOldScenes = false) {
 */
 function applyPendingMigrations(db, options = {}) {
 	db.function("xopc_operation_id", () => currentOperationId() ?? null);
-	const targetVersion = options.targetVersion ?? 233;
+	const targetVersion = options.targetVersion ?? 234;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (!options.migrationsDir && currentVersion < 165) throw new DatabaseSchemaTooOldError(currentVersion, 165);
@@ -95,7 +95,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 233;
+	const appVersion = options.targetVersion ?? 234;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,
@@ -137,7 +137,7 @@ var init_runner = __esmMin((() => {
 	init_errors();
 	log = createLogger("Sqlite:Migrations");
 	XOPC_DB_BASELINE_SCHEMA_VERSION = 165;
-	XOPC_DB_SCHEMA_VERSION = 233;
+	XOPC_DB_SCHEMA_VERSION = 234;
 }));
 //#endregion
 init_runner();

package/dist/src/storage/sqlite/schema.js

@@ -28,7 +28,7 @@ function ensureXopcDatabaseSchema(db, options = {}) {
 		currentVersion = 165;
 	}
 	applyPendingMigrations(db, {
-		targetVersion: 233,
+		targetVersion: 234,
 		databasePath: fresh ? void 0 : options.databasePath
 	});
 }

package/dist/src/tasks/capabilities/read.js

@@ -2,10 +2,10 @@ import { ProductReadContracts } from "../../../packages/gateway-contract/src/cap
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { TaskRepository, init_task_repository } from "../task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../task-run-repository.js";
-import { TaskConversationRepository } from "../task-conversation-repository.js";
-import { TaskReadModelProjector } from "../task-read-model-projector.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { defineReadCapability } from "../../capabilities/runtime/dispatcher.js";
+import { TaskConversationRepository } from "../task-conversation-repository.js";
+import { TaskReadModelProjector } from "../task-read-model-projector.js";
 import { TaskContextRepository } from "../task-context-repository.js";
 import { TaskDependencyService } from "../task-dependency-service.js";
 import { TaskCriterionReviewRepository } from "../task-criterion-review-repository.js";

package/dist/src/tasks/task-result-delivery-service.js

@@ -3,19 +3,25 @@ import { init_logger } from "../utils/logger.js";
 import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { TaskResultDeliverySchema } from "../../packages/gateway-contract/src/task-result-delivery.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
+import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
+import { init_request_repository, personalRequestForTask } from "../personal-agent/request-repository.js";
 import { appendTranscriptEntry, init_transcript_repository } from "../storage/sqlite/transcript-repository.js";
 import { TaskConversationRepository } from "./task-conversation-repository.js";
 import { tryParseMediaUri } from "../media/uri.js";
 import { resolveMediaBufferPath } from "../media/store.js";
 import { emitSessionTranscriptUpdate } from "../session/transcript-events.js";
+import { getPersonalAgentByConversation } from "../personal-agent/repository.js";
 import { TaskResultDeliveryRepository } from "./task-result-delivery-repository.js";
+import { enqueuePersonalReply } from "../personal-agent/reply-composer.js";
 import { lstat } from "node:fs/promises";
 //#region src/tasks/task-result-delivery-service.ts
 init_src();
 init_transcript_repository();
 init_transaction();
 init_logger();
+init_request_repository();
+init_task_repository();
 init_task_run_repository();
 const log = createLogger("TaskResultDelivery");
 async function materializedArtifact(item) {
@@ -86,21 +92,31 @@ var TaskResultDeliveryService = class {
 						status: deliverables.length > 0 && available === 0 ? "failed" : available < deliverables.length ? "partial" : delivery.outcome.status
 					};
 					const statusText = db.prepare("SELECT locale FROM tasks WHERE task_id = ?").get(delivery.taskId).locale?.startsWith("zh") === true ? `${delivery.taskTitle}：${available === deliverables.length ? "成果已生成" : available > 0 ? "部分成果已生成" : "成果暂不可用"}。` : `${delivery.taskTitle}: ${available === deliverables.length ? "Results ready" : available > 0 ? "Partial results ready" : "Results unavailable"}.`;
-					const content = delivery.text ? `${statusText}\n\n${delivery.text}` : statusText;
+					const personal = getPersonalAgentByConversation(delivery.conversationId);
+					if (personal && !personalRequestForTask(delivery.taskId)) enqueuePersonalReply({
+						delivery: {
+							...delivery,
+							outcome
+						},
+						report: delivery.text?.trim() || delivery.outcome.summary?.trim() || statusText,
+						objective: new TaskRepository().get(delivery.taskId)?.contract?.objective ?? delivery.taskTitle
+					});
+					const content = personal ? statusText : delivery.text ? `${statusText}\n\n${delivery.text}` : statusText;
 					const details = {
 						...delivery,
 						outcome
 					};
-					const entry = appendTranscriptEntry(delivery.conversationId, {
+					if (personal) delete details.text;
+					const entry = !personal || deliverables.length ? appendTranscriptEntry(delivery.conversationId, {
 						role: "custom",
 						customType: "task_result_delivery",
 						content,
 						display: true,
 						details,
 						timestamp: Date.now()
-					});
+					}) : void 0;
 					db.prepare(`UPDATE task_result_deliveries SET status = 'delivered', payload_json = ?,
-              message_entry_id = ?, delivered_at = ? WHERE delivery_id = ?`).run(JSON.stringify(details), entry.entry_id, Date.now(), row.delivery_id);
+              message_entry_id = ?, delivered_at = ? WHERE delivery_id = ?`).run(JSON.stringify(details), entry?.entry_id ?? null, Date.now(), row.delivery_id);
 					return true;
 				})) continue;
 			}

package/dist/src/tui/backends/embedded-backend.js

@@ -10,6 +10,7 @@ import { getSessionMetadata } from "../../storage/sqlite/session-read-repository
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import { normalizeAgentId } from "../../agent-catalog/id.js";
 import { init_agent_scope, listAgentEntries } from "../../agent/agent-scope.js";
+import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { init_paths } from "../../config/paths.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { init_agent_session_key, resolveAgentIdFromConversationId } from "../../routing/agent-session-key.js";
@@ -22,7 +23,6 @@ import { buildSessionTimeline } from "../../session/transcript-outline.js";
 import { transcriptRowsToClientHistory } from "../../session/client-history.js";
 import { createCreateShareTool, isShareToolAvailable } from "../../agent/tools/create-share-tool.js";
 import { evictEmbeddedSessionRunner } from "../../agent/embedded/session-runner.js";
-import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { SessionIndex } from "../../session/manager.js";
 import "../../session/index.js";
 import { parseModelRef } from "../../agent/models/selection.js";

package/dist/src/voice/realtime/agentBroker.js

@@ -70,7 +70,12 @@ var DurableVoiceAgentBroker = class {
 		return {
 			taskId: row.id,
 			runId,
-			events: this.events(row.id, runId, afterSeq, input.signal)
+			events: this.events(row.id, runId, afterSeq, input.signal, [
+				"completed",
+				"cancelled",
+				"failed",
+				"interrupted"
+			].includes(row.status))
 		};
 	}
 	async cancel(taskId) {
@@ -80,7 +85,7 @@ var DurableVoiceAgentBroker = class {
 		this.runByTask.delete(taskId);
 		return true;
 	}
-	async *events(taskId, runId, afterSeq, signal) {
+	async *events(taskId, runId, afterSeq, signal, ended) {
 		const queued = [];
 		let wake;
 		const push = (event) => {
@@ -96,6 +101,10 @@ var DurableVoiceAgentBroker = class {
 		};
 		signal.addEventListener("abort", abort, { once: true });
 		try {
+			if (ended && !subscription.initial.some((delivery) => {
+				const event = eventData(delivery);
+				return event?.type === "run_end" || event?.type === "stream_end";
+			})) throw new Error("Completed voice task event history is unavailable");
 			while (!signal.aborted) {
 				if (!queued.length) await new Promise((resolve) => {
 					wake = resolve;

package/dist/src/voice/realtime/agentEngine.js

@@ -3,7 +3,7 @@ import { init_logger } from "../../utils/logger.js";
 import { speakStream } from "../tts/speak-core.js";
 import { AudioPlaybackWindow } from "./audio-playback-window.js";
 import { TurnCoordinator } from "./turnPolicy.js";
-import { isLikelyPlaybackEcho } from "./playback-echo.js";
+import { PlaybackEchoCandidates } from "./playback-echo.js";
 import { PcmFrameBuffer } from "./pcmFrameBuffer.js";
 import { SpeakableSegmenter } from "./speakable-segmenter.js";
 import crypto from "node:crypto";
@@ -36,6 +36,7 @@ function createAgentVoiceEngine(options) {
 	let finalCount = 0;
 	let committing = false;
 	let recentPlayback;
+	const echoCandidates = new PlaybackEchoCandidates();
 	const finalizedUtterances = /* @__PURE__ */ new Set();
 	let pendingTurn;
 	let taskUpdateQueued = false;
@@ -89,6 +90,11 @@ function createAgentVoiceEngine(options) {
 	function cancelActiveResponse(reason) {
 		const response = activeResponse;
 		if (!response) return false;
+		if (response.audioStarted && response.audibleText) recentPlayback = {
+			responseId: response.id,
+			text: response.audibleText,
+			expiresAt: Date.now() + PLAYBACK_ECHO_TAIL_MS
+		};
 		activeResponse = void 0;
 		response.abortController.abort(reason);
 		send("response.cancelled", {
@@ -267,13 +273,11 @@ function createAgentVoiceEngine(options) {
 				conversationId: claim.request.conversationId,
 				expectedTranscriptId: claim.conversationSessionId,
 				signal: response.abortController.signal,
-				...updateClientMessageId ? {
-					clientMessageId: updateClientMessageId,
-					origin: {
-						type: "system",
-						source: "task_update"
-					}
-				} : {}
+				clientMessageId: updateClientMessageId ?? `voice:${claim.conversationSessionId}:${claim.sessionId}:${inputGeneration}:${turnId}`,
+				...updateClientMessageId ? { origin: {
+					type: "system",
+					source: "task_update"
+				} } : {}
 			});
 			response.taskId = task.taskId;
 			send("task.created", {
@@ -438,6 +442,7 @@ function createAgentVoiceEngine(options) {
 		if (event.type === "ready" || event.type === "usage") return;
 		if (event.type === "error") {
 			turn.reset();
+			echoCandidates.clear();
 			log.warn({
 				err: event.error,
 				sessionId: claim.sessionId,
@@ -454,6 +459,7 @@ function createAgentVoiceEngine(options) {
 		if (muted || finalizedUtterances.has(event.utteranceId)) return;
 		if (event.type === "speech_started") {
 			lastUserSpeechAt = Date.now();
+			echoCandidates.remember(event.utteranceId, activeResponse?.audioStarted ? activeResponse.audibleText : recentPlayback && recentPlayback.expiresAt >= Date.now() ? recentPlayback.text : void 0);
 			if (claim.request.purpose === "conversation") {
 				if (pendingTurn) {
 					pendingTurn.cancelled = true;
@@ -490,11 +496,11 @@ function createAgentVoiceEngine(options) {
 				responseId: activeResponse.id,
 				text: activeResponse.audibleText
 			} : recentPlayback && recentPlayback.expiresAt >= Date.now() ? recentPlayback : void 0;
-			if (claim.request.purpose === "conversation" && playback && isLikelyPlaybackEcho(text, playback.text)) {
+			if (claim.request.purpose === "conversation" && echoCandidates.matches(event.utteranceId, text, playback?.text)) {
 				bufferFinal(event.utteranceId, "");
 				log.debug({
 					sessionId: claim.sessionId,
-					responseId: playback.responseId,
+					responseId: playback?.responseId,
 					transcriptCharacters: text.length
 				}, "Ignored finalized transcription matching recent voice playback");
 				return;
@@ -517,6 +523,7 @@ function createAgentVoiceEngine(options) {
 	}
 	function discardInput() {
 		turn.reset();
+		echoCandidates.clear();
 		pendingTurn = void 0;
 		inputGeneration += 1;
 		queuedTurns = 0;
@@ -623,6 +630,7 @@ function createAgentVoiceEngine(options) {
 			if (closing) return closing;
 			closed = true;
 			turn.reset();
+			echoCandidates.clear();
 			cancelActiveResponse("session_closed");
 			sttAbort.abort("session_closed");
 			sttSession?.abort("session_closed");

package/dist/src/voice/realtime/omniEngine.js

@@ -2,7 +2,7 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { AudioPlaybackWindow } from "./audio-playback-window.js";
 import { TurnCoordinator } from "./turnPolicy.js";
-import { isLikelyPlaybackEcho } from "./playback-echo.js";
+import { PlaybackEchoCandidates } from "./playback-echo.js";
 import { PcmFrameBuffer } from "./pcmFrameBuffer.js";
 import crypto from "node:crypto";
 import WebSocket from "ws";
@@ -45,6 +45,7 @@ function createOmniVoiceEngine(options) {
 	let failed = false;
 	let platformRequestId;
 	let active;
+	const echoCandidates = new PlaybackEchoCandidates();
 	let recentPlayback;
 	let waitingForCancellation;
 	let responseCreateQueued = false;
@@ -147,6 +148,10 @@ function createOmniVoiceEngine(options) {
 	const cancel = (reason) => {
 		const response = active;
 		if (!response) return false;
+		if (response.audio && response.text) recentPlayback = {
+			text: response.text,
+			expiresAt: Date.now() + PLAYBACK_ECHO_TAIL_MS
+		};
 		active = void 0;
 		response.abort.abort(reason);
 		response.release();
@@ -234,6 +239,7 @@ function createOmniVoiceEngine(options) {
 		failed = true;
 		clearTimeout(responseStartTimer);
 		turn.reset();
+		echoCandidates.clear();
 		responseCreateQueued = false;
 		log.warn({
 			sessionId: options.callId,
@@ -259,6 +265,7 @@ function createOmniVoiceEngine(options) {
 	function discardInput() {
 		clearTimeout(responseStartTimer);
 		turn.reset();
+		echoCandidates.clear();
 		responseCreateQueued = false;
 		speaking.clear();
 		turnSettled = false;
@@ -358,6 +365,7 @@ function createOmniVoiceEngine(options) {
 								return;
 							}
 							if (recorded.has(String(event.item_id)) || pendingInputs.has(String(event.item_id))) return;
+							echoCandidates.remember(String(event.item_id), active?.audio ? active.text : recentPlayback && recentPlayback.expiresAt >= Date.now() ? recentPlayback.text : void 0);
 							inputBlocked = false;
 							pendingInputs.add(String(event.item_id));
 							clearTimeout(responseStartTimer);
@@ -381,7 +389,7 @@ function createOmniVoiceEngine(options) {
 							speaking.delete(event.item_id);
 							const text = event.transcript.trim();
 							const playbackText = active?.audio ? active.text : recentPlayback && recentPlayback.expiresAt >= Date.now() ? recentPlayback.text : void 0;
-							if (playbackText && isLikelyPlaybackEcho(text, playbackText)) {
+							if (echoCandidates.matches(event.item_id, text, playbackText)) {
 								turn.final(event.item_id, "");
 								log.debug({
 									sessionId: options.callId,
@@ -582,6 +590,7 @@ function createOmniVoiceEngine(options) {
 			clearTimeout(uploadTimer);
 			clearTimeout(responseStartTimer);
 			turn.reset();
+			echoCandidates.clear();
 			speaking.clear();
 			inputQueue = [];
 			queuedInputBytes = 0;

package/dist/src/voice/realtime/persona-context.js

@@ -1,6 +1,6 @@
 import { init_agent_scope, resolveAgentProfileDir } from "../../agent/agent-scope.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { DEFAULT_SOUL_FILENAME } from "../../agent/context/workspace.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { loadProfileBootstrapFiles } from "../../agent/bootstrap/load-bootstrap-files.js";
 import { join } from "node:path";
 import { statSync } from "node:fs";

package/dist/src/voice/realtime/playback-echo.d.ts

@@ -1,2 +1,9 @@
 /** Conservatively identifies finalized ASR that is already in audible assistant output. */
 export declare function isLikelyPlaybackEcho(transcript: string, assistantText: string): boolean;
+/** Retains the playback at speech onset while a provider finishes delayed ASR. */
+export declare class PlaybackEchoCandidates {
+    private readonly candidates;
+    remember(utteranceId: string, text: string | undefined): void;
+    matches(utteranceId: string, transcript: string, currentPlayback?: string): boolean;
+    clear(): void;
+}

package/dist/src/voice/realtime/playback-echo.js

@@ -28,5 +28,27 @@ function isLikelyPlaybackEcho(transcript, assistantText) {
 	if (heard.length < (containsCjk ? 6 : 10)) return false;
 	return closestSubstringEditDistance(heard, spoken) / Array.from(heard).length <= .22;
 }
+/** Retains the playback at speech onset while a provider finishes delayed ASR. */
+var PlaybackEchoCandidates = class {
+	candidates = /* @__PURE__ */ new Map();
+	remember(utteranceId, text) {
+		if (!text || this.candidates.has(utteranceId)) return;
+		const now = Date.now();
+		for (const [id, candidate] of this.candidates) if (candidate.expiresAt < now) this.candidates.delete(id);
+		if (this.candidates.size >= 256) this.candidates.delete(this.candidates.keys().next().value);
+		this.candidates.set(utteranceId, {
+			text: text.slice(-8e3),
+			expiresAt: now + 3e4
+		});
+	}
+	matches(utteranceId, transcript, currentPlayback) {
+		const candidate = this.candidates.get(utteranceId);
+		this.candidates.delete(utteranceId);
+		return Boolean(currentPlayback && isLikelyPlaybackEcho(transcript, currentPlayback) || candidate && candidate.expiresAt >= Date.now() && isLikelyPlaybackEcho(transcript, candidate.text));
+	}
+	clear() {
+		this.candidates.clear();
+	}
+};
 //#endregion
-export { isLikelyPlaybackEcho };
+export { PlaybackEchoCandidates, isLikelyPlaybackEcho };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.363",
+  "version": "0.0.364",
   "description": "Local-first personal AI for the one-person company, with durable context, tasks, workflows, automations, and local or cloud models.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -161,12 +161,12 @@
     "vitepress": "^1.6.4",
     "vitest": "4.1.5",
     "vue": "^3.5.35",
-    "@xopcai/computer-control-contract": "0.1.0",
+    "@xopcai/browser-control-contract": "0.1.0",
     "@xopcai/endpoint-tools-client": "0.0.0",
     "@xopcai/endpoint-tools-protocol": "0.0.0",
-    "@xopcai/browser-control-contract": "0.1.0",
-    "@xopcai/gateway-contract": "0.0.0",
+    "@xopcai/computer-control-contract": "0.1.0",
     "@xopcai/realtime-client": "0.0.0",
+    "@xopcai/gateway-contract": "0.0.0",
     "@xopcai/realtime-protocol": "0.0.0"
   },
   "scripts": {

package/dist/gateway/static/root/assets/settings-advanced-gate-DRc9IDJf.js

@@ -1 +0,0 @@
-import{hn as e}from"./index-BYNmHn-z.js";function t(t){let{children:n,fallback:r}=t,i=r===void 0?null:r;return e()?n:i}export{t};