@xopcai/xopc 0.0.285 → 0.0.291

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

@@ -1,6 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { onUserContextChange } from "../../user-context/changes.js";
+import { init_changes, onUserContextChange } from "../../user-context/changes.js";
+import { decodeVoiceUplinkAudioFrame, encodeVoiceAudioFrame } from "../../../packages/realtime-protocol/src/voice-audio.js";
+import { VOICE_REALTIME_HEARTBEAT_INTERVAL_MS, VOICE_REALTIME_MAX_BINARY_FRAME_BYTES, VOICE_REALTIME_START_TIMEOUT_MS, VOICE_REALTIME_WS_PATH, init_voice, parseVoiceClientJsonFrame, parseVoiceClientMessage } from "../../../packages/realtime-protocol/src/voice.js";
 import { getModelCatalogStore, init_model_catalog_store } from "../../providers/model-catalog-store.js";
 import { ALIBABA_REALTIME_TTS_MODEL } from "../tts/providers/alibaba-speech.js";
 import { resolveSpeechProviderChain } from "../tts/factory.js";
@@ -10,8 +12,6 @@ import { resolveSTTProviderChain } from "../stt/factory.js";
 import { mergeSttConfigFromAppConfig } from "../stt/config.js";
 import { voiceConversationInstructions } from "./conversation-context.js";
 import { createPreauthConnectionBudget } from "../../gateway/security/preauth-connection-budget.js";
-import { decodeVoiceUplinkAudioFrame, encodeVoiceAudioFrame } from "../../../packages/realtime-protocol/src/voice-audio.js";
-import { VOICE_REALTIME_HEARTBEAT_INTERVAL_MS, VOICE_REALTIME_MAX_BINARY_FRAME_BYTES, VOICE_REALTIME_START_TIMEOUT_MS, VOICE_REALTIME_WS_PATH, parseVoiceClientJsonFrame, parseVoiceClientMessage } from "../../../packages/realtime-protocol/src/voice.js";
 import { createAgentVoiceEngine } from "./agentEngine.js";
 import { resolveOmniRoute } from "./omniRoute.js";
 import { createOmniVoiceEngine } from "./omniEngine.js";
@@ -19,7 +19,9 @@ import { applyVoiceOutputGain } from "./pcm-output-gain.js";
 import { createRequire } from "node:module";
 import crypto from "node:crypto";
 //#region src/voice/realtime/runtime.ts
+init_voice();
 init_logger();
+init_changes();
 init_model_catalog_store();
 const { WebSocket: WebSocketState, WebSocketServer } = createRequire(import.meta.url)("ws");
 const log = createLogger("Voice:Realtime");
@@ -44,10 +46,16 @@ function isStreamingProvider(provider) {
 }
 function resolveStreamingStt(config, language) {
 	const sttConfig = mergeSttConfigFromAppConfig(config.tools?.media?.audio, config.tools?.media);
-	for (const entry of resolveSTTProviderChain(sttConfig)) {
+	const configured = config.voice?.realtime?.stt;
+	const chain = configured ? [{
+		id: configured.provider,
+		model: configured.model
+	}] : resolveSTTProviderChain(sttConfig);
+	for (const entry of chain) {
 		const plugin = getMediaUnderstandingProvider(entry.id);
 		if (!isStreamingProvider(plugin)) continue;
-		const model = plugin.streamingAudio.defaultModel;
+		const model = plugin.id === "xopc-cloud" ? config.voice?.realtime?.stt?.model ?? entry.model ?? plugin.streamingAudio.defaultModel : plugin.streamingAudio.defaultModel;
+		if (!plugin.streamingAudio.models.includes(model)) continue;
 		return {
 			plugin,
 			model,
@@ -82,6 +90,7 @@ function resolveStreamingTts(config) {
 			providers: { [selection.provider]: {
 				...apiKey ? { apiKey } : {},
 				...slice.baseUrl ? { baseUrl: slice.baseUrl } : {},
+				...selection.model ? { model: selection.model } : {},
 				...selection.voice ? { voice: selection.voice } : selection.provider === "alibaba" ? { voice: "Cherry" } : {}
 			} }
 		};
@@ -100,7 +109,7 @@ function resolveStreamingTts(config) {
 		else if (provider.plugin.id === "xopc-cloud") {
 			const candidate = typeof provider.providerConfig.model === "string" ? provider.providerConfig.model : void 0;
 			const catalogModel = getModelCatalogStore().getSource("xopc-cloud")?.models.find((entry) => entry.id === candidate);
-			if (!catalogModel?.tts?.streaming || !catalogModel.tts.outputFormats.includes("pcm")) continue;
+			if (catalogModel?.availability !== "available" || !catalogModel.voice?.modes.includes("speech.stream")) continue;
 			model = candidate;
 		} else continue;
 		if (!model) continue;
@@ -171,7 +180,7 @@ var VoiceRealtimeRuntime = class {
 			throw new VoiceSessionCreationError("PROVIDER_UNAVAILABLE", "Natural conversation is unavailable. Check its model, endpoint and credentials.", 503);
 		}
 		if (omni && (!this.options.recordOmniTranscript || !this.options.getConversationContext)) throw new VoiceSessionCreationError("PROVIDER_UNAVAILABLE", "Natural conversation storage is unavailable", 503);
-		const conversationSessionId = request.purpose === "conversation" && request.sessionKey ? await this.options.getSessionIdentity?.(request.sessionKey) : void 0;
+		const conversationSessionId = request.purpose === "conversation" && request.conversationId ? await this.options.getSessionIdentity?.(request.conversationId) : void 0;
 		if (request.purpose === "conversation" && !conversationSessionId) throw new VoiceSessionCreationError("SESSION_NOT_FOUND", "Conversation session was not found", 404);
 		const stt = omni ? void 0 : resolveStreamingStt(config, request.language);
 		if (!omni && !stt) throw new VoiceSessionCreationError("PROVIDER_UNAVAILABLE", "No configured streaming speech-to-text provider is available", 503);
@@ -179,9 +188,9 @@ var VoiceRealtimeRuntime = class {
 		if (stt && !stt.plugin.streamingAudio.turnDetection.includes(inputMode)) throw new VoiceSessionCreationError("PROVIDER_UNAVAILABLE", `Streaming speech-to-text provider does not support ${inputMode}`, 503);
 		const tts = request.mode === "assistant" ? resolveStreamingTts(config) : void 0;
 		if (request.purpose === "conversation") {
-			if (!request.sessionKey || !await this.options.sessionExists(request.sessionKey)) throw new VoiceSessionCreationError("SESSION_NOT_FOUND", "Conversation session was not found", 404);
-			if (request.mode === "natural" && this.options.sessionBusy(request.sessionKey)) throw new VoiceSessionCreationError("SESSION_CONFLICT", "Conversation session already has an active response", 409);
-			if (this.conversationReservations.has(request.sessionKey)) throw new VoiceSessionCreationError("SESSION_CONFLICT", "Conversation session already has a voice connection", 409);
+			if (!request.conversationId || !await this.options.sessionExists(request.conversationId)) throw new VoiceSessionCreationError("SESSION_NOT_FOUND", "Conversation session was not found", 404);
+			if (request.mode === "natural" && this.options.sessionBusy(request.conversationId)) throw new VoiceSessionCreationError("SESSION_CONFLICT", "Conversation session already has an active response", 409);
+			if (this.conversationReservations.has(request.conversationId)) throw new VoiceSessionCreationError("SESSION_CONFLICT", "Conversation session already has a voice connection", 409);
 			if (!omni && !tts) throw new VoiceSessionCreationError("PROVIDER_UNAVAILABLE", "No configured PCM streaming text-to-speech provider is available", 503);
 		}
 		if (this.tickets.size >= MAX_OUTSTANDING_TICKETS) throw new VoiceSessionCreationError("SESSION_LIMIT", "Too many outstanding realtime voice tickets", 429);
@@ -204,7 +213,7 @@ var VoiceRealtimeRuntime = class {
 		const sessionId = crypto.randomUUID();
 		const ticket = crypto.randomBytes(32).toString("base64url");
 		const connectionEpoch = crypto.randomInt(1, 4294967296);
-		const maxSessionMs = request.purpose === "conversation" ? Math.min(config.voice.realtime.maxConversationMs, omni?.route.managed ? 30 * 6e4 : Number.MAX_SAFE_INTEGER) : config.voice.realtime.maxDictationMs;
+		const maxSessionMs = request.purpose === "conversation" ? Math.min(config.voice.realtime.maxConversationMs, omni?.maxSessionSeconds ? omni.maxSessionSeconds * 1e3 : Number.MAX_SAFE_INTEGER) : config.voice.realtime.maxDictationMs;
 		const claim = {
 			conversationSessionId,
 			sessionId,
@@ -224,7 +233,7 @@ var VoiceRealtimeRuntime = class {
 			expiresAt: now + TICKET_TTL_MS
 		};
 		this.tickets.set(ticketKey(ticket), claim);
-		if (request.purpose === "conversation" && request.sessionKey) this.conversationReservations.set(request.sessionKey, sessionId);
+		if (request.purpose === "conversation" && request.conversationId) this.conversationReservations.set(request.conversationId, sessionId);
 		return {
 			sessionId,
 			ticket,
@@ -285,9 +294,9 @@ var VoiceRealtimeRuntime = class {
 		}
 		return true;
 	}
-	hasConversation(sessionKey) {
+	hasConversation(conversationId) {
 		this.pruneTickets(Date.now());
-		return this.conversationReservations.has(sessionKey);
+		return this.conversationReservations.has(conversationId);
 	}
 	async cancelSession(sessionId, ticket, principalId) {
 		const key = ticketKey(ticket);
@@ -320,8 +329,8 @@ var VoiceRealtimeRuntime = class {
 		this.conversationReservations.clear();
 	}
 	releaseConversationReservation(claim) {
-		const sessionKey = claim.request.sessionKey;
-		if (sessionKey && this.conversationReservations.get(sessionKey) === claim.sessionId) this.conversationReservations.delete(sessionKey);
+		const conversationId = claim.request.conversationId;
+		if (conversationId && this.conversationReservations.get(conversationId) === claim.sessionId) this.conversationReservations.delete(conversationId);
 	}
 	consumeTicket(ticket, sessionId, now = Date.now()) {
 		const key = ticketKey(ticket);
@@ -458,9 +467,9 @@ var VoiceRealtimeRuntime = class {
 			try {
 				if (consumed.omni) {
 					unsubscribeSession = onUserContextChange((change) => {
-						if (change.kind === "session-reset" && change.id === consumed.request.sessionKey) invalidateContext();
+						if (change.kind === "session-reset" && change.id === consumed.request.conversationId) invalidateContext();
 					});
-					context = await this.options.getConversationContext(consumed.request.sessionKey, consumed.conversationSessionId);
+					context = await this.options.getConversationContext(consumed.request.conversationId, consumed.conversationSessionId);
 					if (closed) return;
 					if (context.isCurrent && !context.isCurrent()) {
 						invalidateContext();
@@ -504,7 +513,7 @@ var VoiceRealtimeRuntime = class {
 					bargeIn: consumed.config.voice?.realtime?.bargeIn ?? true,
 					send,
 					sendAudio,
-					record: (entry) => this.options.recordOmniTranscript(consumed.request.sessionKey, consumed.sessionId, entry, consumed.conversationSessionId),
+					record: (entry) => this.options.recordOmniTranscript(consumed.request.conversationId, consumed.sessionId, entry, consumed.conversationSessionId),
 					onClose: shutdown
 				}) : createAgentVoiceEngine({
 					claim: consumed,

package/dist/src/voice/realtime/runtime.types.d.ts

@@ -42,15 +42,15 @@ export interface ResolvedStreamingTts {
 }
 export interface VoiceRealtimeRuntimeOptions {
     isPrincipalActive?: (principalId: string) => boolean;
-    recordOmniTranscript?: (sessionKey: string, callId: string, entry: OmniTranscript, expectedSessionId: string) => Promise<void>;
-    getConversationContext?: (sessionKey: string, expectedSessionId: string) => Promise<VoiceConversationContext>;
-    getSessionIdentity?: (sessionKey: string) => Promise<string | undefined>;
+    recordOmniTranscript?: (conversationId: string, callId: string, entry: OmniTranscript, expectedTranscriptId: string) => Promise<void>;
+    getConversationContext?: (conversationId: string, expectedTranscriptId: string) => Promise<VoiceConversationContext>;
+    getSessionIdentity?: (conversationId: string) => Promise<string | undefined>;
     getConfig: () => Config;
-    sessionExists: (sessionKey: string) => Promise<boolean>;
-    sessionBusy: (sessionKey: string) => boolean;
+    sessionExists: (conversationId: string) => Promise<boolean>;
+    sessionBusy: (conversationId: string) => boolean;
     agentBroker: VoiceAgentBroker;
     recordInterruption: (entry: {
-        sessionKey: string;
+        conversationId: string;
         responseId: string;
         reason: 'barge_in' | 'client_cancelled';
         generatedCharacters: number;

package/dist/src/voice/stt/providers/xopc-cloud-transcription.js

@@ -2,16 +2,16 @@ import { getModelCatalogStore, init_model_catalog_store } from "../../../provide
 import { init_xopc_cloud_config, resolveXopcModelRouterUrl } from "../../../providers/xopc-cloud-config.js";
 import { getProviderAuthService, init_provider_auth_service } from "../../../providers/provider-auth-service.js";
 import { compareCatalogModels } from "../../../providers/model-catalog-ranking.js";
+import { openPlatformStt } from "../../platform-streams.js";
+import { platformVoiceModels, requirePlatformVoiceModel } from "../../platform-catalog.js";
 import { registerMediaUnderstandingProvider } from "../../../media-understanding/registry.js";
-import { openDashScopeStreamingStt } from "../../dashscope/streaming-stt-session.js";
 //#region src/voice/stt/providers/xopc-cloud-transcription.ts
 init_model_catalog_store();
 init_provider_auth_service();
 init_xopc_cloud_config();
-const DEFAULT_STREAMING_MODEL = "qwen-audio-3.0-asr-flash-streaming";
 function defaultModel() {
 	const source = getModelCatalogStore().getSource("xopc-cloud");
-	return source?.models.filter((model) => model.availability === "available" && model.kind === "stt").sort((left, right) => compareCatalogModels(left, right, source.recommended?.stt))[0]?.id;
+	return source?.models.filter((model) => model.availability === "available" && model.kind === "stt" && model.voice?.modes.includes("transcription")).sort((left, right) => compareCatalogModels(left, right, source.recommended?.stt))[0]?.id;
 }
 const xopcCloudTranscriptionProvider = {
 	id: "xopc-cloud",
@@ -22,6 +22,7 @@ const xopcCloudTranscriptionProvider = {
 	transcribeAudio: async (request) => {
 		const model = request.model ?? defaultModel();
 		if (!model) throw new Error("No XOPC Cloud speech-to-text model is available");
+		requirePlatformVoiceModel(model, "transcription");
 		const accessToken = await getProviderAuthService().resolveApiKey("xopc-cloud", request.signal);
 		if (!accessToken) throw new Error("XOPC Cloud authorization is unavailable");
 		const source = getModelCatalogStore().getSource("xopc-cloud");
@@ -50,22 +51,28 @@ const xopcCloudTranscriptionProvider = {
 	streamingAudio: {
 		inputSampleRates: [16e3],
 		turnDetection: ["server_vad"],
-		defaultModel: DEFAULT_STREAMING_MODEL,
-		models: [DEFAULT_STREAMING_MODEL]
+		get defaultModel() {
+			return platformVoiceModels("transcription.stream")[0]?.id ?? "";
+		},
+		get models() {
+			return platformVoiceModels("transcription.stream").map((model) => model.id);
+		}
 	},
 	openAudioStream: async (request) => {
+		const catalogModel = requirePlatformVoiceModel(request.model, "transcription.stream");
 		const accessToken = await getProviderAuthService().resolveApiKey("xopc-cloud", request.signal);
 		if (!accessToken) throw new Error("XOPC Cloud authorization is unavailable");
 		const source = getModelCatalogStore().getSource("xopc-cloud");
 		const baseUrl = (request.baseUrl ?? source?.baseUrl ?? resolveXopcModelRouterUrl()).replace(/\/+$/, "");
 		const relayUrl = new URL(`${baseUrl}/audio/transcriptions/realtime`);
 		relayUrl.protocol = relayUrl.protocol === "https:" ? "wss:" : "ws:";
-		relayUrl.searchParams.set("model", request.model || DEFAULT_STREAMING_MODEL);
-		return openDashScopeStreamingStt({
+		relayUrl.searchParams.set("model", request.model);
+		relayUrl.searchParams.set("service_version", String(catalogModel.voice.serviceVersion));
+		return openPlatformStt({
 			...request,
 			apiKey: accessToken,
 			baseUrl: relayUrl.toString(),
-			model: request.model || DEFAULT_STREAMING_MODEL
+			model: request.model
 		});
 	}
 };

package/dist/src/voice/tts/providers/xopc-cloud-speech.js

@@ -3,7 +3,8 @@ import { init_xopc_cloud_config, resolveXopcModelRouterUrl } from "../../../prov
 import { getProviderAuthService, init_provider_auth_service } from "../../../providers/provider-auth-service.js";
 import { compareCatalogModels } from "../../../providers/model-catalog-ranking.js";
 import { registerSpeechProvider } from "../speech-registry.js";
-import { openDashScopeStreamingTts } from "../../dashscope/streaming-tts-stream.js";
+import { openPlatformTts } from "../../platform-streams.js";
+import { requirePlatformVoiceModel } from "../../platform-catalog.js";
 //#region src/voice/tts/providers/xopc-cloud-speech.ts
 init_model_catalog_store();
 init_provider_auth_service();
@@ -37,11 +38,11 @@ const xopcCloudSpeechProvider = {
 	resolveConfig: ({ rawConfig }) => {
 		const raw = rawConfig["xopc-cloud"];
 		const slice = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
-		const model = typeof slice.model === "string" ? slice.model : availableModels()[0]?.id;
+		const model = typeof slice.model === "string" ? slice.model : availableModels().find((model) => model.voice?.modes.includes("speech"))?.id;
 		const catalogModel = availableModels().find((entry) => entry.id === model);
 		return {
 			model,
-			voice: typeof slice.voice === "string" ? slice.voice : catalogModel?.tts?.defaultVoice,
+			voice: typeof slice.voice === "string" ? slice.voice : catalogModel?.voice?.defaultVoice,
 			speed: readSpeed(slice.speed),
 			instructions: typeof slice.instructions === "string" && slice.instructions.trim() ? slice.instructions.trim() : void 0,
 			baseUrl: typeof slice.baseUrl === "string" ? slice.baseUrl : getModelCatalogStore().getSource("xopc-cloud")?.baseUrl ?? resolveXopcModelRouterUrl()
@@ -54,18 +55,10 @@ const xopcCloudSpeechProvider = {
 	listVoices: async ({ providerConfig }) => {
 		const config = readConfig(providerConfig ?? {});
 		if (!config.model) return [];
-		const token = await getProviderAuthService().resolveApiKey("xopc-cloud");
-		if (!token) return [];
-		const response = await fetch(`${config.baseUrl.replace(/\/+$/, "")}/audio/voices?model=${encodeURIComponent(config.model)}`, {
-			headers: { authorization: `Bearer ${token}` },
-			signal: AbortSignal.timeout(3e4),
-			redirect: "error"
-		});
-		if (!response.ok) return [];
-		return ((await response.json().catch(() => null))?.data ?? []).filter((voice) => typeof voice.id === "string").map((voice) => ({
-			id: voice.id,
-			...typeof voice.name === "string" ? { name: voice.name } : {}
-		}));
+		return availableModels().find((model) => model.id === config.model)?.voice?.voices.map(({ id, name }) => ({
+			id,
+			name
+		})) ?? [];
 	},
 	synthesize: async (request) => {
 		const config = readConfig(request.providerConfig);
@@ -73,6 +66,7 @@ const xopcCloudSpeechProvider = {
 		const voice = typeof request.providerOverrides?.voice === "string" ? request.providerOverrides.voice : config.voice;
 		if (!model || !voice) throw new Error("XOPC Cloud TTS model or voice is unavailable");
 		const catalogModel = availableModels().find((entry) => entry.id === model);
+		requirePlatformVoiceModel(model, "speech");
 		if (!catalogModel) throw new Error(`XOPC Cloud TTS model is unavailable: ${model}`);
 		const speed = readSpeed(request.providerOverrides?.speed ?? config.speed);
 		const instructions = typeof request.providerOverrides?.instructions === "string" ? request.providerOverrides.instructions.trim() : config.instructions;
@@ -115,18 +109,17 @@ const xopcCloudSpeechProvider = {
 		const model = typeof request.providerOverrides?.model === "string" ? request.providerOverrides.model : config.model;
 		const voice = typeof request.providerOverrides?.voice === "string" ? request.providerOverrides.voice : config.voice;
 		if (!model || !voice) throw new Error("XOPC Cloud realtime TTS model or voice is unavailable");
-		const catalogModel = availableModels().find((entry) => entry.id === model);
-		if (!catalogModel?.tts?.streaming || !catalogModel.tts.outputFormats.includes("pcm")) throw new Error(`XOPC Cloud TTS model does not support PCM streaming: ${model}`);
+		const catalogModel = requirePlatformVoiceModel(model, "speech.stream");
 		const token = await getProviderAuthService().resolveApiKey("xopc-cloud", request.signal);
 		if (!token) throw new Error("XOPC Cloud authorization is unavailable");
 		const relayUrl = new URL(`${config.baseUrl.replace(/\/+$/, "")}/audio/speech/realtime`);
 		relayUrl.protocol = relayUrl.protocol === "https:" ? "wss:" : "ws:";
 		relayUrl.searchParams.set("model", model);
+		relayUrl.searchParams.set("service_version", String(catalogModel.voice.serviceVersion));
 		const instructions = typeof request.providerOverrides?.instructions === "string" ? request.providerOverrides.instructions.trim() : config.instructions;
-		return openDashScopeStreamingTts({
+		return openPlatformTts({
 			apiKey: token,
 			baseUrl: relayUrl.toString(),
-			model,
 			voice,
 			text: request.text,
 			...instructions ? { instructions } : {},

package/dist/src/work-discovery/investigation-repository.js

@@ -1,7 +1,9 @@
-import { requireXopcDatabase } from "../storage/sqlite/connection.js";
-import { runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { init_connection, requireXopcDatabase } from "../storage/sqlite/connection.js";
+import { init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { randomUUID } from "node:crypto";
 //#region src/work-discovery/investigation-repository.ts
+init_connection();
+init_transaction();
 function parseJson(value, fallback) {
 	try {
 		return JSON.parse(value);

package/dist/src/work-discovery/probe.js

@@ -3,8 +3,8 @@ import "../projects/index.js";
 import { basename, extname, isAbsolute, relative, resolve, sep } from "node:path";
 import { constants } from "node:fs";
 import { execFile } from "node:child_process";
-import { promisify } from "node:util";
 import { createHash } from "node:crypto";
+import { promisify } from "node:util";
 import { access, lstat, readFile, readdir, realpath, stat } from "node:fs/promises";
 //#region src/work-discovery/probe.ts
 const execFileAsync = promisify(execFile);

package/dist/src/work-discovery/repository.js

@@ -1,6 +1,8 @@
-import { requireXopcDatabase } from "../storage/sqlite/connection.js";
-import { runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { init_connection, requireXopcDatabase } from "../storage/sqlite/connection.js";
+import { init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 //#region src/work-discovery/repository.ts
+init_connection();
+init_transaction();
 function parseJson(value) {
 	if (!value) return void 0;
 	try {
@@ -29,7 +31,7 @@ function runFromRow(row) {
 		...row.stage ? { stage: row.stage } : {},
 		rootPath: row.root_path,
 		projectId: row.project_id,
-		sessionKey: row.session_key,
+		conversationId: row.conversation_id,
 		agentId: row.agent_id,
 		modelRef: row.model_ref,
 		scanPolicyVersion: row.scan_policy_version,
@@ -85,10 +87,10 @@ function setWorkDiscoveryOnboardingState(input) {
 function createWorkDiscoveryRun(run) {
 	runSqliteWriteTransaction((db) => {
 		db.prepare(`INSERT INTO work_discovery_runs (
-        id, idempotency_key, source, status, stage, root_path, project_id, session_key,
+        id, idempotency_key, source, status, stage, root_path, project_id, conversation_id,
         agent_id, model_ref, scan_policy_version, snapshot_summary_json, result_json,
         error_code, error_message, created_at, started_at, completed_at, canceled_at, mode, attempts
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(run.id, run.idempotencyKey, run.source, run.status, run.stage ?? null, run.rootPath, run.projectId, run.sessionKey, run.agentId, run.modelRef, run.scanPolicyVersion, run.snapshot ? JSON.stringify(run.snapshot) : null, run.result ? JSON.stringify(run.result) : null, run.errorCode ?? null, run.errorMessage ?? null, run.createdAt, run.startedAt ?? null, run.completedAt ?? null, run.canceledAt ?? null, run.mode ?? "interactive", run.attempts ?? 0);
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(run.id, run.idempotencyKey, run.source, run.status, run.stage ?? null, run.rootPath, run.projectId, run.conversationId, run.agentId, run.modelRef, run.scanPolicyVersion, run.snapshot ? JSON.stringify(run.snapshot) : null, run.result ? JSON.stringify(run.result) : null, run.errorCode ?? null, run.errorMessage ?? null, run.createdAt, run.startedAt ?? null, run.completedAt ?? null, run.canceledAt ?? null, run.mode ?? "interactive", run.attempts ?? 0);
 	});
 	return getWorkDiscoveryRun(run.id);
 }

package/dist/src/work-discovery/service.js

@@ -1,20 +1,20 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { createContextEvidence } from "../storage/sqlite/context-evidence-repository.js";
-import { ensureSessionRecord } from "../storage/sqlite/session-repository.js";
+import { ensureSessionRecord, patchSessionMetadata } from "../storage/sqlite/session-repository.js";
 import "../storage/sqlite/index.js";
 import { ActivityService } from "../activity/service.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { buildSessionKey, init_session_key } from "../routing/session-key.js";
+import { init_session_key, resolveConversationId } from "../routing/session-key.js";
 import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
-import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { init_providers, resolveModel } from "../providers/index.js";
+import { isLocalModelBaseUrl } from "../providers/model-call.js";
+import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { writeKnowledgeItem } from "../knowledge-memory/repository.js";
 import "../knowledge-memory/index.js";
 import { createPriorityWindow, createUserGoal } from "../user-model/goals.js";
 import { getAssertionSlot, getUserAssertion, linkAssertionEvidence, reconcileAssertion, setAssertionStatus } from "../user-model/repository.js";
 import "../user-model/index.js";
-import { isLocalModelBaseUrl } from "../providers/model-call.js";
 import { allowsRemoteSourceProcessing } from "../user-context/sources/processing-policy.js";
 import { analyzeUnderstandingSources, analyzeWorkContext, workDiscoveryResultMarkdown } from "./analyzer.js";
 import { createUnderstandingSourceRun, getUnderstandingSourceRun, updateUnderstandingSourceGrantCheckpoint, updateUnderstandingSourceGrantPolicies, updateUnderstandingSourceRun, upsertUnderstandingSourceGrant } from "../user-context/sources/repository.js";
@@ -322,14 +322,18 @@ var WorkDiscoveryService = class {
 		const rootPath = project.workspaceRoot ?? resolveEffectiveAgentProfile(config, agentId).resolvedWorkspacePath;
 		const id = randomUUID();
 		const peerId = `project-understanding-${id}`;
-		const sessionKey = buildSessionKey({
+		const conversationId = resolveConversationId({
 			agentId,
 			source: "webchat",
 			accountId: "default",
 			peerKind: "direct",
 			peerId
 		});
-		ensureSessionRecord(sessionKey, rootPath, {
+		ensureSessionRecord(conversationId, rootPath, {
+			...sessionMetadata(agentId, peerId),
+			projectId
+		});
+		patchSessionMetadata(conversationId, {
 			...sessionMetadata(agentId, peerId),
 			projectId
 		});
@@ -341,7 +345,7 @@ var WorkDiscoveryService = class {
 			status: "queued",
 			rootPath,
 			projectId,
-			sessionKey,
+			conversationId,
 			agentId,
 			modelRef: getAgentDefaultModelRef(config) ?? "",
 			scanPolicyVersion: 1,
@@ -822,15 +826,15 @@ var WorkDiscoveryService = class {
 		if (!match) throw new Error("Selected folder cannot be used as a project workspace");
 		const projectAgentId = match.project.defaultAgentId || agentId;
 		const peerId = `work-discovery-${randomUUID()}`;
-		const sessionKey = buildSessionKey({
+		const conversationId = resolveConversationId({
 			agentId: projectAgentId,
 			source: "webchat",
 			accountId: "default",
 			peerKind: "direct",
 			peerId
 		});
-		await this.options.sessions.saveMessages(sessionKey, [], { metadata: sessionMetadata(projectAgentId, peerId) });
-		this.options.projects.attachSession(sessionKey, match.project.id);
+		await this.options.sessions.saveMessages(conversationId, [], { metadata: sessionMetadata(projectAgentId, peerId) });
+		this.options.projects.attachSession(conversationId, match.project.id);
 		const now = Date.now();
 		const run = createWorkDiscoveryRun({
 			id: randomUUID(),
@@ -839,13 +843,13 @@ var WorkDiscoveryService = class {
 			status: "queued",
 			rootPath,
 			projectId: match.project.id,
-			sessionKey,
+			conversationId,
 			agentId: projectAgentId,
 			modelRef,
 			scanPolicyVersion: 1,
 			createdAt: now
 		});
-		await this.options.sessions.appendTranscriptContextEntry(sessionKey, {
+		await this.options.sessions.appendTranscriptContextEntry(conversationId, {
 			text: "Work discovery was explicitly requested for the selected folder.",
 			data: {
 				type: "work_discovery",
@@ -869,7 +873,7 @@ var WorkDiscoveryService = class {
 			actor: { kind: "system" },
 			initiator: {
 				kind: "user",
-				sessionKey
+				conversationId
 			},
 			source: {
 				kind: "gateway_api",
@@ -886,7 +890,7 @@ var WorkDiscoveryService = class {
 				reason: "object_owner"
 			}, {
 				scopeKind: "session",
-				scopeId: sessionKey,
+				scopeId: conversationId,
 				reason: "runtime_context"
 			}]
 		});
@@ -905,7 +909,7 @@ var WorkDiscoveryService = class {
 		this.options.emit(`work-discovery.${suffix}`, {
 			runId: run.id,
 			projectId: run.projectId,
-			sessionKey: run.sessionKey,
+			conversationId: run.conversationId,
 			status: run.status,
 			stage: run.stage,
 			...run.status === "completed" ? { result: run.result } : {}
@@ -1050,7 +1054,7 @@ var WorkDiscoveryService = class {
 				stage: "next_steps"
 			});
 			this.publish(current);
-			if (run.mode !== "background") await this.options.sessions.appendTranscriptCustomMessageEntry(run.sessionKey, {
+			if (run.mode !== "background") await this.options.sessions.appendTranscriptCustomMessageEntry(run.conversationId, {
 				customType: "work-discovery-result",
 				content: workDiscoveryResultMarkdown(result),
 				display: true,
@@ -1060,7 +1064,7 @@ var WorkDiscoveryService = class {
 				}
 			});
 			const project = this.options.projects.get(run.projectId);
-			if (run.mode !== "background") await this.options.sessions.updateSessionMetadata(run.sessionKey, {
+			if (run.mode !== "background") await this.options.sessions.updateSessionMetadata(run.conversationId, {
 				name: project ? `Continue work on ${project.name}` : "Continue recent work",
 				hiddenFromSessionList: false
 			});
@@ -1097,11 +1101,11 @@ var WorkDiscoveryService = class {
 				actor: {
 					kind: "agent",
 					agentId: run.agentId,
-					sessionKey: run.sessionKey
+					conversationId: run.conversationId
 				},
 				initiator: {
 					kind: "user",
-					sessionKey: run.sessionKey
+					conversationId: run.conversationId
 				},
 				source: {
 					kind: "system",
@@ -1118,16 +1122,16 @@ var WorkDiscoveryService = class {
 					reason: "object_owner"
 				}, {
 					scopeKind: "session",
-					scopeId: run.sessionKey,
+					scopeId: run.conversationId,
 					reason: "runtime_context"
 				}]
 			});
 			this.publish(current);
-			if (run.mode !== "background") this.options.emit("session.transcript_updated", { key: run.sessionKey });
+			if (run.mode !== "background") this.options.emit("session.transcript_updated", { key: run.conversationId });
 			log.info({
 				runId: run.id,
 				projectId: run.projectId,
-				sessionKey: run.sessionKey,
+				conversationId: run.conversationId,
 				durationMs: Date.now() - startedAt
 			}, "Work discovery completed");
 		} catch (error) {
@@ -1159,7 +1163,7 @@ var WorkDiscoveryService = class {
 				actor: { kind: "system" },
 				initiator: {
 					kind: "user",
-					sessionKey: run.sessionKey
+					conversationId: run.conversationId
 				},
 				source: {
 					kind: "system",
@@ -1173,7 +1177,7 @@ var WorkDiscoveryService = class {
 					reason: "object_owner"
 				}, {
 					scopeKind: "session",
-					scopeId: run.sessionKey,
+					scopeId: run.conversationId,
 					reason: "runtime_context"
 				}]
 			});
@@ -1312,7 +1316,7 @@ var WorkDiscoveryService = class {
 				investigationId: investigation.id,
 				projectId: run.projectId,
 				sourceType: "user_statement",
-				sourceRef: `session://${createHash("sha256").update(run.sessionKey).digest("hex").slice(0, 16)}/recognition`,
+				sourceRef: `session://${createHash("sha256").update(run.conversationId).digest("hex").slice(0, 16)}/recognition`,
 				observation,
 				contentHash: createHash("sha256").update(observation).digest("hex"),
 				observedAt: Date.now(),
@@ -1324,7 +1328,7 @@ var WorkDiscoveryService = class {
 			activeRunId: input.decision === "dismissed" ? null : run.id
 		});
 		const feedbackText = correctedIntent ? `The user corrected the work discovery understanding: ${correctedIntent}` : input.decision === "confirmed" ? "The user confirmed the work discovery understanding." : "The user left work discovery without confirming the suggested understanding.";
-		await this.options.sessions.appendTranscriptContextEntry(run.sessionKey, {
+		await this.options.sessions.appendTranscriptContextEntry(run.conversationId, {
 			text: feedbackText,
 			data: {
 				type: "work_discovery_recognition_feedback",
@@ -1341,7 +1345,7 @@ var WorkDiscoveryService = class {
 			},
 			actor: {
 				kind: "user",
-				sessionKey: run.sessionKey
+				conversationId: run.conversationId
 			},
 			source: {
 				kind: "gateway_api",
@@ -1357,14 +1361,14 @@ var WorkDiscoveryService = class {
 				reason: "object_owner"
 			}, {
 				scopeKind: "session",
-				scopeId: run.sessionKey,
+				scopeId: run.conversationId,
 				reason: "runtime_context"
 			}]
 		});
 		this.options.emit("work-discovery.recognition-feedback", {
 			runId: run.id,
 			projectId: run.projectId,
-			sessionKey: run.sessionKey,
+			conversationId: run.conversationId,
 			decision: input.decision
 		});
 		return {
@@ -1384,7 +1388,7 @@ var WorkDiscoveryService = class {
 			},
 			actor: {
 				kind: "user",
-				sessionKey: run.sessionKey
+				conversationId: run.conversationId
 			},
 			source: {
 				kind: "gateway_api",
@@ -1400,7 +1404,7 @@ var WorkDiscoveryService = class {
 				reason: "object_owner"
 			}, {
 				scopeKind: "session",
-				scopeId: run.sessionKey,
+				scopeId: run.conversationId,
 				reason: "runtime_context"
 			}]
 		});

package/dist/src/work-discovery/types.d.ts

@@ -246,7 +246,7 @@ export interface WorkDiscoveryRun {
     stage?: WorkDiscoveryStage;
     rootPath: string;
     projectId: string;
-    sessionKey: string;
+    conversationId: string;
     agentId: string;
     modelRef: string;
     scanPolicyVersion: number;

package/dist/src/workflows/context/workflow-context-snapshot-repository.js

@@ -1,6 +1,7 @@
-import { getSqliteDatabase } from "../../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction } from "../../storage/sqlite/transaction.js";
 import { randomUUID } from "node:crypto";
 //#region src/workflows/context/workflow-context-snapshot-repository.ts
+init_transaction();
 var WorkflowContextSnapshotRepository = class {
 	capture(input) {
 		const snapshot = {

package/dist/src/workflows/domain/event.d.ts

@@ -42,7 +42,7 @@ export interface AgentQueuedPayload {
     label: string;
     phaseId?: string;
     prompt?: string;
-    sessionKey: string;
+    conversationId: string;
     invocation?: WorkflowAgentInvocationSnapshot;
 }
 export interface AgentStartedPayload {