@xopcai/xopc 0.0.368 → 0.0.369

package/dist/src/home-intelligence/generator.d.ts

@@ -109,6 +109,8 @@ export declare const HomeModelResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject
 }, z.core.$strict>], "state">;
 export type HomeModelCandidate = z.infer<typeof HomeModelCandidateSchema>;
 export type HomeModelResult = z.infer<typeof HomeModelResultSchema>;
+/** Check prose rather than identifiers so English evidence cannot override Chinese output. */
+export declare function isHomeProseLocalized(values: readonly string[], locale: HomeContextSnapshot['locale']): boolean;
 export interface HomeModelGeneration {
     result: HomeModelResult;
     modelRef: string;

package/dist/src/home-intelligence/generator.js

@@ -102,7 +102,8 @@ function buildSystemPrompt(locale) {
 		"Prefer outcomes over feature promotion. Mention a connector or skill only when it materially enables the outcome.",
 		"When useful work remains possible without a missing capability, provide degradedActionPrompt using only supplied evidence.",
 		"External writes always require user confirmation.",
-		`Write only user-visible prose values such as title, rationale, steps, and prompts in ${locale === "zh" ? "Simplified Chinese" : "English"}. Machine values listed above must remain in English.`
+		`Write all user-visible prose values (title, outcome, rationale, proposedSteps, verification, actionPrompt, degradedActionPrompt, question, and option labels) in ${locale === "zh" ? "Simplified Chinese" : "English"}. Machine values listed above must remain in English. Translate English source material into the requested language; keep technical identifiers and proper names intact.`,
+		"Use plain text in prose values. Do not HTML-encode characters or include HTML markup."
 	].join("\n");
 }
 function extractHomeResponseText(response) {
@@ -126,6 +127,54 @@ function parseJson(raw) {
 	}
 	throw new Error("Home intelligence model did not return valid JSON");
 }
+function decodeProse(value) {
+	const named = {
+		amp: "&",
+		lt: "<",
+		gt: ">",
+		quot: "\"",
+		apos: "'",
+		nbsp: " "
+	};
+	return value.replace(/&(#x[0-9a-f]+|#\d+|amp|lt|gt|quot|apos|nbsp);/gi, (entity, code) => {
+		if (!code.startsWith("#")) return named[code.toLowerCase()] ?? entity;
+		const point = code.toLowerCase().startsWith("#x") ? parseInt(code.slice(2), 16) : Number(code.slice(1));
+		return point > 0 && point <= 1114111 && !(point >= 55296 && point <= 57343) ? String.fromCodePoint(point) : entity;
+	});
+}
+/** Check prose rather than identifiers so English evidence cannot override Chinese output. */
+function isHomeProseLocalized(values, locale) {
+	return locale !== "zh" || values.every((value) => !/[a-z]/i.test(value) || /\p{Script=Han}/u.test(value));
+}
+function parseLocalizedResult(raw, locale) {
+	const result = HomeModelResultSchema.parse(parseJson(raw));
+	const prose = [];
+	if (result.state === "ready") for (const candidate of result.candidates) {
+		candidate.title = decodeProse(candidate.title);
+		candidate.outcome = decodeProse(candidate.outcome);
+		candidate.rationale = decodeProse(candidate.rationale);
+		candidate.proposedSteps = candidate.proposedSteps.map(decodeProse);
+		candidate.verification = candidate.verification.map(decodeProse);
+		candidate.actionPrompt = decodeProse(candidate.actionPrompt);
+		if (candidate.degradedActionPrompt) candidate.degradedActionPrompt = decodeProse(candidate.degradedActionPrompt);
+		prose.push(candidate.title, candidate.outcome, candidate.rationale, candidate.actionPrompt);
+		prose.push(...[
+			...candidate.proposedSteps,
+			...candidate.verification,
+			candidate.degradedActionPrompt ?? ""
+		].filter((value) => (value.match(/[a-z]+/gi)?.length ?? 0) >= 3));
+	}
+	else if (result.state === "clarification") {
+		result.question = decodeProse(result.question);
+		result.options = result.options.map((option) => ({
+			...option,
+			label: decodeProse(option.label)
+		}));
+		prose.push(result.question, ...result.options.map((option) => option.label).filter((value) => (value.match(/[a-z]+/gi)?.length ?? 0) >= 3));
+	}
+	if (!isHomeProseLocalized(prose, locale)) throw new Error("User-visible prose must be in Simplified Chinese; translate English source material while preserving identifiers and evidence IDs");
+	return result;
+}
 function validationSummary(error) {
 	if (!(error instanceof z.ZodError)) return error instanceof Error ? error.message : String(error);
 	return error.issues.slice(0, 20).map((issue) => `${issue.path.join(".") || "<root>"}: ${issue.message}`).join("; ");
@@ -194,7 +243,7 @@ var HomeAdviceGenerator = class {
 		const raw = extractHomeResponseText(response);
 		let result;
 		try {
-			result = HomeModelResultSchema.parse(parseJson(raw));
+			result = parseLocalizedResult(raw, snapshot.locale);
 		} catch (firstError) {
 			const correction = {
 				role: "user",
@@ -221,7 +270,7 @@ var HomeAdviceGenerator = class {
 				trigger: "retry"
 			});
 			try {
-				result = HomeModelResultSchema.parse(parseJson(extractHomeResponseText(corrected)));
+				result = parseLocalizedResult(extractHomeResponseText(corrected), snapshot.locale);
 			} catch (correctionError) {
 				throw new Error(`Home intelligence model returned invalid structured JSON after correction: ${validationSummary(correctionError)}`);
 			}
@@ -239,4 +288,4 @@ var HomeAdviceGenerator = class {
 	}
 };
 //#endregion
-export { HomeAdviceBudgetExceededError, HomeAdviceGenerator, HomeModelCandidateSchema, HomeModelResultSchema };
+export { HomeAdviceBudgetExceededError, HomeAdviceGenerator, HomeModelCandidateSchema, HomeModelResultSchema, isHomeProseLocalized };

package/dist/src/home-intelligence/host.d.ts

@@ -35,12 +35,13 @@ export declare class HomeIntelligenceHost {
     private stopped;
     private abortController;
     private localeHint;
+    private advisorLocale;
     private contextRefreshTimer?;
     private readonly pendingContextReasons;
     constructor(db: DatabaseSync, deps: HomeIntelligenceHostDeps);
     start(): void;
     stop(): void;
-    getAdvisor(): HomeAdvisor;
+    getAdvisor(locale?: string): HomeAdvisor;
     getMetrics(since?: number): HomeAdviceMetrics;
     getHistory(): HomeOpportunityHistoryItem[];
     requestRefresh(reason: HomeGenerationReason, idempotencyKey?: string, locale?: string): string;

package/dist/src/home-intelligence/host.js

@@ -1,6 +1,6 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { HomeAdviceBudgetExceededError } from "./generator.js";
+import { HomeAdviceBudgetExceededError, isHomeProseLocalized } from "./generator.js";
 import { homePatternKey } from "./strategy.js";
 import { HomeAdvicePolicy } from "./policy.js";
 import { HomeIntelligenceRepository } from "./repository.js";
@@ -39,6 +39,7 @@ var HomeIntelligenceHost = class {
 	stopped = false;
 	abortController = new AbortController();
 	localeHint;
+	advisorLocale;
 	contextRefreshTimer;
 	pendingContextReasons = /* @__PURE__ */ new Set();
 	constructor(db, deps) {
@@ -47,6 +48,7 @@ var HomeIntelligenceHost = class {
 		this.opportunities = new HomeOpportunityApplicationService(db, deps.principal, () => deps.capabilities().agentId);
 		this.now = deps.now ?? Date.now;
 		this.localeHint = deps.locale();
+		this.advisorLocale = this.localeHint;
 	}
 	start() {
 		if (this.timer) return;
@@ -65,9 +67,26 @@ var HomeIntelligenceHost = class {
 		this.contextRefreshTimer = void 0;
 		this.pendingContextReasons.clear();
 	}
-	getAdvisor() {
+	getAdvisor(locale) {
 		if (this.deps.enabled?.() === false) return { state: "disabled" };
-		return this.repository.getAdvisor(this.deps.principal, this.now());
+		if (locale) {
+			const requestedLocale = locale.toLowerCase().startsWith("zh") ? "zh" : "en";
+			if (requestedLocale !== this.localeHint) this.requestRefresh("manual_refresh", `locale:${requestedLocale}:${this.now()}`, requestedLocale);
+		}
+		const advisor = this.repository.getAdvisor(this.deps.principal, this.now());
+		const prose = advisor.state === "ready" ? [advisor.primary, ...advisor.alternatives].flatMap((item) => [
+			item.title,
+			item.outcome,
+			item.rationale
+		]) : advisor.state === "clarification" ? [advisor.question.question] : [];
+		if (prose.length > 0 && this.advisorLocale !== this.localeHint || !isHomeProseLocalized(prose, this.localeHint)) return advisor.state === "ready" && advisor.stale ? {
+			state: "refreshing",
+			requestedAt: this.now()
+		} : {
+			state: "quiet",
+			reason: "generation_failed"
+		};
+		return advisor;
 	}
 	getMetrics(since = Math.max(0, this.now() - 720 * 60 * 6e4)) {
 		return this.repository.getMetrics(this.deps.principal, since, this.now());
@@ -251,6 +270,7 @@ var HomeIntelligenceHost = class {
 				outcomeReason: result.state === "quiet" ? result.reason : result.state,
 				completedAt
 			});
+			this.advisorLocale = snapshot.locale;
 			this.deps.publish("home.advisor.updated", {
 				state: result.state,
 				completedAt

package/dist/src/migrations/cloud-public-models.js

@@ -36,6 +36,7 @@ function migrateCloudModelRef(ref, kind = "language") {
 	if (!ref.startsWith("xopc-cloud/")) return ref;
 	const id = ref.slice(11);
 	if (PUBLIC_IDS.has(id) || id.startsWith("openai-codex/")) return ref;
+	if (id === "computer-gui-plus-preview" || id === "gui-plus-2026-02-26") return "xopc-cloud/computer";
 	return `xopc-cloud/${kind === "omni" ? "realtime" : kind === "language" ? "auto" : kind}`;
 }
 /** Only model fields are rewritten; prompts and historical transcripts are untouched. */

package/dist/src/notifications/clarification.d.ts

@@ -0,0 +1,5 @@
+import type { ProductNotification } from '@xopcai/gateway-contract';
+import type { NotificationPlan } from './planner.js';
+export declare function isClarificationNotificationActionable(notification: Pick<ProductNotification, 'type' | 'payload' | 'target'>): boolean;
+/** Wait creation and intent insertion commit together; publication and settlement do too. */
+export declare function flushClarificationNotifications(persist: (plan: NotificationPlan) => ProductNotification | null): ProductNotification[];

package/dist/src/notifications/clarification.js

@@ -0,0 +1,66 @@
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { init_session_instance_repository, readCurrentTranscriptId } from "../storage/sqlite/session-instance-repository.js";
+import { getClarification, init_clarification_wait_repository } from "../storage/sqlite/clarification-wait-repository.js";
+//#region src/notifications/clarification.ts
+init_clarification_wait_repository();
+init_session_instance_repository();
+init_transaction();
+function isClarificationNotificationActionable(notification) {
+	if (notification.type !== "chat.needs_input") return true;
+	const wait = typeof notification.payload.waitId === "string" ? getClarification(notification.payload.waitId) : void 0;
+	return Boolean(wait && wait.status === "open" && notification.target.kind === "chat" && notification.target.conversationId === wait.conversationId && readCurrentTranscriptId(getSqliteDatabase(), wait.conversationId) === wait.transcriptId && (wait.expiresAt === void 0 || wait.expiresAt > Date.now()));
+}
+/** Wait creation and intent insertion commit together; publication and settlement do too. */
+function flushClarificationNotifications(persist) {
+	return runSqliteWriteTransaction((db) => {
+		const rows = db.prepare(`SELECT wait_id FROM clarification_notification_outbox
+      WHERE status = 'pending' ORDER BY created_at, wait_id LIMIT 100`).all();
+		const published = [];
+		for (const row of rows) {
+			const wait = getClarification(String(row.wait_id));
+			if (wait && !wait.taskRunId) {
+				const personal = db.prepare("SELECT json_extract(custom_data_json, '$.personalAgent') AS personal FROM sessions WHERE conversation_id = ?").get(wait.conversationId)?.personal === 1;
+				const notification = {
+					type: "chat.needs_input",
+					target: {
+						kind: "chat",
+						conversationId: wait.conversationId,
+						...personal ? { personal: true } : {}
+					},
+					priority: "high",
+					title: wait.kind === "approval" ? {
+						en: "Your authorization is needed",
+						zh: "需要你的授权"
+					} : {
+						en: "Your decision is needed",
+						zh: "需要你判断后继续"
+					},
+					body: {
+						en: "A question is waiting for your answer. Open the conversation to continue.",
+						zh: "有一个问题等待你回答，点击继续。"
+					},
+					payload: {
+						waitId: wait.id,
+						transcriptId: wait.transcriptId,
+						originRunId: wait.originRunId,
+						objectiveRevision: wait.objectiveRevision,
+						kind: wait.kind,
+						expiresAt: wait.expiresAt
+					}
+				};
+				if (isClarificationNotificationActionable(notification)) {
+					const event = persist({
+						dedupeKey: `clarification.needs_input:${wait.id}`,
+						createdAt: wait.createdAt,
+						notification
+					});
+					if (event) published.push(event);
+				}
+			}
+			db.prepare("UPDATE clarification_notification_outbox SET status = 'settled' WHERE wait_id = ?").run(row.wait_id);
+		}
+		return published;
+	});
+}
+//#endregion
+export { flushClarificationNotifications, isClarificationNotificationActionable };

package/dist/src/notifications/device-store.js

@@ -13,6 +13,7 @@ function parsePreferences(raw) {
 }
 function normalizePreferences(input) {
 	return {
+		chatNeedsInput: input?.chatNeedsInput ?? DEFAULT_NOTIFICATION_PREFERENCES.chatNeedsInput,
 		chatCompleted: input?.chatCompleted ?? DEFAULT_NOTIFICATION_PREFERENCES.chatCompleted,
 		chatFailed: input?.chatFailed ?? DEFAULT_NOTIFICATION_PREFERENCES.chatFailed,
 		taskNeedsInput: input?.taskNeedsInput ?? DEFAULT_NOTIFICATION_PREFERENCES.taskNeedsInput,

package/dist/src/notifications/harmony-push.d.ts

@@ -18,6 +18,7 @@ export type HarmonyNotification = {
     body?: string;
     gatewayId?: string;
     target?: NotificationTarget;
+    expiresAt?: number;
 };
 export declare function harmonyPushConfig(env?: NodeJS.ProcessEnv): HarmonyPushConfig | undefined;
 export declare function createHarmonyPushJwt(account: ServiceAccount, now?: number): string;

package/dist/src/notifications/harmony-push.js

@@ -54,6 +54,8 @@ async function sendHarmonyPush(notification, fetchImpl = fetch, config = harmony
 		eventId: notification.eventId,
 		target: notification.target
 	})).toString("base64url") : void 0;
+	const ttl = notification.expiresAt === void 0 ? 86400 : Math.min(86400, Math.floor((notification.expiresAt - Date.now()) / 1e3));
+	if (ttl <= 0) throw new Error("Notification expired before delivery");
 	const response = await fetchImpl(`https://push-api.cloud.huawei.com/v3/${account.project_id}/messages:send`, {
 		method: "POST",
 		redirect: "error",
@@ -78,7 +80,7 @@ async function sendHarmonyPush(notification, fetchImpl = fetch, config = harmony
 			target: { token: [notification.pushToken] },
 			pushOptions: {
 				testMessage: config.testMessage,
-				ttl: 86400
+				ttl
 			}
 		})
 	});

package/dist/src/notifications/planner.d.ts

@@ -1,5 +1,6 @@
 import { type ProductNotification } from '@xopcai/gateway-contract';
 export type NotificationPlan = {
+    createdAt?: number;
     dedupeKey: string;
     notification: Omit<ProductNotification, 'schemaVersion' | 'id' | 'createdAt'>;
 };

package/dist/src/notifications/service.d.ts

@@ -21,7 +21,7 @@ export declare class NotificationService {
     persistGatewayEvent(type: string, payload: unknown): {
         schemaVersion: 1;
         id: string;
-        type: "work_discovery.completed" | "work_discovery.failed" | "scene.result" | "scene.digest" | "chat.completed" | "chat.failed" | "task.needs_input" | "task.blocked" | "task.failed" | "task.completed" | "automation.completed" | "automation.failed" | "home.opportunity";
+        type: "work_discovery.completed" | "work_discovery.failed" | "scene.result" | "scene.digest" | "chat.needs_input" | "chat.completed" | "chat.failed" | "task.needs_input" | "task.blocked" | "task.failed" | "task.completed" | "automation.completed" | "automation.failed" | "home.opportunity";
         priority: "normal" | "high";
         title: {
             en: string;
@@ -62,7 +62,7 @@ export declare class NotificationService {
     persistPlan(plan: NotificationPlan): {
         schemaVersion: 1;
         id: string;
-        type: "work_discovery.completed" | "work_discovery.failed" | "scene.result" | "scene.digest" | "chat.completed" | "chat.failed" | "task.needs_input" | "task.blocked" | "task.failed" | "task.completed" | "automation.completed" | "automation.failed" | "home.opportunity";
+        type: "work_discovery.completed" | "work_discovery.failed" | "scene.result" | "scene.digest" | "chat.needs_input" | "chat.completed" | "chat.failed" | "task.needs_input" | "task.blocked" | "task.failed" | "task.completed" | "automation.completed" | "automation.failed" | "home.opportunity";
         priority: "normal" | "high";
         title: {
             en: string;

package/dist/src/notifications/service.js

@@ -4,13 +4,14 @@ import { init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/t
 import { localizeNotification } from "../../packages/gateway-contract/src/notifications.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
 import { getOrCreateGatewayIdentity, init_gateway_identity_repository } from "../storage/sqlite/gateway-identity-repository.js";
-import { listDeliverableNotificationDevices } from "./device-store.js";
+import { getNotificationDevice, listDeliverableNotificationDevices } from "./device-store.js";
 import { notificationPlanFromGatewayEvent } from "./planner.js";
-import { createNotificationEvent, deferNotificationDelivery, expireUndeliverableNotificationDeliveries, listDueNotificationDeliveries, markNotificationDeliveryAccepted, markNotificationDeliveryDead, pruneNotificationEvents, rescheduleNotificationDelivery } from "./store.js";
+import { cancelNotificationDelivery, createNotificationEvent, deferNotificationDelivery, expireUndeliverableNotificationDeliveries, listDueNotificationDeliveries, markNotificationDeliveryAccepted, markNotificationDeliveryDead, pruneNotificationEvents, rescheduleNotificationDelivery } from "./store.js";
 import { sendHarmonyPush } from "./harmony-push.js";
+import { flushClarificationNotifications, isClarificationNotificationActionable } from "./clarification.js";
 //#region src/notifications/service.ts
-init_transaction();
 init_src();
+init_transaction();
 init_logger();
 init_gateway_identity_repository();
 const log = createLogger("Notifications");
@@ -23,6 +24,7 @@ const RETRY_DELAYS_MS = [
 	216e5
 ];
 const STANDARD_PREFERENCES = {
+	"chat.needs_input": "chatNeedsInput",
 	"chat.completed": "chatCompleted",
 	"chat.failed": "chatFailed",
 	"task.needs_input": "taskNeedsInput",
@@ -62,6 +64,10 @@ var NotificationService = class {
 	}
 	handleGatewayEvent(type, payload) {
 		try {
+			if (type === "clarification.created") {
+				this.drain();
+				return;
+			}
 			const notification = this.persistGatewayEvent(type, payload);
 			if (!notification) return;
 			this.options.publish("notification.created", notification);
@@ -108,6 +114,7 @@ var NotificationService = class {
 				pruneNotificationEvents(now - 720 * 60 * 60 * 1e3);
 				this.lastMaintenanceAt = now;
 			}
+			for (const notification of flushClarificationNotifications((plan) => this.persistPlan(plan))) this.options.publish("notification.created", notification);
 			for (const notification of this.options.domainDelivery?.flush((plan) => this.persistPlan(plan)) ?? []) this.options.publish("notification.created", notification);
 			await this.deliverPending();
 			await this.options.domainDelivery?.drain();
@@ -126,10 +133,18 @@ var NotificationService = class {
 		await Promise.all(deliveries.map((delivery) => this.send(delivery)));
 	}
 	async send(delivery) {
+		if (!isClarificationNotificationActionable(delivery.event)) {
+			cancelNotificationDelivery(delivery.event.id, delivery.deviceId);
+			return;
+		}
 		if (this.options.allowsNotification?.(delivery.event) === false) {
 			markNotificationDeliveryDead(delivery.event.id, delivery.deviceId, "Notification policy changed");
 			return;
 		}
+		if (delivery.event.type === "chat.needs_input" && !getNotificationDevice(delivery.deviceId)?.preferences.chatNeedsInput) {
+			cancelNotificationDelivery(delivery.event.id, delivery.deviceId);
+			return;
+		}
 		const domain = this.options.domainDelivery?.owns(delivery.event.type) ? this.options.domainDelivery : void 0;
 		if (!domain && !Object.hasOwn(STANDARD_PREFERENCES, delivery.event.type)) {
 			markNotificationDeliveryDead(delivery.event.id, delivery.deviceId, "Notification domain delivery is not installed");
@@ -163,7 +178,8 @@ var NotificationService = class {
 				gatewayId: getOrCreateGatewayIdentity().id,
 				target: delivery.event.target,
 				title: preview.title,
-				body: preview.body
+				body: preview.body,
+				...delivery.event.type === "chat.needs_input" && typeof delivery.event.payload.expiresAt === "number" ? { expiresAt: delivery.event.payload.expiresAt } : {}
 			}, fetchImpl);
 			markNotificationDeliveryAccepted(delivery.event.id, delivery.deviceId, ticket, Number.MAX_SAFE_INTEGER);
 		} catch (err) {

package/dist/src/notifications/store.d.ts

@@ -38,6 +38,7 @@ export declare function notificationDeliveryMetrics(): {
     accepted: number;
     delivered: number;
     dead: number;
+    cancelled: number;
     due: number;
     devices: {
         deliverable: number;
@@ -56,3 +57,4 @@ export declare function expireUndeliverableNotificationDeliveries(now?: number):
 export declare function pruneNotificationEvents(before: number): number;
 export declare function deferNotificationDelivery(eventId: string, deviceId: string, nextAttemptAt: number): void;
 export declare function getNotificationEvent(id: string): ProductNotification | null;
+export declare function cancelNotificationDelivery(eventId: string, deviceId: string): void;

package/dist/src/notifications/store.js

@@ -149,6 +149,7 @@ function notificationDeliveryMetrics() {
 		accepted: counts.accepted ?? 0,
 		delivered: counts.delivered ?? 0,
 		dead: counts.dead ?? 0,
+		cancelled: counts.cancelled ?? 0,
 		due: due.count,
 		devices: {
 			deliverable: devices.deliverable ?? 0,
@@ -190,5 +191,10 @@ function getNotificationEvent(id) {
 	const row = getSqliteDatabase().prepare("SELECT * FROM notification_events WHERE event_id = ?").get(id);
 	return row ? eventFromRow(row) : null;
 }
+function cancelNotificationDelivery(eventId, deviceId) {
+	getSqliteDatabase().prepare(`UPDATE notification_deliveries SET status = 'cancelled',
+    last_error = 'Clarification is no longer actionable', updated_at = ?
+    WHERE event_id = ? AND device_id = ? AND status = 'pending'`).run(Date.now(), eventId, deviceId);
+}
 //#endregion
-export { acknowledgeNotification, createNotificationEvent, deferNotificationDelivery, expireUndeliverableNotificationDeliveries, getNotificationEvent, listDueNotificationDeliveries, listNotificationEvents, markNotificationDeliveryAccepted, markNotificationDeliveryDead, markNotificationDeliveryDelivered, notificationDeliveryMetrics, pruneNotificationEvents, rescheduleNotificationDelivery };
+export { acknowledgeNotification, cancelNotificationDelivery, createNotificationEvent, deferNotificationDelivery, expireUndeliverableNotificationDeliveries, getNotificationEvent, listDueNotificationDeliveries, listNotificationEvents, markNotificationDeliveryAccepted, markNotificationDeliveryDead, markNotificationDeliveryDelivered, notificationDeliveryMetrics, pruneNotificationEvents, rescheduleNotificationDelivery };

package/dist/src/notifications/types.d.ts

@@ -2,6 +2,7 @@ export type NotificationDevicePlatform = 'ios' | 'android' | 'harmonyos';
 export type NotificationPermission = 'granted' | 'denied' | 'unknown';
 export type NotificationLanguage = 'en' | 'zh';
 export type NotificationPreferences = {
+    chatNeedsInput: boolean;
     chatCompleted: boolean;
     chatFailed: boolean;
     taskNeedsInput: boolean;

package/dist/src/notifications/types.js

@@ -1,5 +1,6 @@
 //#region src/notifications/types.ts
 const DEFAULT_NOTIFICATION_PREFERENCES = {
+	chatNeedsInput: true,
 	chatCompleted: true,
 	chatFailed: true,
 	taskNeedsInput: true,

package/dist/src/storage/sqlite/clarification-wait-repository.js

@@ -185,6 +185,7 @@ function createClarificationWait(input) {
         id, principal_id, conversation_id, transcript_id, status, version, data_json,
         origin_run_id, origin_tool_call_id
       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(wait.id, wait.principalId, wait.conversationId, wait.transcriptId, wait.status, wait.version, JSON.stringify(wait), wait.originRunId, wait.originToolCallId);
+		db.prepare("INSERT INTO clarification_notification_outbox(wait_id, created_at) VALUES (?, ?)").run(wait.id, wait.createdAt);
 		markTaskWaiting(wait);
 		bumpSessionInputRevision(db, input.conversationId);
 		return wait;

package/dist/src/storage/sqlite/migrations/238_browser_record_replay.sql

@@ -0,0 +1,45 @@
+CREATE TABLE browser_automation_versions (
+  automation_id TEXT NOT NULL REFERENCES browser_automations(automation_id) ON DELETE CASCADE,
+  revision INTEGER NOT NULL,
+  definition_json TEXT NOT NULL,
+  created_at_ms INTEGER NOT NULL,
+  PRIMARY KEY (automation_id, revision)
+);
+INSERT INTO browser_automation_versions SELECT automation_id, revision, definition_json, updated_at_ms FROM browser_automations;
+
+CREATE TABLE browser_automation_verifications (
+  automation_id TEXT NOT NULL,
+  revision INTEGER NOT NULL,
+  run_id TEXT NOT NULL REFERENCES browser_automation_runs(run_id) ON DELETE CASCADE,
+  verified_at_ms INTEGER NOT NULL,
+  PRIMARY KEY (automation_id, revision),
+  FOREIGN KEY (automation_id, revision) REFERENCES browser_automation_versions(automation_id, revision) ON DELETE CASCADE
+);
+ALTER TABLE browser_automation_runs ADD COLUMN client_request_id TEXT;
+ALTER TABLE browser_automation_runs ADD COLUMN business_outcome TEXT;
+CREATE UNIQUE INDEX idx_browser_run_request ON browser_automation_runs(client_request_id) WHERE client_request_id IS NOT NULL;
+
+CREATE TABLE browser_recordings (
+  recording_id TEXT PRIMARY KEY,
+  principal_id TEXT NOT NULL,
+  state TEXT NOT NULL,
+  ack_seq INTEGER NOT NULL DEFAULT 0,
+  final_seq INTEGER,
+  automation_id TEXT REFERENCES browser_automations(automation_id) ON DELETE CASCADE,
+  error TEXT,
+  created_at_ms INTEGER NOT NULL,
+  updated_at_ms INTEGER NOT NULL
+);
+CREATE TABLE browser_recording_events (
+  recording_id TEXT NOT NULL REFERENCES browser_recordings(recording_id) ON DELETE CASCADE,
+  seq INTEGER NOT NULL,
+  event_id TEXT NOT NULL UNIQUE,
+  payload_json TEXT NOT NULL,
+  PRIMARY KEY (recording_id, seq)
+);
+
+UPDATE automations SET action_json=json_set(action_json, '$.revision', COALESCE((SELECT revision FROM browser_automations WHERE automation_id=json_extract(automations.action_json, '$.automationId')), 1)), enabled=0
+WHERE json_extract(action_json, '$.kind')='browser_automation';
+
+UPDATE devices SET scopes_json=json_insert(scopes_json, '$[#]', 'automations.read') WHERE platform='chrome' AND NOT EXISTS(SELECT 1 FROM json_each(scopes_json) WHERE value='automations.read');
+UPDATE devices SET scopes_json=json_insert(scopes_json, '$[#]', 'automations.write') WHERE platform='chrome' AND NOT EXISTS(SELECT 1 FROM json_each(scopes_json) WHERE value='automations.write');

package/dist/src/storage/sqlite/migrations/239_clarification_notifications.sql

@@ -0,0 +1,26 @@
+CREATE TABLE clarification_notification_outbox (
+  wait_id TEXT PRIMARY KEY REFERENCES session_clarification_waits(id) ON DELETE CASCADE,
+  status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending', 'settled')),
+  created_at INTEGER NOT NULL
+);
+CREATE INDEX idx_clarification_notification_pending ON clarification_notification_outbox(status, created_at);
+INSERT INTO clarification_notification_outbox(wait_id, created_at)
+SELECT id, CAST(json_extract(data_json, '$.createdAt') AS INTEGER)
+FROM session_clarification_waits WHERE status = 'open';
+
+ALTER TABLE notification_deliveries RENAME TO notification_deliveries_old;
+CREATE TABLE notification_deliveries (
+  event_id TEXT NOT NULL REFERENCES notification_events(event_id) ON DELETE CASCADE,
+  device_id TEXT NOT NULL REFERENCES device_push_endpoints(device_id) ON DELETE CASCADE,
+  status TEXT NOT NULL CHECK(status IN ('pending', 'accepted', 'delivered', 'dead', 'cancelled')),
+  attempts INTEGER NOT NULL DEFAULT 0,
+  next_attempt_at INTEGER NOT NULL,
+  provider_ticket_id TEXT,
+  last_error TEXT,
+  updated_at INTEGER NOT NULL,
+  PRIMARY KEY(event_id, device_id)
+);
+INSERT INTO notification_deliveries SELECT * FROM notification_deliveries_old;
+DROP TABLE notification_deliveries_old;
+CREATE INDEX idx_notification_deliveries_due ON notification_deliveries(status, next_attempt_at);
+CREATE INDEX idx_notification_deliveries_device ON notification_deliveries(device_id);

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

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

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

package/dist/src/tasks/home-query-service.d.ts

@@ -58,7 +58,7 @@ export declare class HomeQueryService {
     #private;
     private readonly service;
     private readonly getAdvisor;
-    constructor(service: HomeGatewayPort, getAdvisor?: () => HomeAdvisor);
+    constructor(service: HomeGatewayPort, getAdvisor?: (locale?: string) => HomeAdvisor);
     getSnapshot(locale?: string): Promise<HomeResponse>;
 }
 export {};

package/dist/src/tasks/home-query-service.js

@@ -104,7 +104,11 @@ function decisionFromTask(model, projectName, locale) {
 		},
 		kind: "task",
 		title: task.title,
-		detail: item.summary,
+		detail: isChinese ? {
+			"Agent run returned no result or evidence": "本次执行没有返回结果或依据，请重试。",
+			"The latest run failed": "最近一次执行失败，请查看详情后重试。",
+			"Task is overdue": "任务已逾期。"
+		}[item.summary] ?? item.summary : item.summary,
 		reason,
 		urgency: "now",
 		href: `/tasks/${encodeURIComponent(task.id)}`,
@@ -412,7 +416,7 @@ var HomeQueryService = class {
 			}),
 			runningConversations,
 			decisions,
-			advisor: this.getAdvisor(),
+			advisor: this.getAdvisor(locale),
 			attentionPolicy: governed.policy
 		};
 	}

package/dist/src/voice/dashscope/streaming-tts-stream.d.ts

@@ -1,4 +1,4 @@
-import type { SpeechSynthesisStreamResult } from '../tts/speech-provider-types.js';
+import type { SpeechStreamSession, SpeechSynthesisStreamResult } from '../tts/speech-provider-types.js';
 export interface DashScopeStreamingTtsRequest {
     apiKey: string;
     baseUrl?: string;
@@ -11,3 +11,4 @@ export interface DashScopeStreamingTtsRequest {
     timeoutMs: number;
 }
 export declare function openDashScopeStreamingTts(request: DashScopeStreamingTtsRequest): Promise<SpeechSynthesisStreamResult>;
+export declare function openDashScopeTtsSession(request: Omit<DashScopeStreamingTtsRequest, 'text'>): Promise<SpeechStreamSession>;