@xopcai/xopc 0.0.355 → 0.0.357

package/dist/src/personal-agent/onboarding.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+export declare const PersonalOnboardingStepSchema: z.ZodEnum<{
+    voice: "voice";
+    identity: "identity";
+    intro: "intro";
+    connections: "connections";
+}>;
+export declare const PersonalOnboardingDraftSchema: z.ZodObject<{
+    displayName: z.ZodDefault<z.ZodString>;
+    appearance: z.ZodDefault<z.ZodEnum<{
+        loopi: "loopi";
+        "loopi-curious": "loopi-curious";
+        "loopi-care": "loopi-care";
+    }>>;
+    voice: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type PersonalOnboardingDraft = z.infer<typeof PersonalOnboardingDraftSchema>;
+export type PersonalOnboardingStep = z.infer<typeof PersonalOnboardingStepSchema>;
+export declare function getPersonalOnboarding(ownerId: string): {
+    step: PersonalOnboardingStep;
+    draft: PersonalOnboardingDraft;
+    completed: boolean;
+    welcomeDone: boolean;
+};
+export declare function savePersonalOnboarding(ownerId: string, step: PersonalOnboardingStep, draft: PersonalOnboardingDraft): void;
+export declare function completePersonalOnboarding(ownerId: string): void;
+export declare function finishPersonalWelcome(ownerId: string): void;

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

@@ -0,0 +1,48 @@
+import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
+import { z } from "zod";
+//#region src/personal-agent/onboarding.ts
+init_transaction();
+const PersonalOnboardingStepSchema = z.enum([
+	"intro",
+	"identity",
+	"voice",
+	"connections"
+]);
+const PersonalOnboardingDraftSchema = z.object({
+	displayName: z.string().trim().min(1).max(60).default("Ada"),
+	appearance: z.enum([
+		"loopi",
+		"loopi-curious",
+		"loopi-care"
+	]).default("loopi"),
+	voice: z.string().trim().min(1).max(200).nullable().default(null)
+}).strict();
+function getPersonalOnboarding(ownerId) {
+	const row = getSqliteDatabase().prepare(`SELECT step, draft_json, completed_at, welcome_finished_at
+    FROM personal_agent_onboarding WHERE owner_id = ?`).get(ownerId);
+	return {
+		step: PersonalOnboardingStepSchema.safeParse(row?.step).data ?? "intro",
+		draft: PersonalOnboardingDraftSchema.parse(row ? JSON.parse(row.draft_json) : {}),
+		completed: row?.completed_at != null,
+		welcomeDone: row?.welcome_finished_at != null
+	};
+}
+function savePersonalOnboarding(ownerId, step, draft) {
+	getSqliteDatabase().prepare(`INSERT INTO personal_agent_onboarding
+    (owner_id, step, draft_json, completed_at, updated_at) VALUES (?, ?, ?, NULL, ?)
+    ON CONFLICT(owner_id) DO UPDATE SET step = excluded.step, draft_json = excluded.draft_json,
+      updated_at = excluded.updated_at WHERE completed_at IS NULL`).run(ownerId, step, JSON.stringify(draft), Date.now());
+}
+function completePersonalOnboarding(ownerId) {
+	const now = Date.now();
+	getSqliteDatabase().prepare(`INSERT INTO personal_agent_onboarding
+    (owner_id, step, draft_json, completed_at, updated_at) VALUES (?, 'connections', '{}', ?, ?)
+    ON CONFLICT(owner_id) DO UPDATE SET completed_at = COALESCE(completed_at, excluded.completed_at),
+      updated_at = excluded.updated_at`).run(ownerId, now, now);
+}
+function finishPersonalWelcome(ownerId) {
+	getSqliteDatabase().prepare(`UPDATE personal_agent_onboarding
+    SET welcome_finished_at = COALESCE(welcome_finished_at, ?), updated_at = ? WHERE owner_id = ?`).run(Date.now(), Date.now(), ownerId);
+}
+//#endregion
+export { PersonalOnboardingDraftSchema, PersonalOnboardingStepSchema, completePersonalOnboarding, finishPersonalWelcome, getPersonalOnboarding, savePersonalOnboarding };

package/dist/src/personal-agent/repository.d.ts

@@ -1,5 +1,5 @@
 export type PersonalAgentState = 'provisioning' | 'ready' | 'error';
-export type PersonalAppearance = 'spark' | 'cloud' | 'bean';
+export type PersonalAppearance = 'loopi' | 'loopi-curious' | 'loopi-care' | 'custom';
 export interface PersonalAgentRecord {
     ownerId: string;
     agentId: string;
@@ -7,6 +7,11 @@ export interface PersonalAgentRecord {
     state: PersonalAgentState;
     displayName: string;
     appearance: PersonalAppearance;
+    voicePreference: {
+        provider: string;
+        model: string;
+        voice: string;
+    } | null;
     preferences: Record<string, unknown>;
     revision: number;
     errorMessage: string | null;

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

@@ -29,7 +29,11 @@ function personalSession(column, value) {
     ORDER BY created_at LIMIT 1`).get(value) ?? null;
 }
 function appearanceFrom(agent) {
-	return agent.profile?.emoji === "☁" ? "cloud" : agent.profile?.emoji === "◕" ? "bean" : "spark";
+	const avatar = agent.profile?.avatar;
+	if (avatar === "xopc:custom") return "custom";
+	if (avatar === "xopc:loopi:curious" || avatar === "xopc:loopi:listen" || !avatar && agent.profile?.emoji === "☁") return "loopi-curious";
+	if (avatar === "xopc:loopi:care" || !avatar && agent.profile?.emoji === "◕") return "loopi-care";
+	return "loopi";
 }
 function toRecord(ownerId, agent, session) {
 	const config = session ? getSessionConfig(session.conversation_id) : null;
@@ -39,8 +43,9 @@ function toRecord(ownerId, agent, session) {
 		agentId: agent.id,
 		conversationId: session?.conversation_id ?? personalConversationId(ownerId),
 		state: agent.provisioningState === "error" ? "error" : ready ? "ready" : "provisioning",
-		displayName: agent.profile?.name ?? "Personal AI",
+		displayName: agent.profile?.name ?? "Ada",
 		appearance: appearanceFrom(agent),
+		voicePreference: agent.profile?.voicePreference ?? null,
 		preferences: agent.profile?.responsePreferences ?? DEFAULT_PERSONAL_PREFERENCES,
 		revision: agent.revision,
 		errorMessage: agent.provisioningError ?? null

package/dist/src/personal-agent/service.d.ts

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-import type { GatewayService } from '../gateway/service.js';
 import { type PersonalAgentRecord } from './repository.js';
 export declare const PersonalPreferencesSchema: z.ZodObject<{
     addressAs: z.ZodOptional<z.ZodString>;
@@ -32,18 +31,42 @@ export declare const PersonalPreferencesSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type PersonalPreferences = z.infer<typeof PersonalPreferencesSchema>;
 export declare const PersonalAppearanceSchema: z.ZodEnum<{
-    cloud: "cloud";
-    spark: "spark";
-    bean: "bean";
+    custom: "custom";
+    loopi: "loopi";
+    "loopi-curious": "loopi-curious";
+    "loopi-care": "loopi-care";
 }>;
 export type PersonalAppearance = z.infer<typeof PersonalAppearanceSchema>;
+type PersonalAgentHost = {
+    refreshAgentCatalog(): void;
+    agentService: {
+        evictSessionAgent(conversationId: string): void;
+    };
+};
 export declare function personalInstructions(preferences: PersonalPreferences): string;
-export declare function refreshPersonalDelegationGuidance(service: GatewayService, ownerId: string): Promise<void>;
+export declare function refreshPersonalDelegationGuidance(service: PersonalAgentHost, ownerId: string): Promise<void>;
 export declare function listPersonalModels(): Promise<Array<{
     id: string;
     name: string;
 }>>;
 export declare function ensurePersonalConversationVisibility(ownerId: string): void;
-export declare function createOrResumePersonalAgent(service: GatewayService, ownerId: string, requestedModel?: string, availableModels?: typeof listPersonalModels): Promise<PersonalAgentRecord>;
-export declare function patchPersonalProfile(service: GatewayService, ownerId: string, revision: number, displayName: string, preferences: PersonalPreferences, appearance: PersonalAppearance): Promise<PersonalAgentRecord | null>;
-export declare function updatePersonalProfileRecord(ownerId: string, revision: number, displayName: string, preferences: PersonalPreferences, appearance: PersonalAppearance): Promise<PersonalAgentRecord | null>;
+export declare function createOrResumePersonalAgent(service: PersonalAgentHost, ownerId: string, requestedModel?: string, availableModels?: typeof listPersonalModels, initial?: {
+    displayName: string;
+    appearance: Exclude<PersonalAppearance, 'custom'>;
+    voicePreference?: {
+        provider: string;
+        model: string;
+        voice: string;
+    };
+}): Promise<PersonalAgentRecord>;
+export declare function patchPersonalProfile(service: PersonalAgentHost, ownerId: string, revision: number, displayName: string, preferences: PersonalPreferences, appearance: PersonalAppearance, voicePreference?: {
+    provider: string;
+    model: string;
+    voice: string;
+} | null): Promise<PersonalAgentRecord | null>;
+export declare function updatePersonalProfileRecord(ownerId: string, revision: number, displayName: string, preferences: PersonalPreferences, appearance: PersonalAppearance, voicePreference?: {
+    provider: string;
+    model: string;
+    voice: string;
+} | null): Promise<PersonalAgentRecord | null>;
+export {};

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

@@ -4,12 +4,13 @@ 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 { getModelThinking } from "../providers/model-thinking.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { DEFAULT_PERSONAL_PREFERENCES, getPersonalAgent, personalAgentId } from "./repository.js";
 import { PERSONAL_MAIN_TOOL_IDS } from "./policy.js";
+import { completePersonalOnboarding } from "./onboarding.js";
 import { z } from "zod";
 //#region src/personal-agent/service.ts
 init_agent_config();
@@ -20,12 +21,16 @@ init_session_repository();
 init_config_repository();
 const PersonalPreferencesSchema = ResponsePreferencesSchema;
 const PersonalAppearanceSchema = z.enum([
-	"spark",
-	"cloud",
-	"bean"
+	"loopi",
+	"loopi-curious",
+	"loopi-care",
+	"custom"
 ]);
 function appearanceEmoji(appearance) {
-	return appearance === "cloud" ? "☁" : appearance === "bean" ? "◕" : "✦";
+	return appearance === "loopi-curious" ? "◌" : appearance === "loopi-care" ? "♡" : "◉";
+}
+function appearanceAvatar(appearance) {
+	return appearance === "custom" ? "xopc:custom" : `xopc:loopi:${appearance === "loopi" ? "idle" : appearance.slice(6)}`;
 }
 const LEGACY_DELEGATION_RULE = "Answer simple requests directly. For complex work, use personal_task agents to find a suitable specialist, then create a Task and remain available to talk. Never claim a task was created before the tool confirms it.";
 const PREVIOUS_DELEGATION_RULES = [
@@ -125,19 +130,20 @@ function ensurePersonalConversationVisibility(ownerId) {
 		}
 	});
 }
-function createOrResumePersonalAgent(service, ownerId, requestedModel, availableModels = listPersonalModels) {
+function createOrResumePersonalAgent(service, ownerId, requestedModel, availableModels = listPersonalModels, initial) {
 	const current = inFlightProvisioning.get(ownerId);
 	if (current) return current;
-	const pending = provisionPersonalAgent(service, ownerId, requestedModel, availableModels);
+	const pending = provisionPersonalAgent(service, ownerId, requestedModel, availableModels, initial);
 	inFlightProvisioning.set(ownerId, pending);
 	pending.finally(() => {
 		if (inFlightProvisioning.get(ownerId) === pending) inFlightProvisioning.delete(ownerId);
 	}).catch(() => {});
 	return pending;
 }
-async function provisionPersonalAgent(service, ownerId, requestedModel, availableModels = listPersonalModels) {
+async function provisionPersonalAgent(service, ownerId, requestedModel, availableModels = listPersonalModels, initial) {
 	const existingIdentity = getPersonalAgent(ownerId);
 	if (existingIdentity?.state === "ready") {
+		completePersonalOnboarding(ownerId);
 		await refreshPersonalDelegationGuidance(service, ownerId);
 		ensurePersonalConversationVisibility(ownerId);
 		return getPersonalAgent(ownerId) ?? existingIdentity;
@@ -154,11 +160,13 @@ async function provisionPersonalAgent(service, ownerId, requestedModel, availabl
 		id: agentId,
 		enabled: true,
 		profile: {
-			name: "Personal AI",
+			name: initial?.displayName ?? "Ada",
 			description: "A personal AI that adapts its responses to the user and coordinates work.",
 			creature: "assistant",
 			language: "zh",
-			emoji: appearanceEmoji("spark"),
+			emoji: appearanceEmoji(initial?.appearance ?? "loopi"),
+			avatar: appearanceAvatar(initial?.appearance ?? "loopi"),
+			...initial?.voicePreference ? { voicePreference: initial.voicePreference } : {},
 			responsePreferences: DEFAULT_PERSONAL_PREFERENCES,
 			instructions: personalInstructions(DEFAULT_PERSONAL_PREFERENCES)
 		},
@@ -203,22 +211,25 @@ async function provisionPersonalAgent(service, ownerId, requestedModel, availabl
 		fixedModel: true,
 		thinkingLevel: "off"
 	}, process.cwd());
+	completePersonalOnboarding(ownerId);
 	return getPersonalAgent(ownerId) ?? record;
 }
-async function patchPersonalProfile(service, ownerId, revision, displayName, preferences, appearance) {
-	const updated = await updatePersonalProfileRecord(ownerId, revision, displayName, preferences, appearance);
+async function patchPersonalProfile(service, ownerId, revision, displayName, preferences, appearance, voicePreference) {
+	const updated = await updatePersonalProfileRecord(ownerId, revision, displayName, preferences, appearance, voicePreference);
 	if (!updated) return null;
 	service.refreshAgentCatalog();
 	service.agentService.evictSessionAgent(updated.conversationId);
 	return updated;
 }
-async function updatePersonalProfileRecord(ownerId, revision, displayName, preferences, appearance) {
+async function updatePersonalProfileRecord(ownerId, revision, displayName, preferences, appearance, voicePreference) {
 	const current = new AgentCatalogRepository().get(personalAgentId(ownerId));
 	if (!current || current.provisioningState !== "ready" || current.revision !== revision || getPersonalAgent(ownerId)?.state !== "ready") return null;
 	const profile = {
 		...current.profile,
 		name: displayName,
 		emoji: appearanceEmoji(appearance),
+		avatar: appearanceAvatar(appearance),
+		...voicePreference !== void 0 ? { voicePreference: voicePreference ?? void 0 } : {},
 		responsePreferences: preferences,
 		instructions: personalInstructions(preferences)
 	};

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 { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.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 { voiceManifestSchema } from "../../packages/realtime-protocol/src/voice-catalog.js";
 import { init_voice } from "../../packages/realtime-protocol/src/voice.js";
 import { readFileSync, rmSync } from "node:fs";
@@ -138,7 +138,7 @@ var init_model_catalog_persistence = __esmMin((() => {
 		baseUrl: z.string().url(),
 		api: z.enum(["openai-completions", "openai-responses"]),
 		recommendedModel: z.string().nullable(),
-		recommended: z.record(z.enum([
+		recommended: z.partialRecord(z.enum([
 			"vision",
 			"image-generation",
 			"stt",

package/dist/src/storage/sqlite/migrations/230_personal_agent_onboarding.sql

@@ -0,0 +1,8 @@
+CREATE TABLE personal_agent_onboarding (
+  owner_id TEXT PRIMARY KEY,
+  step TEXT NOT NULL,
+  draft_json TEXT NOT NULL DEFAULT '{}',
+  completed_at INTEGER,
+  welcome_finished_at INTEGER,
+  updated_at INTEGER NOT NULL
+);

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 = 229;
+export declare const XOPC_DB_SCHEMA_VERSION = 230;
 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 ?? 229;
+	const targetVersion = options.targetVersion ?? 230;
 	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 ?? 229;
+	const appVersion = options.targetVersion ?? 230;
 	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 = 229;
+	XOPC_DB_SCHEMA_VERSION = 230;
 }));
 //#endregion
 init_runner();

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

@@ -28,7 +28,7 @@ function ensureXopcDatabaseSchema(db, options = {}) {
 		currentVersion = 165;
 	}
 	applyPendingMigrations(db, {
-		targetVersion: 229,
+		targetVersion: 230,
 		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 { 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 { CapabilityError } from "../../capabilities/runtime/errors.js";
+import { defineReadCapability } from "../../capabilities/runtime/dispatcher.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/tui/backends/embedded-backend.js

@@ -9,9 +9,8 @@ import { appendComposerInputHistory, listComposerInputHistory } from "../../stor
 import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
 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 { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
+import { init_agent_scope, listAgentEntries } from "../../agent/agent-scope.js";
 import { init_agent_session_key, resolveAgentIdFromConversationId } from "../../routing/agent-session-key.js";
 import { resolveEffectiveAgentProfile } from "../../config/agent-profile.js";
 import { init_paths } from "../../config/paths.js";
@@ -23,6 +22,7 @@ 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/language-profile.js

@@ -47,7 +47,7 @@ function initializeVoiceDefaults(config, language = inferProductLanguageFromEnvi
 		providers: {
 			...audio?.providers ?? {},
 			alibaba: {
-				model: "qwen-audio-3.0-asr-flash",
+				model: "qwen-audio-3.1-asr-flash",
 				...audio?.providers?.alibaba ?? {}
 			},
 			openai: {

package/dist/src/voice/metadata/builtin.js

@@ -1,4 +1,5 @@
 import { OPENAI_TTS_MODELS, OPENAI_TTS_VOICES } from "../tts/providers/openai-speech.js";
+import { alibabaTtsVoices as alibabaTtsVoices$1 } from "../tts/providers/alibaba-voices.js";
 import { MINIMAX_TTS_MODELS, MINIMAX_TTS_VOICES } from "../tts/providers/minimax-speech.js";
 import "../tts/providers/index.js";
 import { registerVoiceProviderMetadata } from "./registry.js";
@@ -13,13 +14,16 @@ function options(values, names) {
 	}));
 }
 const alibabaSttModels = [{
+	id: "qwen-audio-3.1-asr-flash",
+	name: "Qwen Audio 3.1 ASR Flash"
+}, {
 	id: "qwen-audio-3.0-asr-flash",
 	name: "Qwen Audio 3.0 ASR Flash"
 }];
 const alibabaTtsModels = [
 	{
 		id: "qwen-tts",
-		name: "Qwen TTS (Recommended)"
+		name: "Qwen TTS (Legacy)"
 	},
 	{
 		id: "qwen-tts-realtime",
@@ -27,47 +31,20 @@ const alibabaTtsModels = [
 	},
 	{
 		id: "qwen3-tts-flash",
-		name: "Qwen3 TTS Flash"
+		name: "Qwen3 TTS Flash (Recommended)"
 	},
 	{
 		id: "qwen3-tts-instruct-flash",
 		name: "Qwen3 TTS Instruct Flash"
 	}
 ];
-const alibabaTtsVoices = [
-	{
-		id: "Cherry",
-		name: "Cherry"
-	},
-	{
-		id: "Ethan",
-		name: "Ethan"
-	},
-	{
-		id: "Serena",
-		name: "Serena"
-	},
-	{
-		id: "Chelsie",
-		name: "Chelsie"
-	},
-	{
-		id: "longxiaochun",
-		name: "Long Xiao Chun (龙小春)"
-	},
-	{
-		id: "longxiaobai",
-		name: "Long Xiao Bai (龙小白)"
-	},
-	{
-		id: "longwan",
-		name: "Long Wan (龙婉)"
-	},
-	{
-		id: "longcheng",
-		name: "Long Cheng (龙呈)"
-	}
-];
+const alibabaTtsVoices = alibabaTtsVoices$1.map(({ id, name, description, gender, category }) => ({
+	id,
+	name: name ?? id,
+	description,
+	gender,
+	style: category
+}));
 const edgeVoices = [
 	{
 		id: "en-US-MichelleNeural",
@@ -161,7 +138,7 @@ const builtinVoiceProviderMetadata = [
 				label: "Model",
 				type: "select",
 				options: alibabaSttModels,
-				defaultValue: "qwen-audio-3.0-asr-flash"
+				defaultValue: "qwen-audio-3.1-asr-flash"
 			},
 			{
 				key: "language",
@@ -356,14 +333,14 @@ const builtinVoiceProviderMetadata = [
 				label: "Model",
 				type: "select",
 				options: alibabaTtsModels,
-				defaultValue: "qwen-tts"
+				defaultValue: "qwen3-tts-flash"
 			},
 			{
 				key: "voice",
 				label: "Voice",
 				type: "select",
 				options: alibabaTtsVoices,
-				defaultValue: "longxiaochun"
+				defaultValue: "Cherry"
 			}
 		],
 		diagnostics: {

package/dist/src/voice/metadata/types.d.ts

@@ -4,6 +4,8 @@ export interface VoiceOptionMetadata {
     id: string;
     name: string;
     description?: string;
+    gender?: string;
+    style?: string;
 }
 export interface VoiceConfigFieldMetadata {
     key: string;

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

@@ -24,6 +24,9 @@ export declare function requirePlatformVoiceModel(id: string, mode: VoiceModeCap
             id: string;
             name: string;
             languages: string[];
+            gender?: "female" | "male";
+            style?: string;
+            description?: string;
         }[];
         limits: {
             maxFrameBytes: number;

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

@@ -59,12 +59,16 @@ function createAgentVoiceEngine(options) {
 		});
 		send("turn.committed", { turnId });
 		if (queuedTurns >= 8) {
+			log.warn({
+				sessionId: claim.sessionId,
+				queuedTurns,
+				turnId
+			}, "Realtime voice turn dropped because the input queue is full");
 			send("session.error", {
 				code: "INPUT_BACKPRESSURE",
-				message: "Too many queued voice turns",
-				recoverable: false
+				message: "Too many queued voice turns; please repeat the last request",
+				recoverable: true
 			});
-			options.onClose("input_backpressure", true);
 			return;
 		}
 		queuedTurns += 1;
@@ -247,6 +251,7 @@ function createAgentVoiceEngine(options) {
 			startedAt: Date.now(),
 			firstTextSeen: false,
 			awaitingClarification: false,
+			taskDone: false,
 			pcm: new PcmFrameBuffer()
 		};
 		const taskUpdateExposed = () => Boolean(updateClientMessageId && response.text.trim());
@@ -304,10 +309,13 @@ function createAgentVoiceEngine(options) {
 				});
 				if (event.type === "run_end" || event.type === "stream_end") {
 					const status = event.payload?.status;
-					send("task.done", {
-						taskId: task.taskId,
-						status: status === "cancelled" ? "cancelled" : status === "suspended" ? "suspended" : status === "error" ? "failed" : "completed"
-					});
+					if (!response.taskDone) {
+						response.taskDone = true;
+						send("task.done", {
+							taskId: task.taskId,
+							status: status === "cancelled" ? "cancelled" : status === "suspended" ? "suspended" : status === "error" ? "failed" : "completed"
+						});
+					}
 				}
 				if (event.type === "clarify_request" && typeof event.payload?.requestId === "string" && typeof event.payload?.question === "string") {
 					response.awaitingClarification = true;
@@ -364,6 +372,13 @@ function createAgentVoiceEngine(options) {
 				message: "Voice response failed",
 				recoverable: true
 			});
+			if (response.taskId && !response.taskDone) {
+				response.taskDone = true;
+				send("task.done", {
+					taskId: response.taskId,
+					status: "failed"
+				});
+			}
 			if (response.audioStarted) send("response.audio.done", { responseId: response.id });
 			send("response.done", {
 				responseId: response.id,
@@ -405,13 +420,17 @@ function createAgentVoiceEngine(options) {
 	function bufferFinal(utteranceId, text) {
 		try {
 			turn.final(utteranceId, text);
-		} catch {
+		} catch (error) {
+			log.warn({
+				err: error,
+				sessionId: claim.sessionId,
+				utteranceId
+			}, "Realtime voice turn exceeded the input limit");
 			send("session.error", {
 				code: "INPUT_BACKPRESSURE",
-				message: "Voice turn input limit reached",
-				recoverable: false
+				message: "Voice turn input limit reached; please repeat the request",
+				recoverable: true
 			});
-			options.onClose("input_backpressure", true);
 		}
 	}
 	function onSttEvent(event) {

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

@@ -1,6 +1,6 @@
 import { init_agent_scope, resolveAgentProfileDir } from "../../agent/agent-scope.js";
-import { DEFAULT_SOUL_FILENAME } from "../../agent/context/workspace.js";
 import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { DEFAULT_SOUL_FILENAME } from "../../agent/context/workspace.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/runtime.js

@@ -7,6 +7,7 @@ import { getModelCatalogStore, init_model_catalog_store } from "../../providers/
 import { getMediaUnderstandingProvider } from "../../media-understanding/registry.js";
 import { resolveSTTProviderChain } from "../stt/factory.js";
 import { mergeSttConfigFromAppConfig } from "../stt/config.js";
+import { getPersonalAgentByConversation } from "../../personal-agent/repository.js";
 import { ALIBABA_REALTIME_TTS_MODEL } from "../tts/providers/alibaba-speech.js";
 import { resolveSpeechProviderChain } from "../tts/factory.js";
 import { mergeTtsConfigFromAppConfig } from "../tts/merge-config.js";
@@ -186,7 +187,21 @@ var VoiceRealtimeRuntime = class {
 		if (!omni && !stt) throw new VoiceSessionCreationError("PROVIDER_UNAVAILABLE", "No configured streaming speech-to-text provider is available", 503);
 		const inputMode = "server_vad";
 		if (stt && !stt.plugin.streamingAudio.turnDetection.includes(inputMode)) throw new VoiceSessionCreationError("PROVIDER_UNAVAILABLE", `Streaming speech-to-text provider does not support ${inputMode}`, 503);
-		const tts = request.mode === "assistant" ? resolveStreamingTts(config) : void 0;
+		const baseTts = request.mode === "assistant" ? resolveStreamingTts(config) : void 0;
+		const personalVoice = request.conversationId ? getPersonalAgentByConversation(request.conversationId)?.voicePreference : null;
+		const tts = baseTts && personalVoice && baseTts.route.provider === personalVoice.provider && baseTts.route.model === personalVoice.model ? {
+			...baseTts,
+			config: {
+				...baseTts.config,
+				providers: {
+					...baseTts.config.providers,
+					[baseTts.route.provider]: {
+						...baseTts.config.providers?.[baseTts.route.provider],
+						voice: personalVoice.voice
+					}
+				}
+			}
+		} : baseTts;
 		if (request.purpose === "conversation") {
 			if (!request.conversationId || !await this.options.sessionExists(request.conversationId)) throw new VoiceSessionCreationError("SESSION_NOT_FOUND", "Conversation session was not found", 404);
 			if (request.mode === "natural" && this.options.sessionBusy(request.conversationId)) throw new VoiceSessionCreationError("SESSION_CONFLICT", "Conversation session already has an active response", 409);