@xopcai/xopc 0.0.285 → 0.0.291

package/dist/src/user-context/access-policy.d.ts

@@ -8,4 +8,4 @@ export interface UserContextSessionAccess {
     knowledgeSources: readonly KnowledgeSource[];
 }
 /** One policy boundary for every shared-context read and write path. */
-export declare function resolveUserContextSessionAccess(config: Config | undefined, sessionKey: string | undefined): UserContextSessionAccess;
+export declare function resolveUserContextSessionAccess(config: Config | undefined, conversationId: string | undefined): UserContextSessionAccess;

package/dist/src/user-context/access-policy.js

@@ -1,18 +1,19 @@
 import { getSessionConfig } from "../storage/sqlite/config-repository.js";
-import { init_session_key, parseSessionKey } from "../routing/session-key.js";
+import { getConversationRouting } from "../storage/sqlite/conversation-repository.js";
+import { init_session_key } from "../routing/session-key.js";
 //#region src/user-context/access-policy.ts
 init_session_key();
 /** One policy boundary for every shared-context read and write path. */
-function resolveUserContextSessionAccess(config, sessionKey) {
-	if (!config || !sessionKey) return {
+function resolveUserContextSessionAccess(config, conversationId) {
+	if (!config || !conversationId) return {
 		enabled: false,
 		userModel: false,
 		knowledge: false,
 		crossSessionHistory: false,
 		knowledgeSources: []
 	};
-	const session = parseSessionKey(sessionKey);
-	const mode = getSessionConfig(sessionKey)?.userContextMode ?? "enabled";
+	const session = getConversationRouting(conversationId);
+	const mode = getSessionConfig(conversationId)?.userContextMode ?? "enabled";
 	const enabled = Boolean(config.userContext.enabled && session?.peerKind === "direct" && mode === "enabled");
 	return {
 		enabled,

package/dist/src/user-context/changes.js

@@ -1,9 +1,7 @@
+import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 //#region src/user-context/changes.ts
-init_logger();
-const listeners = /* @__PURE__ */ new Set();
-const log = createLogger("UserContextChanges");
 function onUserContextChange(listener) {
 	listeners.add(listener);
 	return () => {
@@ -24,5 +22,12 @@ function notifyUserContextChange(change) {
 		}
 	});
 }
+var listeners, log;
+var init_changes = __esmMin((() => {
+	init_logger();
+	listeners = /* @__PURE__ */ new Set();
+	log = createLogger("UserContextChanges");
+}));
 //#endregion
-export { notifyUserContextChange, onUserContextChange };
+init_changes();
+export { init_changes, notifyUserContextChange, onUserContextChange };

package/dist/src/user-context/domain.d.ts

@@ -72,7 +72,7 @@ export type ContextEvidence = {
     sourceRef: string;
     sourceRunId?: string;
     sourceItemId?: string;
-    sessionId?: string;
+    conversationId?: string;
     turnId?: string;
     messageId?: string;
     contentHash?: string;

package/dist/src/user-context/relationship-continuity.d.ts

@@ -5,7 +5,7 @@ export interface RelationshipFollowUpRequest {
 }
 export declare function extractExplicitRelationshipFollowUp(message: string, nowMs?: number): RelationshipFollowUpRequest | null;
 export declare function recordExplicitRelationshipFollowUp(input: {
-    sessionKey: string;
+    conversationId: string;
     message: string;
     nowMs?: number;
 }): UserAssertion | null;

package/dist/src/user-context/relationship-continuity.js

@@ -31,7 +31,7 @@ function recordExplicitRelationshipFollowUp(input) {
 	const key = hash(request.subject.toLocaleLowerCase());
 	const evidence = createContextEvidence({
 		sourceType: "conversation",
-		sourceRef: `session:${input.sessionKey}:follow-up:${hash(input.message)}`,
+		sourceRef: `session:${input.conversationId}:follow-up:${hash(input.message)}`,
 		redactedExcerpt: input.message.slice(0, 600),
 		trustLevel: "owner",
 		observedAt: now

package/dist/src/user-context/sources/repository.js

@@ -1,7 +1,9 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
-import { notifyUserContextChange } from "../changes.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { init_changes, notifyUserContextChange } from "../changes.js";
 import { randomUUID } from "node:crypto";
 //#region src/user-context/sources/repository.ts
+init_transaction();
+init_changes();
 function record(value) {
 	try {
 		return JSON.parse(value);

package/dist/src/user-model/capture/executor.d.ts

@@ -6,7 +6,7 @@ export interface UserModelCapturePolicy {
     processing: 'local_only' | 'remote_allowed';
 }
 export interface CaptureScopeContext {
-    sessionId: string;
+    conversationId: string;
     agentId: string;
     workspaceId: string;
     projectId?: string;

package/dist/src/user-model/capture/executor.js

@@ -22,7 +22,7 @@ function scopeAllowed(type, id, context) {
 		agent: context.agentId,
 		workspace: context.workspaceId,
 		project: context.projectId,
-		session: context.sessionId
+		session: context.conversationId
 	}[type];
 }
 function candidateKey(predicate, scopeType, scopeId) {
@@ -85,9 +85,9 @@ function executeUserModelInterpretation(input) {
 		if (!item || item.role !== "user") continue;
 		const evidence = createContextEvidence({
 			sourceType: "conversation",
-			sourceRef: `session:${input.scopeContext.sessionId}:entry:${ref}`,
+			sourceRef: `session:${input.scopeContext.conversationId}:entry:${ref}`,
 			sourceRunId: input.extractionRunId,
-			sessionId: input.scopeContext.sessionId,
+			conversationId: input.scopeContext.conversationId,
 			...input.turnId ? { turnId: input.turnId } : {},
 			messageId: ref,
 			contentHash: createHash("sha256").update(item.text).digest("hex"),

package/dist/src/user-model/goals.js

@@ -1,7 +1,8 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { USER_MODEL_PRINCIPAL_ID, validateScope } from "./domain.js";
 import { randomUUID } from "node:crypto";
 //#region src/user-model/goals.ts
+init_transaction();
 function optionalNumber(value) {
 	return value === null ? void 0 : value;
 }

package/dist/src/user-model/repository.js

@@ -1,9 +1,10 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { USER_MODEL_PRINCIPAL_ID, validateCandidate, validateScope } from "./domain.js";
 import { defaultReviewAt, requiresBoundedValidity } from "./temporal.js";
 import { basename } from "node:path";
 import { randomUUID } from "node:crypto";
 //#region src/user-model/repository.ts
+init_transaction();
 function slotFromRow(row) {
 	return {
 		id: row.slot_id,

package/dist/src/utils/global-singleton.js

@@ -1,3 +1,4 @@
+import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 //#region src/utils/global-singleton.ts
 function resolveGlobalSingleton(key, create) {
 	const globalStore = globalThis;
@@ -9,5 +10,7 @@ function resolveGlobalSingleton(key, create) {
 function resolveGlobalMap(key) {
 	return resolveGlobalSingleton(key, () => /* @__PURE__ */ new Map());
 }
+var init_global_singleton = __esmMin((() => {}));
 //#endregion
-export { resolveGlobalMap, resolveGlobalSingleton };
+init_global_singleton();
+export { init_global_singleton, resolveGlobalMap, resolveGlobalSingleton };

package/dist/src/utils/logger/context.d.ts

@@ -4,7 +4,7 @@
  */
 import type { LogContext } from './types.js';
 /** Correlation fields merged into every log line while the store is active (via pino mixin). */
-declare const ASYNC_LOG_CORRELATION_KEYS: readonly ["requestId", "sessionKey", "sessionId", "userId", "correlationId"];
+declare const ASYNC_LOG_CORRELATION_KEYS: readonly ["requestId", "conversationId", "transcriptId", "userId", "correlationId"];
 type AsyncLogCorrelationKey = (typeof ASYNC_LOG_CORRELATION_KEYS)[number];
 /**
  * Run *fn* with merged async log context. Propagates through async/await (Node AsyncLocalStorage).

package/dist/src/utils/logger/context.js

@@ -51,8 +51,8 @@ var ASYNC_LOG_CORRELATION_KEYS, logContextStorage, INBOUND_METADATA_FROM_ASYNC;
 var init_context = __esmMin((() => {
 	ASYNC_LOG_CORRELATION_KEYS = [
 		"requestId",
-		"sessionKey",
-		"sessionId",
+		"conversationId",
+		"transcriptId",
 		"userId",
 		"correlationId"
 	];

package/dist/src/utils/logger/log-store.js

@@ -139,8 +139,8 @@ function matchesQuery(entry, query) {
 	if (query.extension && entry.extension !== query.extension) return false;
 	if (query.service && entry.service !== query.service) return false;
 	if (query.requestId && entry.requestId !== query.requestId) return false;
-	if (query.sessionKey && entry.sessionKey !== query.sessionKey) return false;
-	if (query.sessionId && entry.sessionId !== query.sessionId) return false;
+	if (query.conversationId && entry.conversationId !== query.conversationId) return false;
+	if (query.transcriptId && entry.transcriptId !== query.transcriptId) return false;
 	return true;
 }
 /** Cap matched rows before sort/slice so query stays bounded on huge log dirs. */

package/dist/src/utils/logger/pino-record.js

@@ -18,8 +18,8 @@ function pinoRecordToLogEntry(parsed) {
 		"module",
 		"extension",
 		"requestId",
-		"sessionKey",
-		"sessionId",
+		"conversationId",
+		"transcriptId",
 		"userId",
 		"correlationId"
 	]);
@@ -33,8 +33,8 @@ function pinoRecordToLogEntry(parsed) {
 		service: typeof parsed.service === "string" ? parsed.service : void 0,
 		extension: typeof parsed.extension === "string" ? parsed.extension : void 0,
 		requestId: typeof parsed.requestId === "string" ? parsed.requestId : void 0,
-		sessionKey: typeof parsed.sessionKey === "string" ? parsed.sessionKey : void 0,
-		sessionId: typeof parsed.sessionId === "string" ? parsed.sessionId : void 0,
+		conversationId: typeof parsed.conversationId === "string" ? parsed.conversationId : void 0,
+		transcriptId: typeof parsed.transcriptId === "string" ? parsed.transcriptId : void 0,
 		userId: typeof parsed.userId === "string" ? parsed.userId : void 0,
 		correlationId: typeof parsed.correlationId === "string" ? parsed.correlationId : void 0
 	};
@@ -49,8 +49,8 @@ function logEntrySearchText(entry) {
 		entry.service,
 		entry.extension,
 		entry.requestId,
-		entry.sessionKey,
-		entry.sessionId,
+		entry.conversationId,
+		entry.transcriptId,
 		typeof entry.phase === "string" ? entry.phase : void 0,
 		typeof entry.errorMessage === "string" ? entry.errorMessage : void 0
 	];

package/dist/src/utils/logger/types.d.ts

@@ -15,8 +15,8 @@ export interface LogEntry {
     service?: string;
     extension?: string;
     requestId?: string;
-    sessionKey?: string;
-    sessionId?: string;
+    conversationId?: string;
+    transcriptId?: string;
     userId?: string;
     [key: string]: unknown;
 }
@@ -44,9 +44,9 @@ export interface LogContext {
     /** Request/operation ID for tracing */
     requestId?: string;
     /** Session ID for user tracking */
-    sessionKey?: string;
+    conversationId?: string;
     /** Active transcript/session instance id */
-    sessionId?: string;
+    transcriptId?: string;
     /** Cross-service trace id when distinct from requestId */
     correlationId?: string;
     /** User ID */
@@ -123,9 +123,9 @@ export interface LogQuery {
     /** Filter by request ID */
     requestId?: string;
     /** Filter by session ID */
-    sessionKey?: string;
+    conversationId?: string;
     /** Filter by active transcript/session instance id */
-    sessionId?: string;
+    transcriptId?: string;
     /** Pagination offset */
     offset?: number;
     /** Pagination limit */

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

@@ -0,0 +1,81 @@
+import type { VoiceModeCapability } from '@xopcai/realtime-protocol/voice';
+export declare function platformVoiceModels(mode: VoiceModeCapability): import("../providers/model-catalog-types.js").CatalogModel[];
+export declare function requirePlatformVoiceModel(id: string, mode: VoiceModeCapability): {
+    voice: {
+        protocolVersion: 1;
+        serviceVersion: number;
+        modes: ("conversation" | "transcription" | "speech" | "transcription.stream" | "speech.stream")[];
+        transport: "websocket-pcm";
+        inputFormat: {
+            encoding: "pcm_s16le";
+            sampleRate: 16000;
+            channels: 1;
+        };
+        outputFormat: {
+            encoding: "pcm_s16le";
+            sampleRate: 24000;
+            channels: 1;
+        };
+        turnDetection: "server_vad"[];
+        bargeIn: boolean;
+        tools: boolean;
+        resumable: false;
+        voices: {
+            id: string;
+            name: string;
+            languages: string[];
+        }[];
+        limits: {
+            maxFrameBytes: number;
+            maxSessionSeconds: number;
+        };
+        defaultVoice?: string;
+    };
+    computerUse?: {
+        profile: "gui-plus-2026-02-26" | "structured-tools-v1";
+    };
+    id: string;
+    name: string;
+    displayNames?: Partial<Record<"zh-CN" | "en", string>>;
+    availability: "available" | "unavailable";
+    kind: "language" | "image" | "stt" | "tts" | "omni";
+    input: Array<"text" | "image" | "audio">;
+    output: Array<"text" | "image" | "audio">;
+    operations: Array<"chat.completions" | "responses" | "images.generate" | "images.edit" | "audio.transcription" | "audio.speech" | "audio.conversation">;
+    reasoning: boolean;
+    contextWindow: number;
+    maxOutputTokens: number | null;
+    stability?: "stable" | "preview" | "deprecated";
+    priority?: number;
+    tier?: string;
+    bestEffort?: boolean;
+    imageGeneration?: {
+        maxCount: number;
+        sizes: string[];
+        aspectRatios?: string[];
+        qualities: Array<"low" | "medium" | "high" | "auto">;
+        formats: Array<"png" | "jpeg" | "webp">;
+        backgrounds: Array<"transparent" | "opaque" | "auto">;
+        maxInputImages: number;
+    };
+    stt?: {
+        inputFormats: string[];
+        maxBytes: number;
+        maxDurationSeconds: number;
+        languages: string[];
+        languageHint: boolean;
+        prompt: boolean;
+        timestamps: Array<"segment" | "word">;
+        diarization: boolean;
+    };
+    tts?: {
+        maxCharacters: number;
+        languages: string[];
+        outputFormats: Array<"mp3" | "opus" | "aac" | "flac" | "wav" | "pcm">;
+        streaming: boolean;
+        speed: boolean;
+        pitch: boolean;
+        instructions: boolean;
+        defaultVoice?: string;
+    };
+};

package/dist/src/voice/platform-catalog.js

@@ -0,0 +1,16 @@
+import { getModelCatalogStore, init_model_catalog_store } from "../providers/model-catalog-store.js";
+//#region src/voice/platform-catalog.ts
+init_model_catalog_store();
+function platformVoiceModels(mode) {
+	return (getModelCatalogStore().getSource("xopc-cloud")?.models ?? []).filter((model) => model.availability === "available" && model.voice?.modes.includes(mode));
+}
+function requirePlatformVoiceModel(id, mode) {
+	const model = platformVoiceModels(mode).find((model) => model.id === id);
+	if (!model?.voice) throw new Error(`Published voice model is unavailable for ${mode}: ${id}`);
+	return {
+		...model,
+		voice: model.voice
+	};
+}
+//#endregion
+export { platformVoiceModels, requirePlatformVoiceModel };

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

@@ -0,0 +1,4 @@
+import type { VoiceSelection, VoiceSettingsCatalog } from '@xopcai/realtime-protocol/voice';
+import { type Config } from '../config/schema.js';
+export declare function voiceSettingsCatalog(config: Config): VoiceSettingsCatalog;
+export declare function selectPlatformVoice(config: Config, selection: VoiceSelection): Config;

package/dist/src/voice/platform-settings.js

@@ -0,0 +1,120 @@
+import { ConfigSchema, init_schema } from "../config/schema.js";
+import { getModelCatalogStore, init_model_catalog_store } from "../providers/model-catalog-store.js";
+import { requirePlatformVoiceModel } from "./platform-catalog.js";
+import { createHash } from "node:crypto";
+//#region src/voice/platform-settings.ts
+init_schema();
+init_model_catalog_store();
+function voiceSettingsCatalog(config) {
+	const source = getModelCatalogStore().getSource("xopc-cloud");
+	const selections = [];
+	const add = (mode, slice) => {
+		if (slice?.provider === "xopc-cloud" && slice.model) selections.push({
+			mode,
+			model: slice.model,
+			...slice.voice ? { voice: slice.voice } : {}
+		});
+	};
+	const audio = config.tools?.media?.audio;
+	const tts = config.messages?.tts;
+	add("transcription", {
+		...audio?.providers?.["xopc-cloud"],
+		provider: audio?.provider
+	});
+	add("speech", {
+		...tts?.providers?.["xopc-cloud"],
+		provider: tts?.provider
+	});
+	add("transcription.stream", config.voice?.realtime?.stt);
+	add("speech.stream", config.voice?.realtime?.tts);
+	add("conversation", config.voice?.realtime?.omni);
+	return {
+		revision: createHash("sha256").update(JSON.stringify([
+			config.voice,
+			audio,
+			tts
+		])).digest("hex"),
+		catalogVersion: source?.etag ?? null,
+		selections,
+		models: (source?.models ?? []).flatMap((model) => model.availability === "available" && model.voice ? [{
+			id: model.id,
+			name: model.name,
+			voice: model.voice
+		}] : [])
+	};
+}
+function selectPlatformVoice(config, selection) {
+	const model = requirePlatformVoiceModel(selection.model, selection.mode);
+	const output = selection.mode === "speech" || selection.mode === "speech.stream" || selection.mode === "conversation";
+	const voice = selection.voice ?? model.voice.defaultVoice ?? model.voice.voices[0]?.id;
+	if (output && (!voice || !model.voice.voices.some((item) => item.id === voice))) throw new Error("Choose an available model voice");
+	const next = structuredClone(config);
+	const selected = {
+		provider: "xopc-cloud",
+		model: selection.model,
+		...output ? { voice } : {}
+	};
+	if (selection.mode === "transcription") {
+		next.tools.media ??= {};
+		const audio = next.tools.media.audio ?? {
+			enabled: true,
+			provider: "xopc-cloud",
+			fallback: {
+				enabled: false,
+				order: []
+			},
+			providers: {}
+		};
+		next.tools.media.audio = {
+			...audio,
+			enabled: true,
+			provider: "xopc-cloud",
+			providers: {
+				...audio.providers,
+				"xopc-cloud": {
+					...audio.providers?.["xopc-cloud"],
+					model: selection.model
+				}
+			}
+		};
+	} else if (selection.mode === "speech") {
+		next.messages ??= {};
+		const tts = next.messages.tts ?? {
+			enabled: true,
+			provider: "xopc-cloud",
+			trigger: "off",
+			maxTextLength: 4e3,
+			timeoutMs: 3e4,
+			providers: {}
+		};
+		next.messages.tts = {
+			...tts,
+			enabled: true,
+			provider: "xopc-cloud",
+			providers: {
+				...tts.providers,
+				"xopc-cloud": {
+					...tts.providers?.["xopc-cloud"],
+					model: selection.model,
+					voice
+				}
+			}
+		};
+	} else {
+		next.voice = ConfigSchema.parse({
+			...next,
+			voice: next.voice ?? {}
+		}).voice;
+		next.voice.realtime.enabled = true;
+		if (selection.mode === "transcription.stream") next.voice.realtime.stt = selected;
+		if (selection.mode === "speech.stream") next.voice.realtime.tts = selected;
+		if (selection.mode === "conversation") next.voice.realtime.omni = {
+			...selected,
+			voice,
+			instructions: next.voice.realtime.omni?.instructions ?? "Keep replies conversational and concise. You cannot execute tools."
+		};
+	}
+	return ConfigSchema.parse(next);
+}
+//#endregion
+export { selectPlatformVoice, voiceSettingsCatalog };

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

@@ -0,0 +1,12 @@
+import type { StreamingSttOpenRequest, StreamingSttSession } from '../media-understanding/types.js';
+import type { SpeechSynthesisStreamResult } from './tts/speech-provider-types.js';
+export declare function openPlatformStt(request: StreamingSttOpenRequest): Promise<StreamingSttSession>;
+export declare function openPlatformTts(request: {
+    baseUrl: string;
+    apiKey: string;
+    voice: string;
+    text: string;
+    instructions?: string;
+    signal: AbortSignal;
+    timeoutMs: number;
+}): Promise<SpeechSynthesisStreamResult>;