@xopcai/xopc 0.0.284 → 0.0.286

package/dist/src/agent/service/webchat-tts.js

@@ -22,11 +22,11 @@ function isSuccessfulWebchatTtsToolEvent(event) {
 /**
 * Generate TTS for webchat when config allows; persist under `{stateDir}/media/tts/`.
 */
-async function maybeEmitWebchatTts(deps, sessionKey, hadInboundVoice) {
+async function maybeEmitWebchatTts(deps, conversationId, hadInboundVoice) {
 	const ttsConfig = mergeTtsConfigFromAppConfig(deps.config?.messages?.tts);
 	if (!isTTSAvailable(ttsConfig)) return null;
 	if (!shouldUseTTS(ttsConfig, hadInboundVoice).useTTS) return null;
-	const text = deps.getLastAssistantPlainText(sessionKey).trim();
+	const text = deps.getLastAssistantPlainText(conversationId).trim();
 	if (!text) return null;
 	try {
 		const webOut = getChannelOutputFormat("webchat");
@@ -38,7 +38,7 @@ async function maybeEmitWebchatTts(deps, sessionKey, hadInboundVoice) {
 		const { buffer, format } = await compressAudio(Buffer.from(ttsResult.audio), ttsResult.format, webOut.format === "mp3" ? "mp3" : "opus");
 		const normalizedMime = format === "opus" || format === "ogg" ? "audio/ogg" : format === "mp3" || format === "mpeg" ? "audio/mpeg" : format === "wav" ? "audio/wav" : `audio/${format}`;
 		const persisted = await persistOutboundTtsAudio(buffer, format);
-		await appendMediaToLastAssistant(deps.sessionStore, sessionKey, persisted);
+		await appendMediaToLastAssistant(deps.sessionStore, conversationId, persisted);
 		return {
 			type: "tts_audio",
 			uri: persisted.uri,
@@ -48,13 +48,13 @@ async function maybeEmitWebchatTts(deps, sessionKey, hadInboundVoice) {
 	} catch (err) {
 		deps.log.warn({
 			err,
-			sessionKey
+			conversationId
 		}, "Webchat TTS failed");
 		return null;
 	}
 }
-async function appendMediaToLastAssistant(sessionStore, sessionKey, ref) {
-	const loaded = await sessionStore.load(sessionKey);
+async function appendMediaToLastAssistant(sessionStore, conversationId, ref) {
+	const loaded = await sessionStore.load(conversationId);
 	for (let i = loaded.length - 1; i >= 0; i--) {
 		const m = loaded[i];
 		if (m.role === "assistant") {
@@ -64,7 +64,7 @@ async function appendMediaToLastAssistant(sessionStore, sessionKey, ref) {
 				...m,
 				media: [...prev, ref]
 			};
-			await sessionStore.saveMessages(sessionKey, loaded);
+			await sessionStore.saveMessages(conversationId, loaded);
 			return;
 		}
 	}

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

@@ -104,13 +104,13 @@ export declare class AgentService {
     getSkillCatalog(): SkillCatalogEntry[];
     getSkillCatalogSnapshot(): SkillCatalogSnapshot;
     getAgentSkillAvailability(agentId: string): AgentSkillAvailabilityPayload;
-    getSessionSkillAvailability(sessionKey: string): Promise<AgentSkillAvailabilityPayload>;
-    getSessionWorkspaceTrust(sessionKey: string): Promise<WorkspaceTrustState>;
-    getResolvedWorkspaceForSession(sessionKey: string): string;
-    setSessionWorkspaceTrust(sessionKey: string, trusted: boolean): Promise<WorkspaceTrustState>;
+    getSessionSkillAvailability(conversationId: string): Promise<AgentSkillAvailabilityPayload>;
+    getSessionWorkspaceTrust(conversationId: string): Promise<WorkspaceTrustState>;
+    getResolvedWorkspaceForSession(conversationId: string): string;
+    setSessionWorkspaceTrust(conversationId: string, trusted: boolean): Promise<WorkspaceTrustState>;
     getWorkspaceTrust(workspacePath: string): WorkspaceTrustState;
     setWorkspaceTrust(workspacePath: string, trusted: boolean): WorkspaceTrustState;
-    getCapabilityCatalog(sessionKey?: string): AgentCapabilityCatalogEntry[];
+    getCapabilityCatalog(conversationId?: string): AgentCapabilityCatalogEntry[];
     getSkillMarkdownSource(skillName: string): SkillMarkdownPreviewPayload | null;
     refreshSkillsAfterDiskChange(): void;
     refreshSkillsAfterTrustChange(): void;
@@ -120,12 +120,12 @@ export declare class AgentService {
     refreshActionTrustPolicy(): void;
     refreshUserProfileContext(): void;
     getMemoryManager(): import("./memory/manager.js").MemoryManager;
-    getModelForSession(sessionKey: string): string;
-    getThinkingLevelForSession(sessionKey: string): ThinkingLevel;
+    getModelForSession(conversationId: string): string;
+    getThinkingLevelForSession(conversationId: string): ThinkingLevel;
     /** Run a full tool-capable turn against a caller-owned, non-persistent transcript. */
     runEphemeralTurn(params: {
-        executionSessionKey: string;
-        parentSessionKey: string;
+        executionConversationId: string;
+        parentConversationId: string;
         runId: string;
         content: string;
         attachments?: InboundAttachmentInput[];
@@ -135,20 +135,20 @@ export declare class AgentService {
         abortSignal?: AbortSignal;
         onEvent?: (event: EmbeddedStreamEvent) => void;
     }): Promise<RunXopcEmbeddedTurnResult>;
-    switchModelForSession(sessionKey: string, modelId: string): Promise<boolean>;
+    switchModelForSession(conversationId: string, modelId: string): Promise<boolean>;
     /**
      * Clears per-session model override so the next turn uses the configured agent default
      * (e.g. cron isolated job with no explicit model).
      */
-    resetSessionModelToAgentDefault(sessionKey: string): Promise<void>;
+    resetSessionModelToAgentDefault(conversationId: string): Promise<void>;
     setStreamHandle(handle: StreamHandle): void;
     clearStreamHandle(): void;
     /** Last assistant visible plain text for a session (e.g. after a webchat stream). */
-    getLastAssistantPlainText(sessionKey: string): string;
-    beginInboundTurn(sessionKey: string): void;
-    endInboundTurn(sessionKey: string): void;
-    getInboundTurnDepth(sessionKey: string): number;
-    takeTaskReviewStreamHint(sessionKey: string): import("./session/session-state-bag.js").TaskReviewStreamHint;
+    getLastAssistantPlainText(conversationId: string): string;
+    beginInboundTurn(conversationId: string): void;
+    endInboundTurn(conversationId: string): void;
+    getInboundTurnDepth(conversationId: string): number;
+    takeTaskReviewStreamHint(conversationId: string): import("./session/session-state-bag.js").TaskReviewStreamHint;
     start(): Promise<void>;
     stop(): Promise<void>;
     /**
@@ -157,7 +157,7 @@ export declare class AgentService {
      */
     private notifySessionTitleUpdated;
     /** Fire-and-forget provisional title from first user text (webchat sidebar). */
-    enqueueProvisionalSessionTitle(sessionKey: string, userText: string): void;
+    enqueueProvisionalSessionTitle(conversationId: string, userText: string): void;
     /**
      * Fire-and-forget LLM refine after turn persist; skips user-locked and finalized LLM titles.
      */
@@ -167,7 +167,7 @@ export declare class AgentService {
     /**
      * Persist inbound file attachments to the global media store.
      */
-    prepareInboundAttachments(_sessionKey: string, attachments?: InboundAttachmentInput[]): Promise<MediaRef[] | undefined>;
+    prepareInboundAttachments(_conversationId: string, attachments?: InboundAttachmentInput[]): Promise<MediaRef[] | undefined>;
     private endDirectRequestContext;
     /**
      * Reset a session's transcript and drop the in-memory agent so the next turn
@@ -181,24 +181,24 @@ export declare class AgentService {
      * Preserves the session key and persisted per-session overrides.
      */
     resetSession(key: string): Promise<{
-        sessionId: string;
-        previousSessionId: string;
+        transcriptId: string;
+        previousTranscriptId: string;
     } | null>;
     /**
      * Drop in-memory agent so the next turn reloads transcript from disk (e.g. after checkpoint restore).
      */
-    evictSessionAgent(sessionKey: string): void;
+    evictSessionAgent(conversationId: string): void;
     /**
      * Load session working directory override into AgentManager, ensure directory exists.
      * Call before AgentManager.getOrCreateAgent for this session.
      */
     /** Workspace root for UI file tree / editor (same as agent tools after hydration). */
-    getEffectiveWorkspacePathForSession(sessionKey: string): Promise<string>;
+    getEffectiveWorkspacePathForSession(conversationId: string): Promise<string>;
     /**
     * Best-effort timezone resolution for webchat envelope timestamps.
     * Reads the structured global user profile.
     */
-    resolveUserTimezoneForSession(sessionKey: string): string | undefined;
+    resolveUserTimezoneForSession(conversationId: string): string | undefined;
     /**
      * Setup event handling for a specific session
      */