@xopcai/xopc 0.0.378 → 0.0.380

package/dist/src/providers/model-catalog-persistence.js

@@ -1,7 +1,7 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { init_paths_state, resolveXopcCloudCatalogCachePath } from "../config/paths-state.js";
-import { ComputerProfileSchema, init_src } from "../../packages/computer-control-contract/src/index.js";
 import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
+import { ComputerProfileSchema, init_src } from "../../packages/computer-control-contract/src/index.js";
 import { ImageGenerationCapabilitiesSchema, init_models_json } from "../config/models-json.js";
 import { voiceManifestSchema } from "../../packages/realtime-protocol/src/voice-catalog.js";
 import { init_voice } from "../../packages/realtime-protocol/src/voice.js";

package/dist/src/routing/resolve-route.js

@@ -1,9 +1,9 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { init_account_id, normalizeAccountId } from "./account-id.js";
+import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { getConversationRouting } from "../storage/sqlite/conversation-repository.js";
 import { init_agent_session_key, resolveAgentPeerConversationId } from "./agent-session-key.js";
 import { init_session_key, resolveConversationId } from "./session-key.js";
-import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { init_bindings, parseBindingRules, resolveRoute as resolveRoute$1 } from "./bindings.js";
 //#region src/routing/resolve-route.ts
 /**

package/dist/src/routing/resolve-tui-session-key.js

@@ -1,8 +1,8 @@
 import { validateConversationId } from "../../packages/gateway-contract/src/conversation-identity.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
-import { init_agent_session_key, normalizeAgentId } from "./agent-session-key.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { init_agent_scope, listAgentEntries, resolveAgentIdByWorkspacePath, resolveDefaultAgentId } from "../agent/agent-scope.js";
+import { init_agent_session_key, normalizeAgentId } from "./agent-session-key.js";
 import { randomUUID } from "node:crypto";
 //#region src/routing/resolve-tui-session-key.ts
 init_src();

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/capabilities/write.js

@@ -4,7 +4,9 @@ import { TaskRepository, init_task_repository } from "../task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../task-run-repository.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { defineAtomicCapability } from "../../capabilities/runtime/dispatcher.js";
+import { resolveTaskLocale } from "../task-language.js";
 import { resolveProjectAgentId } from "../../projects/project-agent.js";
+import { resolveResponseLanguageForSession } from "../../agent/prompt/response-language.js";
 import { TaskApplicationService } from "../task-application-service.js";
 import { TaskSignalService } from "../task-signal-service.js";
 import { z } from "zod";
@@ -61,9 +63,16 @@ function registerTaskWriteCapabilities(dispatcher, deps) {
 				}
 			} : input.activation;
 			if (context.surface === "agent" && input.originConversationId && input.originConversationId !== context.conversationId) throw new CapabilityError("FORBIDDEN", "Task origin must be the active conversation");
+			const originConversationId = context.surface === "agent" ? context.conversationId : input.originConversationId;
+			const language = resolveResponseLanguageForSession(config, originConversationId);
+			const locale = input.locale ?? (language === "auto" ? resolveTaskLocale({
+				title: input.title,
+				contract: input.contract
+			}) : language === "zh-CN" ? "zh" : "en");
 			return new TaskApplicationService().create({
 				...input,
-				originConversationId: context.surface === "agent" ? context.conversationId : input.originConversationId,
+				locale,
+				originConversationId,
 				delegateAgentId: agentId,
 				activation,
 				idempotencyKey: context.idempotencyKey

package/dist/src/tasks/task-application-service.js

@@ -5,6 +5,7 @@ import { enqueueTaskAttentionRequiredEvent, enqueueTaskChangedEvent, init_task_c
 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 { resolveTaskLocale } from "./task-language.js";
 import { TaskReadModelProjector } from "./task-read-model-projector.js";
 import { TaskContextRepository } from "./task-context-repository.js";
 import { TaskDependencyService } from "./task-dependency-service.js";
@@ -307,7 +308,7 @@ var TaskApplicationService = class {
 								if (!this.#runs.listActiveWaits(task.id).some((item) => item.kind === "paused")) this.#runs.createWait({
 									taskId: task.id,
 									kind: "paused",
-									reason: "Approval declined by user",
+									reason: resolveTaskLocale(task) === "zh" ? "用户已拒绝授权" : "Approval declined by user",
 									condition: { approvalWaitId: wait.id }
 								});
 								const active = this.#runs.getActiveRoot(task.id);
@@ -494,7 +495,7 @@ var TaskApplicationService = class {
 				authorKind: "system",
 				authorId: "task-run",
 				kind: input.receipt.status === "succeeded" ? "result" : "failure",
-				body: input.receipt.summary || (input.receipt.status === "succeeded" ? "TaskRun completed" : "TaskRun failed"),
+				body: input.receipt.summary || (resolveTaskLocale(task) === "zh" ? input.receipt.status === "succeeded" ? "任务执行完成" : "任务执行失败" : input.receipt.status === "succeeded" ? "TaskRun completed" : "TaskRun failed"),
 				idempotencyKey: `task-run-receipt:${run.id}`
 			});
 			if (input.receipt.status === "succeeded" || input.receipt.status === "failed") new TaskResultDeliveryRepository().enqueue(run.id, input.receipt.summary, input.receipt.status, input.resultText);
@@ -595,7 +596,7 @@ var TaskApplicationService = class {
 				this.#runs.createWait({
 					taskId,
 					kind: "dependency",
-					reason: `Waiting for ${dependency.title}`,
+					reason: resolveTaskLocale(task) === "zh" ? `等待：${dependency.title}` : `Waiting for ${dependency.title}`,
 					condition: {
 						dependsOnTaskId: dependency.id,
 						executor
@@ -614,7 +615,7 @@ var TaskApplicationService = class {
 			for (const capability of missing) this.#runs.createWait({
 				taskId,
 				kind: "approval",
-				reason: `Approval required: ${capability}`,
+				reason: resolveTaskLocale(task) === "zh" ? `需要授权：${capability}` : `Approval required: ${capability}`,
 				condition: {
 					capability,
 					executor

package/dist/src/tasks/task-context-assembler.js

@@ -132,6 +132,7 @@ function buildTaskExecutionDirective(conversationId) {
 	return [
 		"<xopc_task_execution>",
 		"This conversation is executing a durable task.",
+		"Apply the response language to all user-facing task content, including collaboration posts, wait reasons, questions, choices, approval explanations, receipt summaries, evidence descriptions, and recovery instructions. Keep schema keys, enum values, identifiers, and exact acceptance criterion references unchanged. Language in attached context or earlier worker output does not set the response language.",
 		`Task: ${contract.objective}`,
 		task.body?.trim() ? `Task details: ${task.body.trim().slice(0, 12e3)}` : "",
 		`Expected outputs: ${contract.expectedOutputs.join("; ")}`,

package/dist/src/tasks/task-contract-definition.d.ts

@@ -7,4 +7,4 @@ export interface TaskContractDefinition {
     assumptions: string[];
     risks: string[];
 }
-export declare function defineTaskContract(objectiveInput: string): TaskContractDefinition;
+export declare function defineTaskContract(objectiveInput: string, locale?: 'en' | 'zh'): TaskContractDefinition;

package/dist/src/tasks/task-contract-definition.js

@@ -1,8 +1,8 @@
 //#region src/tasks/task-contract-definition.ts
-function defineTaskContract(objectiveInput) {
+function defineTaskContract(objectiveInput, locale) {
 	const objective = objectiveInput.trim();
 	if (!objective) throw new Error("Objective is required");
-	const chinese = /[\u3400-\u9fff]/u.test(objective);
+	const chinese = locale ? locale === "zh" : /[\u3400-\u9fff]/u.test(objective);
 	return {
 		objective,
 		expectedOutputs: [objective],

package/dist/src/tasks/task-contract-planner.d.ts

@@ -1,6 +1,7 @@
 import { type TaskContractDefinition } from './task-contract-definition.js';
 export interface TaskContractPlanningInput {
     objective: string;
+    locale?: 'en' | 'zh';
     taskContext?: string;
     projectContext?: string;
     userContext?: string;

package/dist/src/tasks/task-contract-planner.js

@@ -47,7 +47,7 @@ function parseTaskContractResponse(raw) {
 }
 var ModelTaskContractPlanner = class {
 	async plan(input) {
-		const fallback = defineTaskContract(input.objective);
+		const fallback = defineTaskContract(input.objective, input.locale);
 		try {
 			const model = resolveModel(getAgentDefaultModelRef());
 			const planned = parseTaskContractResponse(extractText((await completeWithResolvedCredentials(model, { messages: [{
@@ -58,6 +58,7 @@ var ModelTaskContractPlanner = class {
 					"Acceptance criteria must describe externally checkable finished states, not activities.",
 					"List assumptions explicitly. Put only irreversible, external, financial, privacy, or permission decisions in approvalRequired.",
 					"Return one JSON object only with keys: objective, expectedOutputs, acceptanceCriteria, constraints, approvalRequired, assumptions, risks.",
+					input.locale ? `Write all user-facing JSON values in ${input.locale === "zh" ? "Simplified Chinese" : "English"}. Preserve schema keys, identifiers, paths, and proper nouns.` : "Write all user-facing JSON values in the language of the user request, regardless of the language of project or attached context. Preserve schema keys and identifiers.",
 					"",
 					`User request:\n${input.objective.trim()}`,
 					input.taskContext ? `\nUser-provided task context:\n${input.taskContext.slice(0, 16e3)}` : "",

package/dist/src/tasks/task-handoff-service.js

@@ -2,9 +2,9 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
-import { init_session_key, resolveConversationId, sanitizeSegment } from "../routing/session-key.js";
 import { normalizeAgentId } from "../agent-catalog/id.js";
 import { init_agent_scope, listAgentEntries } from "../agent/agent-scope.js";
+import { init_session_key, resolveConversationId, sanitizeSegment } from "../routing/session-key.js";
 import { TaskConversationRepository } from "./task-conversation-repository.js";
 import { TaskContextRepository } from "./task-context-repository.js";
 //#region src/tasks/task-handoff-service.ts

package/dist/src/tasks/task-language.d.ts

@@ -0,0 +1,7 @@
+import type { TaskAggregate, TaskUiLocale } from './task-repository.js';
+/** Background tasks have no current user message from which to infer a language. */
+export declare function resolveTaskLocale(task: Pick<TaskAggregate, 'locale' | 'title'> & {
+    contract?: {
+        objective: string;
+    };
+}): TaskUiLocale;

package/dist/src/tasks/task-language.js

@@ -0,0 +1,15 @@
+import { isXopcDatabaseOpen } from "../storage/sqlite/connection.js";
+import { init_sqlite } from "../storage/sqlite/index.js";
+import { getUserProfileSnapshot } from "../user-model/profile.js";
+//#region src/tasks/task-language.ts
+init_sqlite();
+/** Background tasks have no current user message from which to infer a language. */
+function resolveTaskLocale(task) {
+	if (task.locale) return task.locale;
+	const locale = isXopcDatabaseOpen() ? getUserProfileSnapshot().locale?.toLowerCase() : void 0;
+	if (locale === "zh" || locale?.startsWith("zh-")) return "zh";
+	if (locale === "en" || locale?.startsWith("en-")) return "en";
+	return /[\u3400-\u9fff]/u.test(task.contract?.objective ?? task.title) ? "zh" : "en";
+}
+//#endregion
+export { resolveTaskLocale };

package/dist/src/tasks/task-read-model-projector.js

@@ -1,6 +1,7 @@
 import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
 import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
+import { resolveTaskLocale } from "./task-language.js";
 //#region src/tasks/task-read-model-projector.ts
 init_transaction();
 init_task_repository();
@@ -35,13 +36,13 @@ var TaskReadModelProjector = class {
 			const receipt = this.#runs.getReceipt(latestRun.id);
 			attention.push({
 				kind: receipt?.verification.status === "failed" ? "verification_failed" : "run_failed",
-				summary: latestRun.terminalMessage ?? receipt?.summary ?? "The latest run failed",
+				summary: latestRun.terminalMessage ?? receipt?.summary ?? (resolveTaskLocale(task) === "zh" ? "最近一次执行失败" : "The latest run failed"),
 				sourceId: latestRun.id
 			});
 		}
 		if (task.dueAt !== void 0 && task.phase !== "closed" && task.dueAt < now) attention.push({
 			kind: "overdue",
-			summary: "Task is overdue"
+			summary: resolveTaskLocale(task) === "zh" ? "任务已逾期" : "Task is overdue"
 		});
 		return {
 			task,

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

@@ -9,6 +9,7 @@ import { init_request_repository, personalRequestForTask } from "../personal-age
 import { appendTranscriptEntry, init_transcript_repository } from "../storage/sqlite/transcript-repository.js";
 import { getPersonalAgentByConversation } from "../personal-agent/repository.js";
 import { TaskConversationRepository } from "./task-conversation-repository.js";
+import { resolveTaskLocale } from "./task-language.js";
 import { tryParseMediaUri } from "../media/uri.js";
 import { resolveMediaBufferPath } from "../media/store.js";
 import { emitSessionTranscriptUpdate } from "../session/transcript-events.js";
@@ -91,7 +92,7 @@ var TaskResultDeliveryService = class {
 						deliverables,
 						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 statusText = resolveTaskLocale(new TaskRepository().require(delivery.taskId)) === "zh" ? `${delivery.taskTitle}：${available === deliverables.length ? "成果已生成" : available > 0 ? "部分成果已生成" : "成果暂不可用"}。` : `${delivery.taskTitle}: ${available === deliverables.length ? "Results ready" : available > 0 ? "Partial results ready" : "Results unavailable"}.`;
 					const personal = getPersonalAgentByConversation(delivery.conversationId);
 					if (personal && !personalRequestForTask(delivery.taskId)) enqueuePersonalReply({
 						delivery: {

package/dist/src/tasks/task-run-coordinator.js

@@ -1,5 +1,6 @@
 import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
+import { resolveTaskLocale } from "./task-language.js";
 import { TaskContextRepository } from "./task-context-repository.js";
 import { TaskCollaborationRepository } from "./task-collaboration-repository.js";
 import { TaskResultDeliveryRepository } from "./task-result-delivery-repository.js";
@@ -12,8 +13,11 @@ var TaskRunCoordinator = class TaskRunCoordinator {
 	#application = new TaskApplicationService();
 	#runs = new TaskRunRepository();
 	#hasDeliverables = false;
+	#zh;
 	constructor(runId) {
 		this.runId = runId;
+		const run = this.#runs.require(runId);
+		this.#zh = resolveTaskLocale(new TaskRepository().require(run.taskId)) === "zh";
 	}
 	static start(input) {
 		if (!input.context.taskId) return void 0;
@@ -74,8 +78,8 @@ var TaskRunCoordinator = class TaskRunCoordinator {
 			if (item.status !== "completed") continue;
 			this.addEvidence({
 				kind: "state",
-				title: `Plan item completed: ${item.title}`,
-				summary: "The agent completed this plan item.",
+				title: this.#zh ? `计划项已完成：${item.title}` : `Plan item completed: ${item.title}`,
+				summary: this.#zh ? "助手已完成此计划项。" : "The agent completed this plan item.",
 				provenance: "tool",
 				strength: "observed",
 				observedAt: Date.now()
@@ -90,7 +94,11 @@ var TaskRunCoordinator = class TaskRunCoordinator {
 			this.addEvidence({
 				kind: "test",
 				title: item.label,
-				summary: `Final workspace check: ${item.status}`,
+				summary: this.#zh ? `最终工作区检查：${{
+					passed: "通过",
+					failed: "失败",
+					warning: "警告"
+				}[item.status]}` : `Final workspace check: ${item.status}`,
 				provenance: "tool",
 				strength: item.status === "passed" ? "verified" : "observed",
 				observedAt: Date.now()
@@ -100,8 +108,8 @@ var TaskRunCoordinator = class TaskRunCoordinator {
 	capturePatch(added, removed) {
 		this.addEvidence({
 			kind: "state",
-			title: "Changes applied",
-			summary: `${added} additions and ${removed} removals`,
+			title: this.#zh ? "已应用变更" : "Changes applied",
+			summary: this.#zh ? `新增 ${added} 处，删除 ${removed} 处` : `${added} additions and ${removed} removals`,
 			provenance: "tool",
 			strength: "observed",
 			observedAt: Date.now()
@@ -118,8 +126,14 @@ var TaskRunCoordinator = class TaskRunCoordinator {
 		const hasAssistantResult = Boolean(input.assistantText?.trim() && input.assistantText.trim() !== "NO_REPLY");
 		const hasBoardResult = new TaskCollaborationRepository().recent(run.taskId, void 0, 20).some((entry) => entry.taskRunId === run.id && entry.kind === "result");
 		const emptySuccess = input.status === "succeeded" && !hasAssistantResult && !hasBoardResult && !this.#hasDeliverables && this.#evidence.length === 0;
+		const task = new TaskRepository().require(run.taskId);
+		const zh = resolveTaskLocale(task) === "zh";
 		const status = emptySuccess ? "failed" : input.status;
-		const summary = emptySuccess ? "Agent run returned no result or evidence" : input.summary;
+		const summary = emptySuccess ? zh ? "助手执行未返回结果或证据" : "Agent run returned no result or evidence" : zh ? {
+			"Message processed": "消息已处理",
+			Interrupted: "执行已中断",
+			"Agent run ended unexpectedly": "助手执行意外结束"
+		}[input.summary] ?? input.summary : input.summary;
 		this.#application.completeRun({
 			runId: run.id,
 			expectedRunVersion: run.version,
@@ -133,13 +147,13 @@ var TaskRunCoordinator = class TaskRunCoordinator {
 					status: "unverified",
 					checks: []
 				},
-				remainingWork: emptySuccess ? [new TaskRepository().require(run.taskId).contract?.objective ?? "Complete the task"] : [],
+				remainingWork: emptySuccess ? [task.contract?.objective ?? (zh ? "完成任务" : "Complete the task")] : [],
 				needsUser: false,
 				completionVerdict: status === "succeeded" ? "partial" : "not_achieved",
 				...status === "failed" ? { failure: {
 					code: emptySuccess ? "empty_agent_run" : "agent_run_failed",
 					phase: "execution",
-					recoveryAction: "Retry the task run with another available Agent or model"
+					recoveryAction: zh ? "使用其他可用助手或模型重试任务" : "Retry the task run with another available Agent or model"
 				} } : {}
 			}
 		});

package/dist/src/tasks/task-run-dispatcher.js

@@ -2,6 +2,7 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
+import { resolveTaskLocale } from "./task-language.js";
 import { TaskApplicationService } from "./task-application-service.js";
 //#region src/tasks/task-run-dispatcher.ts
 init_logger();
@@ -42,27 +43,28 @@ var TaskRunDispatcher = class {
 		for (const run of this.#runs.listExpiredLeasedRunning()) {
 			if (this.#activeRunIds.has(run.id)) continue;
 			try {
+				const zh = resolveTaskLocale(this.#tasks.require(run.taskId)) === "zh";
 				this.#application.completeRun({
 					runId: run.id,
 					expectedRunVersion: run.version,
 					terminalCode: "execution_interrupted",
-					terminalMessage: "Task execution stopped before its result could be confirmed",
+					terminalMessage: zh ? "任务执行已停止，结果尚未确认" : "Task execution stopped before its result could be confirmed",
 					receipt: {
 						status: "failed",
-						summary: "Execution interrupted; verify external effects before retrying",
+						summary: zh ? "执行已中断；重试前请检查外部操作的影响" : "Execution interrupted; verify external effects before retrying",
 						changes: [],
 						evidence: [],
 						verification: {
 							status: "unverified",
 							checks: []
 						},
-						remainingWork: ["Verify whether the previous execution made external changes"],
+						remainingWork: [zh ? "检查上次执行是否已产生外部变更" : "Verify whether the previous execution made external changes"],
 						needsUser: true,
 						completionVerdict: "not_achieved",
 						failure: {
 							code: "execution_interrupted",
 							phase: "execution",
-							recoveryAction: "Inspect effects before retrying"
+							recoveryAction: zh ? "重试前检查执行影响" : "Inspect effects before retrying"
 						}
 					}
 				});
@@ -136,7 +138,7 @@ var TaskRunDispatcher = class {
 						terminalMessage: error instanceof Error ? error.message : String(error),
 						receipt: {
 							status: "failed",
-							summary: "TaskRun dispatch failed",
+							summary: resolveTaskLocale(task) === "zh" ? "任务执行调度失败" : "TaskRun dispatch failed",
 							changes: [],
 							evidence: [],
 							verification: {
@@ -149,7 +151,7 @@ var TaskRunDispatcher = class {
 							failure: {
 								code: "dispatch_failed",
 								phase: "dispatch",
-								recoveryAction: "Retry the task run"
+								recoveryAction: resolveTaskLocale(task) === "zh" ? "重试任务执行" : "Retry the task run"
 							}
 						}
 					});

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

@@ -8,9 +8,10 @@ import { cancelQueuedSessionInput, claimNextSessionInput, finishSessionInputRun,
 import { appendComposerInputHistory, listComposerInputHistory } from "../../storage/sqlite/composer-input-history-repository.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
-import { init_agent_session_key, resolveAgentIdFromConversationId } from "../../routing/agent-session-key.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_agent_session_key, resolveAgentIdFromConversationId } from "../../routing/agent-session-key.js";
 import { resolveEffectiveAgentProfile } from "../../config/agent-profile.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { init_paths } from "../../config/paths.js";
@@ -23,7 +24,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/platform-catalog.d.ts

@@ -31,6 +31,7 @@ export declare function requirePlatformVoiceModel(id: string, mode: VoiceModeCap
             gender?: "female" | "male";
             style?: string;
             description?: string;
+            modes?: ("conversation" | "transcription" | "speech" | "transcription.stream" | "speech.stream")[];
         }[];
         limits: {
             maxFrameBytes: number;

package/dist/src/voice/platform-settings.d.ts

@@ -1,4 +1,4 @@
-import type { VoiceSelection, VoiceSettingsCatalog } from '@xopcai/realtime-protocol/voice';
+import { type VoiceSelection, type VoiceSettingsCatalog } from '@xopcai/realtime-protocol/voice';
 import { type Config } from '../config/schema.js';
 export declare function voiceSettingsCatalog(config: Config): VoiceSettingsCatalog;
 export declare function selectPlatformVoice(config: Config, selection: VoiceSelection): Config;

package/dist/src/voice/platform-settings.js

@@ -1,8 +1,11 @@
 import { ConfigSchema, init_schema } from "../config/schema.js";
+import { voiceSupportsMode } from "../../packages/realtime-protocol/src/voice-catalog.js";
+import { init_voice } from "../../packages/realtime-protocol/src/voice.js";
 import { getModelCatalogStore, init_model_catalog_store } from "../providers/model-catalog-store.js";
 import { requirePlatformVoiceModel } from "./platform-catalog.js";
 import { createHash } from "node:crypto";
 //#region src/voice/platform-settings.ts
+init_voice();
 init_schema();
 init_model_catalog_store();
 function voiceSettingsCatalog(config) {
@@ -47,8 +50,9 @@ function voiceSettingsCatalog(config) {
 function selectPlatformVoice(config, selection) {
 	const model = requirePlatformVoiceModel(selection.model, selection.mode);
 	const output = selection.mode === "speech" || selection.mode === "speech.stream" || selection.mode === "conversation";
-	const voice = selection.voice ?? model.voice.defaultVoice ?? model.voice.voices[0]?.id;
-	if (output && (!voice || !model.voice.voices.some((item) => item.id === voice))) throw new Error("Choose an available model voice");
+	const voices = model.voice.voices.filter((item) => voiceSupportsMode(item, selection.mode));
+	const voice = selection.voice ?? voices.find((item) => item.id === model.voice.defaultVoice)?.id ?? voices[0]?.id;
+	if (output && (!voice || !voices.some((item) => item.id === voice))) throw new Error("Choose an available model voice");
 	const next = structuredClone(config);
 	const selected = {
 		provider: "xopc-cloud",

package/dist/src/voice/platform-streams.js

@@ -10,6 +10,8 @@ var PlatformVoiceError = class extends Error {
 		this.name = "PlatformVoiceError";
 	}
 	get clientMessage() {
+		if (this.code === "unsupported_voice") return "The selected voice is unavailable. Refresh the voice catalog or choose another voice.";
+		if (this.status === 409) return "The voice model publication changed. Refresh the voice catalog and try again.";
 		if (this.code === "realtime_quota_session_limit") return "The funded transcription duration has been reached. Start a new voice session to continue.";
 		if (this.code === "realtime_quota_workspace_budget") return "XOPC Cloud voice workspace budget is exhausted. Increase the workspace budget or choose another voice provider.";
 		if (this.status === 402 || this.code === "realtime_quota_user_credits") return "XOPC Cloud voice has insufficient Credit or quota. Check your Cloud balance and workspace budget, or choose another voice provider.";
@@ -81,7 +83,7 @@ function connect(url, token, signal, onEvent, onFailure) {
 		response.once("aborted", reject);
 	});
 	socket.on("error", fail);
-	socket.on("close", (code, reason) => fail(new PlatformVoiceError(`Platform voice disconnected before completion (close ${code}${reason.length ? `: ${reason.toString("utf8").slice(0, 256)}` : ""})`, void 0, "provider_disconnected")));
+	socket.on("close", (code, reason) => fail(new PlatformVoiceError(`Platform voice disconnected before completion (close ${code}${reason.length ? `: ${reason.toString("utf8").slice(0, 256)}` : ""})`, void 0, code === 4400 && reason.toString("utf8") === "Unsupported voice" ? "unsupported_voice" : "provider_disconnected")));
 	return {
 		socket,
 		close,

package/dist/src/voice/realtime/omniRoute.d.ts

@@ -1,4 +1,4 @@
-import type { VoiceProviderRoute } from '@xopcai/realtime-protocol/voice';
+import { type VoiceProviderRoute } from '@xopcai/realtime-protocol/voice';
 import type { Config } from '../../config/schema.js';
 export interface OmniRoute {
     route: VoiceProviderRoute;

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

@@ -1,7 +1,10 @@
+import { voiceSupportsMode } from "../../../packages/realtime-protocol/src/voice-catalog.js";
+import { init_voice } from "../../../packages/realtime-protocol/src/voice.js";
 import { init_xopc_cloud_config, resolveXopcModelRouterUrl } from "../../providers/xopc-cloud-config.js";
 import { getProviderAuthService, init_provider_auth_service } from "../../providers/provider-auth-service.js";
 import { requirePlatformVoiceModel } from "../platform-catalog.js";
 //#region src/voice/realtime/omniRoute.ts
+init_voice();
 init_provider_auth_service();
 init_xopc_cloud_config();
 async function resolveOmniRoute(config) {
@@ -13,7 +16,7 @@ async function resolveOmniRoute(config) {
 		const model = requirePlatformVoiceModel(slice.model, "conversation");
 		maxSessionSeconds = model.voice.limits.maxSessionSeconds;
 		serviceVersion = model.voice.serviceVersion;
-		if (!model.voice.voices.some((voice) => voice.id === slice.voice)) throw new Error("Selected voice is unavailable");
+		if (!model.voice.voices.some((voice) => voice.id === slice.voice && voiceSupportsMode(voice, "conversation"))) throw new Error("Selected voice is unavailable");
 	}
 	const managed = slice.provider === "xopc-cloud";
 	const url = new URL(managed ? `${resolveXopcModelRouterUrl(slice.baseUrl)}/audio/conversations/realtime` : slice.baseUrl ?? "wss://dashscope.aliyuncs.com/api-ws/v1/realtime");

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/tts/providers/xopc-cloud-speech.js

@@ -1,3 +1,5 @@
+import { voiceSupportsMode } from "../../../../packages/realtime-protocol/src/voice-catalog.js";
+import { init_voice } from "../../../../packages/realtime-protocol/src/voice.js";
 import { getModelCatalogStore, init_model_catalog_store } from "../../../providers/model-catalog-store.js";
 import { init_xopc_cloud_config, resolveXopcModelRouterUrl } from "../../../providers/xopc-cloud-config.js";
 import { getProviderAuthService, init_provider_auth_service } from "../../../providers/provider-auth-service.js";
@@ -10,6 +12,7 @@ import { requirePlatformVoiceModel } from "../../platform-catalog.js";
 import { registerSpeechProvider } from "../speech-registry.js";
 //#region src/voice/tts/providers/xopc-cloud-speech.ts
 init_model_catalog_store();
+init_voice();
 init_provider_auth_service();
 init_xopc_cloud_config();
 function availableModels() {
@@ -55,10 +58,10 @@ const xopcCloudSpeechProvider = {
 		const config = readConfig(providerConfig);
 		return Boolean(config.model && config.voice && availableModels().some((model) => model.id === config.model));
 	},
-	listVoices: async ({ providerConfig }) => {
+	listVoices: async ({ providerConfig, mode = "speech" }) => {
 		const config = readConfig(providerConfig ?? {});
 		if (!config.model) return [];
-		return availableModels().find((model) => model.id === config.model)?.voice?.voices.map(({ id, name, displayNames }) => ({
+		return availableModels().find((model) => model.id === config.model)?.voice?.voices.filter((voice) => voiceSupportsMode(voice, mode)).map(({ id, name, displayNames }) => ({
 			id,
 			name,
 			...displayNames ? { displayNames } : {}
@@ -127,6 +130,7 @@ const xopcCloudSpeechProvider = {
 		relayUrl.protocol = relayUrl.protocol === "https:" ? "wss:" : "ws:";
 		relayUrl.searchParams.set("model", model);
 		relayUrl.searchParams.set("service_version", String(catalogModel.voice.serviceVersion));
+		relayUrl.searchParams.set("voice", voice);
 		const instructions = typeof request.providerOverrides?.instructions === "string" ? request.providerOverrides.instructions.trim() : config.instructions;
 		return openPlatformTts({
 			apiKey: token,

package/dist/src/voice/tts/speech-provider-types.d.ts

@@ -109,6 +109,7 @@ export interface SpeechVoiceOption {
     personalities?: string[];
 }
 export interface SpeechListVoicesRequest {
+    mode?: 'speech' | 'speech.stream';
     cfg?: Config;
     providerConfig?: SpeechProviderConfig;
     apiKey?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.378",
+  "version": "0.0.380",
   "description": "Local-first personal AI with Ada, task delegation, files, projects, workflows, and automations. Use cloud or local models.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -165,12 +165,12 @@
     "vitepress": "^1.6.4",
     "vitest": "4.1.5",
     "vue": "^3.5.35",
+    "@xopcai/browser-control-contract": "0.1.0",
     "@xopcai/computer-control-contract": "0.1.0",
     "@xopcai/endpoint-tools-client": "0.0.0",
-    "@xopcai/browser-control-contract": "0.1.0",
-    "@xopcai/endpoint-tools-protocol": "0.0.0",
-    "@xopcai/image-providers": "0.1.0",
     "@xopcai/gateway-contract": "0.0.0",
+    "@xopcai/image-providers": "0.1.0",
+    "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/realtime-client": "0.0.0",
     "@xopcai/realtime-protocol": "0.0.0"
   },