@xopcai/xopc 0.0.389 → 0.0.391

package/dist/src/providers/setup/engine.d.ts

@@ -0,0 +1,37 @@
+import type { ModelSetupPreview, ModelSetupRequest, ProviderSetupProfile } from '@xopcai/gateway-contract';
+import type { AgentDefaults } from '../../agent-config/index.js';
+import type { SetupVoiceState, SetupVoiceModel, VoiceSetupUse } from './voice.js';
+export type SetupModel = {
+    ref: string;
+    name: string;
+    baseUrl?: string;
+    api?: string;
+    vision?: boolean;
+    reasoning?: boolean;
+    recommended?: boolean;
+};
+export type SetupSnapshot = {
+    profile: ProviderSetupProfile;
+    defaults: AgentDefaults;
+    models: SetupModel[];
+    images: Array<{
+        ref: string;
+        name: string;
+    }>;
+    configured: boolean;
+    configuredProviders: Set<string>;
+    backgroundRestrictedModels?: Set<string>;
+    voice?: SetupVoiceState;
+};
+export declare class SetupConflictError extends Error {
+}
+/** Pure preview over authoritative catalog and defaults; never writes or probes a model. */
+export declare function previewProviderSetup(snapshot: SetupSnapshot, request?: ModelSetupRequest): ModelSetupPreview;
+export declare function applyProviderSetup(snapshot: SetupSnapshot, request: ModelSetupRequest, revision: string): {
+    defaults: AgentDefaults;
+    preview: ModelSetupPreview;
+    voiceAssignments: Array<{
+        use: VoiceSetupUse;
+        model: SetupVoiceModel;
+    }>;
+};

package/dist/src/providers/setup/engine.js

@@ -0,0 +1,177 @@
+import { init_profiles, isInteractiveOnlyProvider } from "./profiles.js";
+import { createHash } from "node:crypto";
+//#region src/providers/setup/engine.ts
+init_profiles();
+const preferred = {
+	"qwen-token-plan-cn": {
+		fast: [
+			"qwen3.8-flash",
+			"qwen3.7-plus",
+			"qwen3.6-flash"
+		],
+		reasoning: [
+			"qwen3.8-max",
+			"deepseek-v4-pro-0813",
+			"deepseek-v4-pro"
+		]
+	},
+	"xopc-cloud": {
+		fast: ["auto"],
+		reasoning: ["advanced", "auto"]
+	},
+	"xiaomi-token-plan-cn": {
+		fast: ["mimo-v2.5", "mimo-v2.5-pro"],
+		reasoning: ["mimo-v2.5-pro", "mimo-v2.5"]
+	}
+};
+const uses = [
+	"chat",
+	"vision",
+	"image",
+	"background"
+];
+var SetupConflictError = class extends Error {};
+function choose(models, ids, provider) {
+	return ids.map((id) => models.find((model) => model.ref === `${provider}/${id}`)?.ref).find(Boolean) ?? models.find((model) => model.recommended)?.ref ?? (models.length === 1 ? models[0]?.ref : void 0);
+}
+/** Pure preview over authoritative catalog and defaults; never writes or probes a model. */
+function previewProviderSetup(snapshot, request = {}) {
+	const { profile, defaults, configured, configuredProviders } = snapshot;
+	const models = snapshot.models.filter((model) => !request.modelIds || request.modelIds.some((id) => model.ref === id || model.ref === `${profile.id}/${id}`));
+	const vision = models.filter((model) => model.vision);
+	const reasoning = models.filter((model) => model.reasoning);
+	const preference = preferred[profile.id] ?? {
+		fast: [],
+		reasoning: []
+	};
+	const fast = choose(models, preference.fast, profile.id);
+	const complex = choose(reasoning, preference.reasoning, profile.id);
+	const isRestricted = (ref) => snapshot.backgroundRestrictedModels?.has(ref) || isInteractiveOnlyProvider(ref.split("/")[0], snapshot.models.find((model) => model.ref === ref)?.baseUrl);
+	const background = profile.interactiveOnly ? [] : models.filter((model) => !isRestricted(model.ref));
+	const recommended = {
+		chat: fast,
+		vision: choose(vision, preference.fast, profile.id),
+		image: snapshot.images[0]?.ref,
+		background: choose(background, preference.fast, profile.id)
+	};
+	const choices = {
+		chat: models,
+		vision,
+		image: snapshot.images,
+		background
+	};
+	const current = {
+		chat: defaults.models.chat.primary,
+		vision: defaults.models.imageUnderstanding?.primary,
+		image: defaults.models.imageGeneration?.primary,
+		background: defaults.models.background?.primary ?? (!isRestricted(defaults.models.chat.primary) ? defaults.models.chat.primary : void 0)
+	};
+	for (const id of Object.keys(snapshot.voice?.choices ?? {})) {
+		const options = snapshot.voice.choices[id];
+		choices[id] = options;
+		recommended[id] = options.find((model) => model.recommended)?.ref ?? (options.length === 1 ? options[0]?.ref : void 0);
+		current[id] = snapshot.voice.current[id];
+	}
+	const revision = createHash("sha256").update(JSON.stringify({
+		defaults,
+		profile,
+		models: snapshot.models,
+		images: snapshot.images,
+		voice: snapshot.voice,
+		backgroundRestrictedModels: [...snapshot.backgroundRestrictedModels ?? []].sort()
+	})).digest("hex");
+	return {
+		providerId: profile.id,
+		profile,
+		revision,
+		configured,
+		mode: request.mode ?? "fill",
+		taskModels: {
+			...fast ? { fast } : {},
+			...complex ? {
+				reasoning: complex,
+				coding: complex,
+				review: complex
+			} : {},
+			...recommended.vision ? { vision: recommended.vision } : {}
+		},
+		uses: [...uses, ...snapshot.voice ? [
+			"transcription",
+			"speech",
+			"conversation"
+		] : []].map((id) => {
+			const options = (choices[id] ?? []).map((model) => ({
+				id: model.ref,
+				name: model.name
+			}));
+			const override = request.overrides?.[id];
+			if (override && !options.some((model) => model.id === override)) throw new Error(`Invalid ${id} model for ${profile.id}`);
+			const ref = override ?? recommended[id];
+			const currentProvider = current[id]?.split("/")[0];
+			const currentConfigured = currentProvider && (configuredProviders.has(currentProvider) || [
+				"speech",
+				"transcription",
+				"conversation"
+			].includes(id)) && (id !== "background" || !isRestricted(current[id]));
+			const selected = options.length > 0 && Boolean(ref) && (request.selected ? request.selected.includes(id) : request.mode === "replace" || !currentConfigured);
+			return {
+				id,
+				current: current[id],
+				recommended: ref,
+				choices: options,
+				selected,
+				...!options.length ? { reason: id === "background" && profile.interactiveOnly ? "interactive_only" : "not_supported" } : !ref ? { reason: "no_recommendation" } : {}
+			};
+		})
+	};
+}
+function applyProviderSetup(snapshot, request, revision) {
+	const preview = previewProviderSetup(snapshot, request);
+	if (revision !== preview.revision) throw new SetupConflictError("Model catalog or settings changed. Review the refreshed configuration.");
+	for (const id of request.selected ?? []) if (!preview.uses.some((use) => use.id === id && use.selected)) throw new Error(`No eligible model selected for ${id}`);
+	if (!snapshot.configured) throw new Error("Connect this model service before applying its models.");
+	const models = structuredClone(snapshot.defaults.models);
+	const voiceAssignments = [];
+	const route = (primary) => ({
+		primary,
+		fallbacks: []
+	});
+	for (const use of preview.uses) {
+		if (!use.selected) continue;
+		if (!use.recommended) throw new Error(`Choose a model for ${use.id}`);
+		if (use.id === "chat") {
+			models.chat = route(use.recommended);
+			for (const [intent, ref] of Object.entries(preview.taskModels)) {
+				const key = intent;
+				const existing = models.intents[key];
+				const keep = request.mode !== "replace" && existing && snapshot.configuredProviders.has(existing.primary.split("/")[0]);
+				if (ref && !keep && (intent !== "vision" || preview.uses.some((use) => use.id === "vision" && use.selected))) models.intents[key] = route(ref);
+			}
+		} else if (use.id === "vision") models.imageUnderstanding = route(use.recommended);
+		else if (use.id === "image") models.imageGeneration = {
+			...models.imageGeneration,
+			...route(use.recommended),
+			autoProviderFallback: false
+		};
+		else if (use.id === "background") models.background = route(use.recommended);
+		else {
+			const voiceUse = use.id;
+			const model = snapshot.voice?.choices[voiceUse].find((model) => model.ref === use.recommended);
+			if (!model) throw new Error(`No voice binding for ${use.id}`);
+			voiceAssignments.push({
+				use: voiceUse,
+				model
+			});
+		}
+	}
+	return {
+		defaults: {
+			...snapshot.defaults,
+			models
+		},
+		preview,
+		voiceAssignments
+	};
+}
+//#endregion
+export { SetupConflictError, applyProviderSetup, previewProviderSetup };

package/dist/src/providers/setup/profiles.d.ts

@@ -0,0 +1,4 @@
+import type { ProviderSetupProfile } from '@xopcai/gateway-contract';
+/** Provider identity and endpoint do not restrict background or unknown calls. */
+export declare function isInteractiveOnlyProvider(_provider: string, _baseUrl?: string): boolean;
+export declare function getProviderSetupProfile(provider: string, name?: string, oauth?: boolean, baseUrl?: string): ProviderSetupProfile;

package/dist/src/providers/setup/profiles.js

@@ -0,0 +1,78 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+//#region src/providers/setup/profiles.ts
+/** Provider identity and endpoint do not restrict background or unknown calls. */
+function isInteractiveOnlyProvider(_provider, _baseUrl) {
+	return false;
+}
+function getProviderSetupProfile(provider, name = provider, oauth = false, baseUrl) {
+	if (profiles[provider]) return {
+		id: provider,
+		...profiles[provider]
+	};
+	const interactiveOnly = isInteractiveOnlyProvider(provider, baseUrl);
+	const local = Boolean(baseUrl && /^https?:\/\/(localhost|127\.0\.0\.1|\[::1\])(?=[:/]|$)/.test(baseUrl));
+	return {
+		id: provider,
+		brand: {
+			"dashscope-cn": "Alibaba Bailian",
+			"dashscope-intl": "Alibaba Bailian",
+			"qwen-token-plan": "Alibaba Bailian",
+			"qwen-token-plan-individual": "Alibaba Bailian",
+			xiaomi: "Xiaomi MiMo",
+			"xiaomi-token-plan-ams": "Xiaomi MiMo",
+			"xiaomi-token-plan-sgp": "Xiaomi MiMo"
+		}[provider] ?? name,
+		name,
+		access: subscriptionProviders.has(provider.trim().toLowerCase()) ? "subscription" : local ? "local" : "api",
+		credential: oauth ? "oauth" : local ? "none" : "api-key",
+		interactiveOnly
+	};
+}
+var subscriptionProviders, profiles;
+var init_profiles = __esmMin((() => {
+	subscriptionProviders = new Set([
+		"qwen-token-plan-cn",
+		"qwen-token-plan",
+		"qwen-token-plan-individual",
+		"xiaomi-token-plan-cn",
+		"xiaomi-token-plan-ams",
+		"xiaomi-token-plan-sgp",
+		"zai-coding-cn",
+		"zai-coding-global",
+		"zhipu-coding-cn",
+		"kimi-coding",
+		"volcengine-plan",
+		"byteplus-plan",
+		"stepfun-plan",
+		"stepfun-plan-cn",
+		"stepfun-plan-intl"
+	]);
+	profiles = {
+		"qwen-token-plan-cn": {
+			brand: "Alibaba Bailian",
+			name: "Bailian subscription · Beijing",
+			access: "subscription",
+			credential: "api-key",
+			interactiveOnly: false,
+			apiKeyUrl: "https://bailian.console.aliyun.com/cn-beijing/subscription/overview"
+		},
+		"xopc-cloud": {
+			brand: "XOPC Cloud",
+			name: "XOPC Cloud",
+			access: "account",
+			credential: "oauth",
+			interactiveOnly: false
+		},
+		"xiaomi-token-plan-cn": {
+			brand: "Xiaomi MiMo",
+			name: "MiMo Token Plan · China",
+			access: "subscription",
+			credential: "api-key",
+			interactiveOnly: false,
+			apiKeyUrl: "https://platform.xiaomimimo.com/"
+		}
+	};
+}));
+//#endregion
+init_profiles();
+export { getProviderSetupProfile, init_profiles, isInteractiveOnlyProvider };

package/dist/src/providers/setup/voice.d.ts

@@ -0,0 +1,23 @@
+import type { ModelSetupUse } from '@xopcai/gateway-contract';
+import { type Config } from '../../config/schema.js';
+export type VoiceSetupUse = Extract<ModelSetupUse, 'speech' | 'transcription' | 'conversation'>;
+export type SetupVoiceModel = {
+    ref: string;
+    name: string;
+    provider: string;
+    model: string;
+    voice?: string;
+    recommended?: boolean;
+};
+export type SetupVoiceState = {
+    revision: string;
+    current: Partial<Record<VoiceSetupUse, string>>;
+    choices: Record<VoiceSetupUse, SetupVoiceModel[]>;
+};
+export declare const voiceSetupUses: VoiceSetupUse[];
+export declare function readSetupVoiceState(provider: string, config: Config): SetupVoiceState;
+/** Voice lives in the existing app configuration; never copy the provider secret. */
+export declare function applySetupVoice(config: Config, assignments: Array<{
+    use: VoiceSetupUse;
+    model: SetupVoiceModel;
+}>): Config;

package/dist/src/providers/setup/voice.js

@@ -0,0 +1,234 @@
+import { ConfigSchema, init_schema } from "../../config/schema.js";
+import { voiceSupportsMode } from "../../../packages/realtime-protocol/src/voice-catalog.js";
+import { init_voice } from "../../../packages/realtime-protocol/src/voice.js";
+import { getModelCatalogStore, init_model_catalog_store } from "../model-catalog-store.js";
+import { BAILIAN_PLAN_HOST, BAILIAN_PLAN_OMNI_MODEL, BAILIAN_PLAN_OMNI_VOICE, BAILIAN_PLAN_PROVIDER, BAILIAN_PLAN_STT_MODEL, BAILIAN_PLAN_TTS_MODEL, BAILIAN_PLAN_TTS_VOICE } from "../../voice/token-plan.js";
+import { listSttProvidersForApi } from "../../voice/stt/list-providers.js";
+import { listTtsProvidersForApi } from "../../voice/tts/list-providers.js";
+import { selectPlatformVoice } from "../../voice/platform-settings.js";
+import { createHash } from "node:crypto";
+//#region src/providers/setup/voice.ts
+init_voice();
+init_schema();
+init_model_catalog_store();
+const voiceSetupUses = [
+	"transcription",
+	"speech",
+	"conversation"
+];
+function readSetupVoiceState(provider, config) {
+	const tts = config.messages?.tts;
+	const stt = config.tools.media?.audio;
+	const omni = config.voice?.realtime?.omni;
+	const choices = {
+		speech: [],
+		transcription: [],
+		conversation: []
+	};
+	if (provider === "qwen-token-plan-cn") {
+		choices.speech.push({
+			ref: `${provider}/${BAILIAN_PLAN_TTS_MODEL}`,
+			name: "Qwen Audio 3.0 TTS Plus",
+			provider,
+			model: BAILIAN_PLAN_TTS_MODEL,
+			voice: BAILIAN_PLAN_TTS_VOICE
+		});
+		choices.transcription.push({
+			ref: `${provider}/${BAILIAN_PLAN_STT_MODEL}`,
+			name: "Qwen Audio 3.0 ASR Flash",
+			provider,
+			model: BAILIAN_PLAN_STT_MODEL
+		});
+		choices.conversation.push({
+			ref: `${provider}/${BAILIAN_PLAN_OMNI_MODEL}`,
+			name: "Qwen Audio 3.0 Realtime Plus",
+			provider,
+			model: BAILIAN_PLAN_OMNI_MODEL,
+			voice: BAILIAN_PLAN_OMNI_VOICE
+		});
+	} else if (provider === "xopc-cloud") {
+		const source = getModelCatalogStore().getSource(provider);
+		for (const model of source?.models ?? []) {
+			if (model.availability !== "available" || !model.voice) continue;
+			for (const use of voiceSetupUses) {
+				const kind = {
+					speech: "tts",
+					transcription: "stt",
+					conversation: "omni"
+				}[use];
+				if (model.kind !== kind) continue;
+				if (!model.voice.modes.includes(use)) continue;
+				const voice = use === "transcription" ? void 0 : model.voice.voices.find((voice) => voice.id === model.voice?.defaultVoice && voiceSupportsMode(voice, use))?.id ?? model.voice.voices.find((voice) => voiceSupportsMode(voice, use))?.id;
+				if (use !== "transcription" && !voice) continue;
+				choices[use].push({
+					ref: `${provider}/${model.id}`,
+					name: model.name,
+					provider,
+					model: model.id,
+					...voice ? { voice } : {},
+					recommended: source?.recommended?.[model.kind] === model.id
+				});
+			}
+		}
+	}
+	if (provider !== "qwen-token-plan-cn" && provider !== "xopc-cloud") for (const [use, entries] of [["transcription", listSttProvidersForApi(config).providers], ["speech", listTtsProvidersForApi(config).providers]]) {
+		const entry = entries.find((entry) => entry.id === provider && entry.configured);
+		if (!entry) continue;
+		const configured = use === "speech" ? tts?.providers?.[provider] : stt?.providers?.[provider];
+		const models = entry.models?.length ? entry.models : [{
+			id: String(configured?.model ?? "default"),
+			name: entry.displayName
+		}];
+		const currentModel = configured?.model ?? entry.fields.find((field) => field.key === "model")?.defaultValue ?? models[0]?.id;
+		const voiceDefault = entry.fields.find((field) => field.key === "voice")?.defaultValue;
+		const defaultVoice = typeof voiceDefault === "string" ? voiceDefault : entry.voices?.[0]?.id;
+		for (const model of models) choices[use].push({
+			ref: `${provider}/${model.id}`,
+			name: model.name,
+			provider,
+			model: model.id,
+			...use === "speech" ? { voice: currentModel === model.id && typeof configured?.voice === "string" ? configured.voice : defaultVoice } : {}
+		});
+	}
+	const current = {};
+	if (tts?.provider) current.speech = `${tts.provider}/${tts.providers?.[tts.provider]?.model ?? "default"}`;
+	if (stt?.provider) current.transcription = `${stt.provider}/${stt.providers?.[stt.provider]?.model ?? "default"}`;
+	if (omni) current.conversation = `${omni.provider}/${omni.model}`;
+	return {
+		current,
+		choices,
+		revision: createHash("sha256").update(JSON.stringify([
+			tts,
+			stt,
+			config.voice,
+			choices
+		])).digest("hex")
+	};
+}
+/** Voice lives in the existing app configuration; never copy the provider secret. */
+function applySetupVoice(config, assignments) {
+	let next = structuredClone(config);
+	for (const { use, model } of assignments) {
+		if (model.provider === "xopc-cloud") next = selectPlatformVoice(next, {
+			mode: use,
+			model: model.model,
+			...model.voice ? { voice: model.voice } : {}
+		});
+		else if (model.provider === "qwen-token-plan-cn") if (use === "speech") {
+			const current = next.messages?.tts;
+			const previous = current?.providers?.[model.provider];
+			const voice = (!previous?.model || previous.model === model.model) && typeof previous?.voice === "string" ? previous.voice : model.voice;
+			next.messages ??= {};
+			next.messages.tts = {
+				enabled: true,
+				provider: model.provider,
+				trigger: "off",
+				maxTextLength: 512,
+				timeoutMs: 6e4,
+				...current,
+				providers: {
+					...current?.providers,
+					[model.provider]: {
+						...previous,
+						model: model.model,
+						voice
+					}
+				}
+			};
+			next.messages.tts.provider = model.provider;
+			next.messages.tts.enabled = true;
+		} else if (use === "transcription") {
+			next.tools.media ??= {};
+			const current = next.tools.media.audio;
+			next.tools.media.audio = {
+				...current,
+				enabled: true,
+				provider: model.provider,
+				fallback: {
+					enabled: false,
+					order: []
+				},
+				models: [{
+					provider: model.provider,
+					model: model.model,
+					capabilities: ["audio"]
+				}],
+				providers: {
+					...current?.providers,
+					[model.provider]: {
+						...current?.providers?.[model.provider],
+						model: model.model
+					}
+				}
+			};
+		} else {
+			next = ConfigSchema.parse({
+				...next,
+				voice: next.voice ?? {}
+			});
+			next.voice.realtime.enabled = true;
+			next.voice.realtime.omni = {
+				provider: BAILIAN_PLAN_PROVIDER,
+				model: model.model,
+				voice: model.voice,
+				baseUrl: `${BAILIAN_PLAN_HOST.replace("https:", "wss:")}/api-ws/v1/realtime`,
+				instructions: next.voice?.realtime.omni?.instructions ?? "Keep replies conversational and concise. You cannot execute tools."
+			};
+		}
+		else if (use === "speech") {
+			const current = next.messages?.tts;
+			next.messages ??= {};
+			next.messages.tts = {
+				enabled: true,
+				trigger: "off",
+				maxTextLength: 512,
+				timeoutMs: 6e4,
+				...current,
+				provider: model.provider,
+				providers: {
+					...current?.providers,
+					[model.provider]: {
+						...current?.providers?.[model.provider],
+						model: model.model,
+						...model.voice ? { voice: model.voice } : {}
+					}
+				}
+			};
+			next.messages.tts.enabled = true;
+		} else if (use === "transcription") {
+			next.tools.media ??= {};
+			const current = next.tools.media.audio;
+			next.tools.media.audio = {
+				...current,
+				enabled: true,
+				provider: model.provider,
+				providers: {
+					...current?.providers,
+					[model.provider]: {
+						...current?.providers?.[model.provider],
+						model: model.model
+					}
+				}
+			};
+		} else throw new Error("No realtime voice configuration binding for this provider");
+		if (use === "speech" && next.messages?.tts) next.messages.tts.fallback = {
+			enabled: false,
+			order: []
+		};
+		if (use === "conversation" && next.voice) next.voice.realtime.defaultEngine = "omni";
+		if (use === "transcription" && next.tools.media?.audio) {
+			next.tools.media.audio.fallback = {
+				enabled: false,
+				order: []
+			};
+			next.tools.media.audio.models = [{
+				provider: model.provider,
+				model: model.model,
+				capabilities: ["audio"]
+			}];
+		}
+	}
+	return ConfigSchema.parse(next);
+}
+//#endregion
+export { applySetupVoice, readSetupVoiceState, voiceSetupUses };

package/dist/src/scenes/agentExecutor.d.ts

@@ -5,4 +5,5 @@ export declare class SceneAgentExecutor implements SceneReadOnlyExecutor {
     private readonly resolveModel;
     constructor(resolveModel: () => Model<Api>);
     execute(input: Parameters<SceneReadOnlyExecutor['execute']>[0]): Promise<unknown>;
+    private executeScoped;
 }

package/dist/src/scenes/agentExecutor.js

@@ -1,3 +1,4 @@
+import { init_model_usage, modelUsageOriginForCall, withModelUsageOrigin } from "../providers/model-usage.js";
 import { init_sync_provider_auth, resolveProviderApiKeySync } from "../auth/sync-provider-auth.js";
 import { getApiKeySync, init_providers } from "../providers/index.js";
 import { createExtensionAwareStreamFn } from "../providers/extension-stream-bridge.js";
@@ -7,12 +8,16 @@ import { Agent } from "@earendil-works/pi-agent-core";
 //#region src/scenes/agentExecutor.ts
 init_sync_provider_auth();
 init_providers();
+init_model_usage();
 /** A single reasoning turn over host-selected evidence; no tools or delegation. */
 var SceneAgentExecutor = class {
 	constructor(resolveModel) {
 		this.resolveModel = resolveModel;
 	}
 	async execute(input) {
+		return withModelUsageOrigin(modelUsageOriginForCall(input.usage), () => this.executeScoped(input));
+	}
+	async executeScoped(input) {
 		input.signal.throwIfAborted();
 		const stream = createExtensionAwareStreamFn();
 		let calls = 0;

package/dist/src/storage/sqlite/migrations/253_discussion_processing_recovery.sql

@@ -0,0 +1,20 @@
+CREATE TABLE discussion_processing (
+  discussion_id TEXT PRIMARY KEY REFERENCES discussion_captures(id) ON DELETE CASCADE,
+  run_id TEXT NOT NULL UNIQUE,
+  audio_sha256 TEXT,
+  base_transcript_revision INTEGER NOT NULL,
+  force_audio INTEGER NOT NULL DEFAULT 0 CHECK(force_audio IN (0,1)),
+  retry_stage TEXT,
+  attempt_count INTEGER NOT NULL DEFAULT 0,
+  next_attempt_at INTEGER,
+  lease_owner TEXT,
+  lease_until INTEGER
+);
+CREATE TABLE discussion_transcription_checkpoints (
+  run_id TEXT NOT NULL REFERENCES discussion_processing(run_id) ON DELETE CASCADE,
+  started_at_ms REAL NOT NULL,
+  ended_at_ms REAL NOT NULL,
+  result_json TEXT NOT NULL,
+  created_at INTEGER NOT NULL,
+  PRIMARY KEY(run_id, started_at_ms, ended_at_ms)
+);

package/dist/src/storage/sqlite/migrations/254_discussion_annotations.sql

@@ -0,0 +1,17 @@
+CREATE TABLE discussion_annotations (
+  discussion_id TEXT NOT NULL REFERENCES discussion_captures(id) ON DELETE CASCADE,
+  id TEXT NOT NULL,
+  kind TEXT NOT NULL CHECK(kind IN ('highlight','question','note')),
+  text TEXT NOT NULL,
+  anchor_json TEXT NOT NULL,
+  revision INTEGER NOT NULL,
+  deleted INTEGER NOT NULL DEFAULT 0,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  PRIMARY KEY(discussion_id,id)
+);
+CREATE TABLE discussion_media_timeline (
+  discussion_id TEXT PRIMARY KEY REFERENCES discussion_captures(id) ON DELETE CASCADE,
+  audio_sha256 TEXT NOT NULL,
+  timeline_json TEXT NOT NULL
+);

package/dist/src/storage/sqlite/migrations/255_discussion_chapter_progress.sql

@@ -0,0 +1,10 @@
+CREATE TABLE discussion_chapter_progress (
+  discussion_id TEXT NOT NULL REFERENCES discussion_captures(id) ON DELETE CASCADE,
+  source_sha256 TEXT NOT NULL,
+  transcript_revision INTEGER NOT NULL,
+  transcript_sha256 TEXT NOT NULL,
+  input_hash TEXT NOT NULL,
+  position INTEGER NOT NULL,
+  chapter_json TEXT NOT NULL,
+  PRIMARY KEY(discussion_id, source_sha256, transcript_revision, transcript_sha256, input_hash)
+);

package/dist/src/storage/sqlite/migrations/256_task_main_update_retries.sql

@@ -0,0 +1,21 @@
+CREATE TABLE task_main_update_deliveries_new (
+  entry_id TEXT PRIMARY KEY REFERENCES task_collaboration_entries(entry_id) ON DELETE CASCADE,
+  conversation_id TEXT NOT NULL REFERENCES sessions(conversation_id) ON DELETE CASCADE,
+  status TEXT NOT NULL CHECK (status IN ('pending', 'delivered', 'failed')),
+  updated_at INTEGER NOT NULL,
+  decision TEXT CHECK (decision IN ('notify', 'silent')),
+  decision_reason TEXT,
+  decided_at INTEGER,
+  failure_count INTEGER NOT NULL DEFAULT 0,
+  last_error TEXT
+);
+
+INSERT INTO task_main_update_deliveries_new
+  (entry_id, conversation_id, status, updated_at, decision, decision_reason, decided_at)
+SELECT entry_id, conversation_id, status, updated_at, decision, decision_reason, decided_at
+FROM task_main_update_deliveries;
+
+DROP TABLE task_main_update_deliveries;
+ALTER TABLE task_main_update_deliveries_new RENAME TO task_main_update_deliveries;
+CREATE INDEX idx_task_main_update_deliveries_pending
+  ON task_main_update_deliveries(status, updated_at);

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 = 252;
+export declare const XOPC_DB_SCHEMA_VERSION = 256;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.