@xopcai/xopc 0.0.367 → 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.d.ts

@@ -0,0 +1,7 @@
+type Kind = 'language' | 'image' | 'stt' | 'tts' | 'omni' | 'computer';
+export declare function migrateCloudModelRef(ref: string, kind?: Kind): string;
+/** Only model fields are rewritten; prompts and historical transcripts are untouched. */
+export declare function migrateCloudModelFields(value: unknown, kind?: Kind, cloud?: boolean, modelField?: boolean): unknown;
+/** Replayable file phase followed by a transactional database phase and completion marker. */
+export declare function migrateCloudPublicModelsSync(configPath: string): boolean;
+export {};

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

@@ -0,0 +1,157 @@
+import { init_paths_state, resolveXopcCloudCatalogCachePath } from "../config/paths-state.js";
+import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { init_sqlite } from "../storage/sqlite/index.js";
+import { init_write_file_atomic, writeTextAtomicSync } from "../infra/write-file-atomic.js";
+import { ModelCatalogPersistence, init_model_catalog_persistence } from "../providers/model-catalog-persistence.js";
+import { createWorkflowCatalog } from "../agent/workflow/catalog.js";
+import { dirname } from "node:path";
+import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync } from "node:fs";
+import { randomUUID } from "node:crypto";
+//#region src/migrations/cloud-public-models.ts
+init_paths_state();
+init_write_file_atomic();
+init_sqlite();
+init_model_catalog_persistence();
+const MIGRATION_ID = "cloud-public-models-v1";
+const PUBLIC_IDS = new Set([
+	"auto",
+	"advanced",
+	"image",
+	"stt",
+	"tts",
+	"realtime",
+	"computer"
+]);
+const MODEL_FIELDS = new Set([
+	"model",
+	"modelRef",
+	"modelOverride",
+	"primary",
+	"fallbacks",
+	"imageGeneration",
+	"imageUnderstanding",
+	"computerUse"
+]);
+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. */
+function migrateCloudModelFields(value, kind = "language", cloud = false, modelField = false) {
+	if (typeof value === "string") {
+		if (!modelField) return value;
+		const next = migrateCloudModelRef(cloud && !value.includes("/") ? `xopc-cloud/${value}` : value, kind);
+		return cloud && !value.includes("/") ? next.replace(/^xopc-cloud\//, "") : next;
+	}
+	if (Array.isArray(value)) {
+		const next = value.map((item) => migrateCloudModelFields(item, kind, cloud, modelField));
+		return modelField && next.some((item, index) => item !== value[index]) ? [...new Set(next)] : next;
+	}
+	if (!value || typeof value !== "object") return value;
+	const source = value;
+	const explicitProvider = source.provider ?? source.providerOverride;
+	const isCloud = typeof explicitProvider === "string" ? explicitProvider === "xopc-cloud" : cloud;
+	const result = {};
+	for (const [key, item] of Object.entries(source)) {
+		if (key === "providers" && item && typeof item === "object" && !Array.isArray(item)) {
+			result[key] = Object.fromEntries(Object.entries(item).map(([provider, settings]) => [provider, migrateCloudModelFields(settings, kind, provider === "xopc-cloud")]));
+			continue;
+		}
+		result[key] = migrateCloudModelFields(item, key === "imageGeneration" ? "image" : key === "computerUse" ? "computer" : key === "summarization" || key === "refinement" ? "language" : key === "stt" || key === "audio" ? "stt" : key === "tts" ? "tts" : key === "omni" ? "omni" : kind, isCloud || key === "xopc-cloud", MODEL_FIELDS.has(key));
+	}
+	if (isCloud && (kind === "tts" || kind === "omni") && (source.voice !== void 0 || typeof source.model === "string")) result.voice = "default";
+	if (typeof result.primary === "string" && result.primary.startsWith("xopc-cloud/") && (result.primary !== source.primary || JSON.stringify(result.fallbacks) !== JSON.stringify(source.fallbacks)) && Array.isArray(result.fallbacks)) result.fallbacks = result.fallbacks.filter((ref) => ref !== result.primary);
+	return result;
+}
+/** Replayable file phase followed by a transactional database phase and completion marker. */
+function migrateCloudPublicModelsSync(configPath) {
+	const db = getSqliteDatabase();
+	if (db.prepare("SELECT 1 FROM application_migrations WHERE id = ? AND state = ?").get(MIGRATION_ID, "complete")) return false;
+	const now = Date.now();
+	const databaseBackup = `${configPath}.${MIGRATION_ID}.sqlite.bak`;
+	if (!existsSync(databaseBackup)) {
+		mkdirSync(dirname(databaseBackup), {
+			recursive: true,
+			mode: 448
+		});
+		const temporary = `${databaseBackup}.${randomUUID()}.tmp`;
+		try {
+			db.prepare("VACUUM INTO ?").run(temporary);
+			chmodSync(temporary, 384);
+			renameSync(temporary, databaseBackup);
+		} finally {
+			rmSync(temporary, { force: true });
+		}
+	}
+	const configBackup = `${configPath}.${MIGRATION_ID}.bak`;
+	if (existsSync(configPath)) {
+		const raw = readFileSync(configPath, "utf8");
+		const next = JSON.stringify(migrateCloudModelFields(JSON.parse(raw)), null, 2) + "\n";
+		if (JSON.stringify(JSON.parse(raw)) !== JSON.stringify(JSON.parse(next))) {
+			if (!existsSync(configBackup)) copyFileSync(configPath, configBackup);
+			writeTextAtomicSync(configPath, next);
+		}
+	}
+	const cache = resolveXopcCloudCatalogCachePath();
+	if (existsSync(cache) && !existsSync(`${cache}.${MIGRATION_ID}.bak`)) copyFileSync(cache, `${cache}.${MIGRATION_ID}.bak`);
+	new ModelCatalogPersistence().clearSync();
+	return runSqliteWriteTransaction(() => {
+		if (db.prepare("SELECT 1 FROM application_migrations WHERE id = ? AND state = ?").get(MIGRATION_ID, "complete")) return false;
+		const migrateJson = (table, key, column, where = "") => {
+			const rows = db.prepare(`SELECT ${key} AS id, ${column} AS payload FROM ${table} ${where}`).all();
+			for (const row of rows) {
+				const before = JSON.parse(row.payload);
+				const next = JSON.stringify(migrateCloudModelFields(before));
+				if (JSON.stringify(before) !== next) {
+					const revision = table === "agents" || table === "agent_catalog_settings" ? ", revision = revision + 1, updated_at = " + now : "";
+					db.prepare(`UPDATE ${table} SET ${column} = ? ${revision} WHERE ${key} = ?`).run(next, row.id);
+				}
+			}
+		};
+		migrateJson("agent_catalog_settings", "singleton_id", "defaults_json");
+		migrateJson("agents", "id", "overrides_json", "WHERE deleted_at IS NULL");
+		migrateJson("automations", "automation_id", "action_json");
+		const rows = db.prepare("SELECT rowid AS id, payload FROM durable_state WHERE namespace IN ('workflow-drafts')").all();
+		for (const row of rows) {
+			const before = JSON.parse(row.payload);
+			const next = JSON.stringify(migrateCloudModelFields(before));
+			if (JSON.stringify(before) !== next) db.prepare("UPDATE durable_state SET payload = ? WHERE rowid = ?").run(next, row.id);
+		}
+		const catalog = createWorkflowCatalog();
+		for (const entry of catalog.list().filter((item) => item.source === "user")) {
+			const definition = catalog.load(entry.name);
+			const graph = migrateCloudModelFields(definition.graph);
+			if (JSON.stringify(graph) !== JSON.stringify(definition.graph)) {
+				const { graph: _graph, metadata: _metadata, contentHash: _hash, revision: _revision, ...manifest } = definition;
+				catalog.save({
+					name: entry.name,
+					graph,
+					manifest: {
+						...manifest,
+						tags: definition.metadata.tags,
+						whenToUse: definition.metadata.whenToUse,
+						estimatedAgents: definition.metadata.estimatedAgents,
+						examplePrompts: definition.metadata.examplePrompts,
+						i18n: definition.metadata.i18n
+					},
+					expectedRevision: definition.revision
+				});
+			}
+		}
+		const sessions = db.prepare("SELECT conversation_id, model_override, provider_override FROM session_config WHERE model_override IS NOT NULL").all();
+		for (const row of sessions) {
+			const ref = row.provider_override === "xopc-cloud" && !row.model_override.includes("/") ? `xopc-cloud/${row.model_override}` : row.model_override;
+			const migrated = migrateCloudModelRef(ref);
+			const next = ref === row.model_override ? migrated : migrated.replace(/^xopc-cloud\//, "");
+			if (next !== row.model_override) db.prepare("UPDATE session_config SET model_override = ?, updated_at = ? WHERE conversation_id = ?").run(next, now, row.conversation_id);
+		}
+		db.prepare(`INSERT INTO application_migrations(id,state,source_backup_path,database_backup_path,started_at,completed_at,updated_at)
+      VALUES(?,?,?,?,?,?,?) ON CONFLICT(id) DO UPDATE SET state=excluded.state, completed_at=excluded.completed_at, updated_at=excluded.updated_at`).run(MIGRATION_ID, "complete", existsSync(configBackup) ? configBackup : null, databaseBackup, now, now, now);
+		return true;
+	});
+}
+//#endregion
+export { migrateCloudModelFields, migrateCloudModelRef, migrateCloudPublicModelsSync };

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/providers/model-catalog-persistence.js

@@ -112,7 +112,7 @@ var init_model_catalog_persistence = __esmMin((() => {
 		tts: ttsSchema.optional()
 	}).strict();
 	persistedCatalogSchema = z.object({
-		schemaVersion: z.literal(1),
+		schemaVersion: z.literal(2),
 		providerId: z.literal("xopc-cloud"),
 		catalogVersion: z.string().nullable(),
 		fetchedAt: z.number().int().nonnegative(),
@@ -156,7 +156,7 @@ var init_model_catalog_persistence = __esmMin((() => {
 		async save(source) {
 			if (source.providerId !== "xopc-cloud") throw new Error(`Cannot persist catalog for provider ${source.providerId}`);
 			const payload = persistedCatalogSchema.parse({
-				schemaVersion: 1,
+				schemaVersion: 2,
 				providerId: source.providerId,
 				catalogVersion: source.etag,
 				fetchedAt: source.lastSuccessAt,

package/dist/src/providers/presentation.js

@@ -76,6 +76,7 @@ const PROVIDER_HINTS = {
 	"google-antigravity": "Gemini/Antigravity OAuth model access."
 };
 const RECOMMENDED_MODEL_PATTERNS = {
+	"xopc-cloud": [/^auto$/],
 	openai: [
 		/^gpt-5\.6$/i,
 		/^gpt-5\.6-sol$/i,

package/dist/src/providers/xopc-cloud-model-source.js

@@ -90,7 +90,7 @@ var XopcCloudModelSource = class {
 				baseUrl: this.routerUrl,
 				api: "openai-completions",
 				etag: response.headers.get("x-xopc-model-catalog-version"),
-				recommendedModel: models.find((model) => !isDedicatedComputerProfile(model.computerUse?.profile))?.id ?? null,
+				recommendedModel: models.find((model) => model.id === "auto")?.id ?? models.find((model) => !isDedicatedComputerProfile(model.computerUse?.profile))?.id ?? null,
 				...Object.keys(recommended).length > 0 ? { recommended } : {},
 				...search ? { search } : {},
 				lastSuccessAt: Date.now()