@xopcai/xopc 0.0.285 → 0.0.291

package/dist/src/tui/backends/gateway-realtime-backend.d.ts

@@ -21,7 +21,7 @@ export declare class GatewayRealtimeBackend implements TuiBackend {
     private readonly clientId;
     private realtime;
     private activeRunId;
-    private observedSessionKey;
+    private observedConversationId;
     private chatAbort;
     onEvent?: (evt: TuiEvent) => void;
     onConnected?: () => void;
@@ -40,48 +40,48 @@ export declare class GatewayRealtimeBackend implements TuiBackend {
     sendChat(opts: ChatSendOptions): Promise<{
         runId: string;
     }>;
-    searchWorkspaceFiles(sessionKey: string, query: string, options?: {
+    searchWorkspaceFiles(conversationId: string, query: string, options?: {
         limit?: number;
     }): Promise<TuiWorkspaceFileSearchEntry[]>;
-    getReviewContext(sessionKey: string): Promise<ReviewContext>;
+    getReviewContext(conversationId: string): Promise<ReviewContext>;
     startWorkflowRun(opts: TuiWorkflowRunStartRequest): Promise<TuiWorkflowRunStartResult>;
     resolveStartupProject(opts: {
         workspacePath: string;
-        sessionKey: string;
+        conversationId: string;
         agentId: string;
         autoCreate?: boolean;
     }): Promise<TuiStartupProjectResult>;
     resumeChat(opts: {
-        sessionKey: string;
+        conversationId: string;
         runId: string;
     }): Promise<{
         ok: boolean;
         reason?: string;
     }>;
     abortChat(opts: {
-        sessionKey: string;
+        conversationId: string;
         runId: string;
     }): Promise<{
         ok: boolean;
     }>;
     submitChatInput(opts: {
-        sessionKey: string;
+        conversationId: string;
         message: string;
         delivery: 'next' | 'steer';
     }): Promise<{
         ok: boolean;
         effectiveDelivery?: 'next' | 'steer';
     }>;
-    getChatInputState(sessionKey: string): Promise<TuiChatInputState>;
-    getStartupResources(sessionKey: string): Promise<TuiStartupResources>;
+    getChatInputState(conversationId: string): Promise<TuiChatInputState>;
+    getStartupResources(conversationId: string): Promise<TuiStartupResources>;
     loadHistory(opts: {
-        sessionKey: string;
+        conversationId: string;
         limit?: number;
     }): Promise<{
         messages: HistoryMessage[];
     }>;
     loadHistoryWindow(opts: {
-        sessionKey: string;
+        conversationId: string;
         rowNumber: number;
         before?: number;
         after?: number;
@@ -91,48 +91,49 @@ export declare class GatewayRealtimeBackend implements TuiBackend {
         endRowNumber: number;
         totalRows: number;
     }>;
-    loadTranscriptTree(sessionKey: string): Promise<TuiTranscriptTreeEntry[]>;
-    loadTimeline(sessionKey: string): Promise<SessionTimelineItem[]>;
-    getSessionStats(sessionKey: string): Promise<TuiSessionStats>;
+    loadTranscriptTree(conversationId: string): Promise<TuiTranscriptTreeEntry[]>;
+    loadTimeline(conversationId: string): Promise<SessionTimelineItem[]>;
+    getSessionStats(conversationId: string): Promise<TuiSessionStats>;
     listSessions(): Promise<TuiSessionItem[]>;
     listAgents(): Promise<TuiAgentInfo[]>;
     setTuiDefaultAgent(agentId: string): Promise<{
         agentId: string;
     }>;
-    getSessionInfo(sessionKey: string): Promise<SessionInfo>;
+    createConversation(agentId: string, conversationId?: string): Promise<string>;
+    getSessionInfo(conversationId: string): Promise<SessionInfo>;
     listModels(): Promise<TuiModelChoice[]>;
-    resetSession(sessionKey: string): Promise<void>;
-    compactSession(sessionKey: string, options?: {
+    resetSession(conversationId: string): Promise<void>;
+    compactSession(conversationId: string, options?: {
         force?: boolean;
         instructions?: string;
     }): Promise<TuiCompactionResult>;
-    exportSession(sessionKey: string, format: ExportFormat): Promise<string>;
-    importSession(targetSessionKey: string, jsonContent: string): Promise<{
-        sessionKey: string;
+    exportSession(conversationId: string, format: ExportFormat): Promise<string>;
+    importSession(targetConversationId: string, jsonContent: string): Promise<{
+        conversationId: string;
         rowCount: number;
     }>;
-    createShare(sessionKey: string, request: TuiShareRequest, options?: {
+    createShare(conversationId: string, request: TuiShareRequest, options?: {
         agentId?: string;
     }): Promise<TuiShareResult>;
-    btwQuery(sessionKey: string, question: string): Promise<{
+    btwQuery(conversationId: string, question: string): Promise<{
         text: string;
         error?: string;
     }>;
-    forkSession(sourceSessionKey: string, targetSessionKey: string): Promise<{
-        sessionKey: string;
+    forkSession(sourceConversationId: string, targetConversationId: string): Promise<{
+        conversationId: string;
         rowCount: number;
     }>;
-    forkSessionAt(sourceSessionKey: string, targetSessionKey: string, entryId: string): Promise<{
-        sessionKey: string;
+    forkSessionAt(sourceConversationId: string, targetConversationId: string, entryId: string): Promise<{
+        conversationId: string;
         rowCount: number;
     }>;
-    setTranscriptLabel(sessionKey: string, entryId: string, label: string | undefined): Promise<{
+    setTranscriptLabel(conversationId: string, entryId: string, label: string | undefined): Promise<{
         ok: boolean;
     }>;
-    appendCustomEntry(sessionKey: string, customType: string, data?: unknown): Promise<{
+    appendCustomEntry(conversationId: string, customType: string, data?: unknown): Promise<{
         ok: boolean;
     }>;
-    appendCustomMessage(sessionKey: string, message: {
+    appendCustomMessage(conversationId: string, message: {
         customType: string;
         content?: string | unknown[];
         display?: boolean;
@@ -140,7 +141,7 @@ export declare class GatewayRealtimeBackend implements TuiBackend {
     }): Promise<{
         ok: boolean;
     }>;
-    appendBashExecution(sessionKey: string, entry: {
+    appendBashExecution(conversationId: string, entry: {
         command: string;
         output?: string;
         exitCode?: number | null;
@@ -151,11 +152,11 @@ export declare class GatewayRealtimeBackend implements TuiBackend {
     }): Promise<{
         ok: boolean;
     }>;
-    patchSession(sessionKey: string, patch: Record<string, unknown>): Promise<void>;
-    renameSession(sessionKey: string, name: string): Promise<{
+    patchSession(conversationId: string, patch: Record<string, unknown>): Promise<void>;
+    renameSession(conversationId: string, name: string): Promise<{
         ok: boolean;
     }>;
-    deleteSession(sessionKey: string): Promise<{
+    deleteSession(conversationId: string): Promise<{
         ok: boolean;
     }>;
     private startRealtime;

package/dist/src/tui/backends/gateway-realtime-backend.js

@@ -47,7 +47,7 @@ var GatewayRealtimeBackend = class {
 	clientId = `tui-${crypto.randomUUID()}`;
 	realtime = null;
 	activeRunId = null;
-	observedSessionKey = null;
+	observedConversationId = null;
 	chatAbort = null;
 	onEvent;
 	onConnected;
@@ -67,7 +67,7 @@ var GatewayRealtimeBackend = class {
 		this.realtime?.disconnect();
 		this.realtime = null;
 		this.activeRunId = null;
-		this.observedSessionKey = null;
+		this.observedConversationId = null;
 		this.chatAbort?.abort();
 		this.chatAbort = null;
 	}
@@ -89,12 +89,12 @@ var GatewayRealtimeBackend = class {
 		return (await res.json()).item;
 	}
 	async sendChat(opts) {
-		this.observedSessionKey = opts.sessionKey;
+		this.observedConversationId = opts.conversationId;
 		this.chatAbort?.abort();
 		this.chatAbort = new AbortController();
 		const signal = this.chatAbort.signal;
 		const clientMessageId = crypto.randomUUID();
-		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(opts.sessionKey)}/inputs`, this.credential, {
+		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(opts.conversationId)}/inputs`, this.credential, {
 			method: "POST",
 			body: JSON.stringify({
 				clientMessageId,
@@ -111,17 +111,17 @@ var GatewayRealtimeBackend = class {
 		const own = state?.inputs?.find((input) => input.clientMessageId === clientMessageId);
 		const runId = state?.activeRunId ?? crypto.randomUUID();
 		if (state?.activeRunId && own?.id === state.activeInputId) this.resumeChat({
-			sessionKey: opts.sessionKey,
+			conversationId: opts.conversationId,
 			runId
 		});
 		return { runId };
 	}
-	async searchWorkspaceFiles(sessionKey, query, options) {
+	async searchWorkspaceFiles(conversationId, query, options) {
 		try {
 			const params = new URLSearchParams();
 			params.set("q", query);
 			params.set("limit", String(options?.limit ?? 15));
-			const context = await gatewayFetch(this.baseUrl, `/api/files/contexts/session/${encodeURIComponent(sessionKey)}`, this.credential);
+			const context = await gatewayFetch(this.baseUrl, `/api/files/contexts/session/${encodeURIComponent(conversationId)}`, this.credential);
 			if (!context.ok) return [];
 			const contextJson = await context.json();
 			if (!contextJson.space?.id) return [];
@@ -137,14 +137,14 @@ var GatewayRealtimeBackend = class {
 			const errorMessage = err instanceof Error ? err.message : String(err);
 			log.warn({
 				err,
-				sessionKey,
+				conversationId,
 				errorMessage
 			}, `Gateway workspace file search failed: ${errorMessage}`);
 			return [];
 		}
 	}
-	async getReviewContext(sessionKey) {
-		const params = new URLSearchParams({ sessionKey });
+	async getReviewContext(conversationId) {
+		const params = new URLSearchParams({ conversationId });
 		const res = await gatewayFetch(this.baseUrl, `/api/review/context?${params.toString()}`, this.credential);
 		const json = await res.json().catch(() => ({}));
 		if (!res.ok || !json.ok || !json.payload) throw new Error(json.error?.message ?? `Review context failed (${res.status})`);
@@ -157,20 +157,20 @@ var GatewayRealtimeBackend = class {
 			body: JSON.stringify({
 				definitionId: opts.definitionId,
 				agentId: opts.agentId,
-				parentSessionKey: opts.sessionKey,
+				parentConversationId: opts.conversationId,
 				source: {
 					kind: "chat",
-					sessionKey: opts.sessionKey
+					conversationId: opts.conversationId
 				},
 				...goal ? { goal } : {},
 				...opts.input !== void 0 ? { input: opts.input } : {}
 			})
 		});
 		const json = await res.json().catch(() => ({}));
-		if (!res.ok || !json.runId || !json.sessionKey) throw new Error(json.error ?? `Workflow start failed (${res.status})`);
+		if (!res.ok || !json.runId || !json.conversationId) throw new Error(json.error ?? `Workflow start failed (${res.status})`);
 		return {
 			runId: json.runId,
-			sessionKey: json.sessionKey,
+			conversationId: json.conversationId,
 			definitionId: opts.definitionId
 		};
 	}
@@ -188,7 +188,7 @@ var GatewayRealtimeBackend = class {
 		};
 	}
 	async resumeChat(opts) {
-		this.observedSessionKey = opts.sessionKey;
+		this.observedConversationId = opts.conversationId;
 		this.chatAbort?.abort();
 		this.chatAbort = new AbortController();
 		this.unsubscribeActiveRun();
@@ -210,9 +210,9 @@ var GatewayRealtimeBackend = class {
 		}
 	}
 	async submitChatInput(opts) {
-		this.observedSessionKey = opts.sessionKey;
+		this.observedConversationId = opts.conversationId;
 		try {
-			const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(opts.sessionKey)}/inputs`, this.credential, {
+			const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(opts.conversationId)}/inputs`, this.credential, {
 				method: "POST",
 				body: JSON.stringify({
 					clientMessageId: crypto.randomUUID(),
@@ -230,12 +230,12 @@ var GatewayRealtimeBackend = class {
 			return { ok: false };
 		}
 	}
-	async getChatInputState(sessionKey) {
-		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}/input-state`, this.credential);
+	async getChatInputState(conversationId) {
+		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(conversationId)}/input-state`, this.credential);
 		if (!res.ok) throw new Error(`Input state failed (${res.status})`);
 		return (await res.json()).payload;
 	}
-	async getStartupResources(sessionKey) {
+	async getStartupResources(conversationId) {
 		const empty = {
 			context: [],
 			skills: [],
@@ -243,7 +243,7 @@ var GatewayRealtimeBackend = class {
 			connectors: []
 		};
 		try {
-			const res = await gatewayFetch(this.baseUrl, `/api/tui/startup-resources?sessionKey=${encodeURIComponent(sessionKey)}`, this.credential);
+			const res = await gatewayFetch(this.baseUrl, `/api/tui/startup-resources?conversationId=${encodeURIComponent(conversationId)}`, this.credential);
 			if (!res.ok) return empty;
 			const json = await res.json();
 			return {
@@ -256,7 +256,7 @@ var GatewayRealtimeBackend = class {
 			const errorMessage = error instanceof Error ? error.message : String(error);
 			log.warn({
 				err: error,
-				sessionKey,
+				conversationId,
 				errorMessage
 			}, `Failed to load startup resources: ${errorMessage}`);
 			return empty;
@@ -264,7 +264,7 @@ var GatewayRealtimeBackend = class {
 	}
 	async loadHistory(opts) {
 		try {
-			const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(opts.sessionKey)}?include=transcriptRows`, this.credential);
+			const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(opts.conversationId)}?include=transcriptRows`, this.credential);
 			if (!res.ok) return { messages: [] };
 			const json = await res.json();
 			return { messages: transcriptRowsToClientHistory(Array.isArray(json.session?.transcriptRows) ? json.session.transcriptRows : [], { limit: opts.limit }) };
@@ -284,7 +284,7 @@ var GatewayRealtimeBackend = class {
 			after: String(opts.after ?? 120)
 		});
 		try {
-			const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(opts.sessionKey)}/transcript/window?${params.toString()}`, this.credential);
+			const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(opts.conversationId)}/transcript/window?${params.toString()}`, this.credential);
 			if (!res.ok) return {
 				messages: [],
 				startRowNumber: 0,
@@ -302,7 +302,7 @@ var GatewayRealtimeBackend = class {
 			const errorMessage = error instanceof Error ? error.message : String(error);
 			log.warn({
 				err: error,
-				sessionKey: opts.sessionKey,
+				conversationId: opts.conversationId,
 				rowNumber: opts.rowNumber,
 				errorMessage
 			}, `Failed to load history window: ${errorMessage}`);
@@ -314,9 +314,9 @@ var GatewayRealtimeBackend = class {
 			};
 		}
 	}
-	async loadTranscriptTree(sessionKey) {
+	async loadTranscriptTree(conversationId) {
 		try {
-			const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}?include=transcriptRows`, this.credential);
+			const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(conversationId)}?include=transcriptRows`, this.credential);
 			if (!res.ok) return [];
 			const json = await res.json();
 			return buildTuiTranscriptTree(Array.isArray(json.session?.transcriptRows) ? json.session.transcriptRows : []);
@@ -324,15 +324,15 @@ var GatewayRealtimeBackend = class {
 			const errorMessage = error instanceof Error ? error.message : String(error);
 			log.warn({
 				err: error,
-				sessionKey,
+				conversationId,
 				errorMessage
 			}, `Failed to load transcript tree: ${errorMessage}`);
 			return [];
 		}
 	}
-	async loadTimeline(sessionKey) {
+	async loadTimeline(conversationId) {
 		try {
-			const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}/timeline`, this.credential);
+			const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(conversationId)}/timeline`, this.credential);
 			if (!res.ok) return [];
 			const json = await res.json();
 			return Array.isArray(json.items) ? json.items : [];
@@ -340,15 +340,15 @@ var GatewayRealtimeBackend = class {
 			const errorMessage = error instanceof Error ? error.message : String(error);
 			log.warn({
 				err: error,
-				sessionKey,
+				conversationId,
 				errorMessage
 			}, `Failed to load timeline: ${errorMessage}`);
 			return [];
 		}
 	}
-	async getSessionStats(sessionKey) {
+	async getSessionStats(conversationId) {
 		try {
-			const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}?include=transcriptRows`, this.credential);
+			const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(conversationId)}?include=transcriptRows`, this.credential);
 			if (!res.ok) return computeTuiSessionStats([]);
 			const json = await res.json();
 			return computeTuiSessionStats(Array.isArray(json.session?.transcriptRows) ? json.session.transcriptRows : []);
@@ -356,7 +356,7 @@ var GatewayRealtimeBackend = class {
 			const errorMessage = error instanceof Error ? error.message : String(error);
 			log.warn({
 				err: error,
-				sessionKey,
+				conversationId,
 				errorMessage
 			}, `Failed to load session stats: ${errorMessage}`);
 			return computeTuiSessionStats([]);
@@ -368,12 +368,15 @@ var GatewayRealtimeBackend = class {
 			if (!res.ok) return [];
 			return ((await res.json()).items ?? []).map((s) => ({
 				key: s.key,
+				agentId: s.agentId,
+				sourceChannel: s.sourceChannel,
+				generatedShell: s.customData?.genericNewChatShell === true,
 				displayName: s.name,
 				updatedAt: s.updatedAt ? Date.parse(s.updatedAt) : void 0,
 				totalTokens: s.estimatedTokens ?? null,
 				messageCount: typeof s.messageCount === "number" ? s.messageCount : void 0,
 				model: typeof s.customData?.model === "string" ? s.customData.model : typeof s.customData?.modelRef === "string" ? s.customData.modelRef : null,
-				forkedFromSessionKey: typeof s.customData?.forkedFromSessionKey === "string" ? s.customData.forkedFromSessionKey : void 0,
+				forkedFromConversationId: typeof s.customData?.forkedFromConversationId === "string" ? s.customData.forkedFromConversationId : void 0,
 				cwd: typeof s.cwd === "string" ? s.cwd : void 0
 			}));
 		} catch {
@@ -419,15 +422,29 @@ var GatewayRealtimeBackend = class {
 		const saved = json.payload?.config?.tui?.defaultAgent;
 		return { agentId: typeof saved === "string" && saved.trim() ? saved.trim().toLowerCase() : target };
 	}
-	async getSessionInfo(sessionKey) {
+	async createConversation(agentId, conversationId) {
+		const res = await gatewayFetch(this.baseUrl, "/api/sessions", this.credential, {
+			method: "POST",
+			body: JSON.stringify({
+				agentId,
+				conversationId,
+				channel: "tui"
+			})
+		});
+		if (!res.ok) throw new Error(`Conversation creation failed (${res.status})`);
+		return (await res.json()).conversationId;
+	}
+	async getSessionInfo(conversationId) {
 		const out = {};
 		try {
-			const sessionPath = `/api/sessions/${encodeURIComponent(sessionKey)}`;
+			const sessionPath = `/api/sessions/${encodeURIComponent(conversationId)}`;
 			const [sessionRes, agentCfgRes] = await Promise.all([gatewayFetch(this.baseUrl, sessionPath, this.credential), gatewayFetch(this.baseUrl, `${sessionPath}/agent-config`, this.credential)]);
 			let session;
 			if (sessionRes.ok) {
 				session = (await sessionRes.json()).session;
 				if (session) {
+					out.agentId = session.agentId;
+					out.generatedShell = session.customData?.genericNewChatShell === true;
 					if (session.name) out.displayName = session.name;
 					if (session.estimatedTokens != null) out.totalTokens = session.estimatedTokens;
 					if (session.projectId?.trim()) out.projectId = session.projectId.trim();
@@ -479,12 +496,12 @@ var GatewayRealtimeBackend = class {
 			return [];
 		}
 	}
-	async resetSession(sessionKey) {
-		await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}/reset`, this.credential, { method: "POST" }).catch(() => {});
+	async resetSession(conversationId) {
+		await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(conversationId)}/reset`, this.credential, { method: "POST" }).catch(() => {});
 	}
-	async compactSession(sessionKey, options) {
+	async compactSession(conversationId, options) {
 		try {
-			const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}/compaction/run`, this.credential, {
+			const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(conversationId)}/compaction/run`, this.credential, {
 				method: "POST",
 				body: JSON.stringify({
 					force: options?.force ?? true,
@@ -514,28 +531,28 @@ var GatewayRealtimeBackend = class {
 			};
 		}
 	}
-	async exportSession(sessionKey, format) {
+	async exportSession(conversationId, format) {
 		const params = new URLSearchParams({ format });
-		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}/export?${params.toString()}`, this.credential);
+		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(conversationId)}/export?${params.toString()}`, this.credential);
 		if (!res.ok) throw new Error(`Export failed (${res.status})`);
 		return (await res.json()).content ?? "";
 	}
-	async importSession(targetSessionKey, jsonContent) {
+	async importSession(targetConversationId, jsonContent) {
 		const res = await gatewayFetch(this.baseUrl, "/api/sessions/import", this.credential, {
 			method: "POST",
 			body: JSON.stringify({
-				targetKey: targetSessionKey,
+				targetKey: targetConversationId,
 				content: jsonContent
 			})
 		});
 		const json = await res.json().catch(() => ({}));
-		if (!res.ok || json.ok === false || !json.sessionKey) throw new Error(json.error ?? `Import failed (${res.status})`);
+		if (!res.ok || json.ok === false || !json.conversationId) throw new Error(json.error ?? `Import failed (${res.status})`);
 		return {
-			sessionKey: json.sessionKey,
+			conversationId: json.conversationId,
 			rowCount: json.rowCount ?? 0
 		};
 	}
-	async createShare(sessionKey, request, options) {
+	async createShare(conversationId, request, options) {
 		const res = await gatewayFetch(this.baseUrl, "/api/shares/auto", this.credential, {
 			method: "POST",
 			body: JSON.stringify({
@@ -544,7 +561,7 @@ var GatewayRealtimeBackend = class {
 				mode: request.mode,
 				title: request.title,
 				description: request.description,
-				sessionKey,
+				conversationId,
 				agentId: options?.agentId
 			})
 		});
@@ -565,8 +582,8 @@ var GatewayRealtimeBackend = class {
 			routingHint: json.payload.routing?.hint
 		};
 	}
-	async btwQuery(sessionKey, question) {
-		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}/btw`, this.credential, {
+	async btwQuery(conversationId, question) {
+		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(conversationId)}/btw`, this.credential, {
 			method: "POST",
 			body: JSON.stringify({ question })
 		});
@@ -576,37 +593,37 @@ var GatewayRealtimeBackend = class {
 		};
 		return await res.json();
 	}
-	async forkSession(sourceSessionKey, targetSessionKey) {
-		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sourceSessionKey)}/fork`, this.credential, {
+	async forkSession(sourceConversationId, targetConversationId) {
+		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sourceConversationId)}/fork`, this.credential, {
 			method: "POST",
-			body: JSON.stringify({ targetKey: targetSessionKey })
+			body: JSON.stringify({ targetKey: targetConversationId })
 		});
 		const json = await res.json().catch(() => ({}));
-		if (!res.ok || json.ok === false || !json.sessionKey) throw new Error(json.error ?? `Fork failed (${res.status})`);
+		if (!res.ok || json.ok === false || !json.conversationId) throw new Error(json.error ?? `Fork failed (${res.status})`);
 		return {
-			sessionKey: json.sessionKey,
+			conversationId: json.conversationId,
 			rowCount: json.rowCount ?? 0
 		};
 	}
-	async forkSessionAt(sourceSessionKey, targetSessionKey, entryId) {
+	async forkSessionAt(sourceConversationId, targetConversationId, entryId) {
 		const throughRow = transcriptTreeEntryIdToRowNumber(entryId);
 		if (throughRow == null) throw new Error(`Invalid transcript entry: ${entryId}`);
-		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sourceSessionKey)}/fork-row`, this.credential, {
+		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sourceConversationId)}/fork-row`, this.credential, {
 			method: "POST",
 			body: JSON.stringify({
-				targetKey: targetSessionKey,
+				targetKey: targetConversationId,
 				throughRow
 			})
 		});
 		const json = await res.json().catch(() => ({}));
-		if (!res.ok || json.ok === false || !json.sessionKey) throw new Error(json.error ?? `Fork failed (${res.status})`);
+		if (!res.ok || json.ok === false || !json.conversationId) throw new Error(json.error ?? `Fork failed (${res.status})`);
 		return {
-			sessionKey: json.sessionKey,
+			conversationId: json.conversationId,
 			rowCount: json.rowCount ?? 0
 		};
 	}
-	async setTranscriptLabel(sessionKey, entryId, label) {
-		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}/transcript/label`, this.credential, {
+	async setTranscriptLabel(conversationId, entryId, label) {
+		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(conversationId)}/transcript/label`, this.credential, {
 			method: "POST",
 			body: JSON.stringify({
 				targetId: entryId,
@@ -617,8 +634,8 @@ var GatewayRealtimeBackend = class {
 		if (!res.ok || json.ok === false) throw new Error(json.error ?? `Label update failed (${res.status})`);
 		return { ok: true };
 	}
-	async appendCustomEntry(sessionKey, customType, data) {
-		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}/transcript/custom`, this.credential, {
+	async appendCustomEntry(conversationId, customType, data) {
+		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(conversationId)}/transcript/custom`, this.credential, {
 			method: "POST",
 			body: JSON.stringify({
 				customType,
@@ -629,8 +646,8 @@ var GatewayRealtimeBackend = class {
 		if (!res.ok || json.ok === false) throw new Error(json.error ?? `Custom entry append failed (${res.status})`);
 		return { ok: true };
 	}
-	async appendCustomMessage(sessionKey, message) {
-		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}/transcript/custom-message`, this.credential, {
+	async appendCustomMessage(conversationId, message) {
+		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(conversationId)}/transcript/custom-message`, this.credential, {
 			method: "POST",
 			body: JSON.stringify(message)
 		});
@@ -638,8 +655,8 @@ var GatewayRealtimeBackend = class {
 		if (!res.ok || json.ok === false) throw new Error(json.error ?? `Custom message append failed (${res.status})`);
 		return { ok: true };
 	}
-	async appendBashExecution(sessionKey, entry) {
-		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}/transcript/bash`, this.credential, {
+	async appendBashExecution(conversationId, entry) {
+		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(conversationId)}/transcript/bash`, this.credential, {
 			method: "POST",
 			body: JSON.stringify(entry)
 		});
@@ -647,8 +664,8 @@ var GatewayRealtimeBackend = class {
 		if (!res.ok || json.ok === false) throw new Error(json.error ?? `Bash execution append failed (${res.status})`);
 		return { ok: true };
 	}
-	async patchSession(sessionKey, patch) {
-		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}/agent-config`, this.credential, {
+	async patchSession(conversationId, patch) {
+		const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(conversationId)}/agent-config`, this.credential, {
 			method: "PATCH",
 			body: JSON.stringify(patch)
 		});
@@ -664,7 +681,7 @@ var GatewayRealtimeBackend = class {
 				...hiddenFromSessionList !== void 0 ? { hiddenFromSessionList } : {},
 				...customData ? { customData } : {}
 			};
-			const metaRes = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}`, this.credential, {
+			const metaRes = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(conversationId)}`, this.credential, {
 				method: "PATCH",
 				body: JSON.stringify(metadataPatch)
 			});
@@ -672,9 +689,9 @@ var GatewayRealtimeBackend = class {
 			if (!metaRes.ok || metaJson.ok === false) throw new Error(metaJson.error ?? `Session metadata patch failed (${metaRes.status})`);
 		}
 	}
-	async renameSession(sessionKey, name) {
+	async renameSession(conversationId, name) {
 		try {
-			return { ok: (await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}/rename`, this.credential, {
+			return { ok: (await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(conversationId)}/rename`, this.credential, {
 				method: "POST",
 				body: JSON.stringify({ name })
 			})).ok };
@@ -682,9 +699,9 @@ var GatewayRealtimeBackend = class {
 			return { ok: false };
 		}
 	}
-	async deleteSession(sessionKey) {
+	async deleteSession(conversationId) {
 		try {
-			const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(sessionKey)}`, this.credential, { method: "DELETE" });
+			const res = await gatewayFetch(this.baseUrl, `/api/sessions/${encodeURIComponent(conversationId)}`, this.credential, { method: "DELETE" });
 			if (!res.ok) return { ok: false };
 			return { ok: (await res.json()).deleted !== false };
 		} catch {
@@ -774,8 +791,8 @@ var GatewayRealtimeBackend = class {
 		}
 		if (event.topic === "sessions" && event.event === "run.started") {
 			const data = event.data;
-			if (typeof data?.sessionKey === "string" && data.sessionKey === this.observedSessionKey && typeof data.runId === "string" && data.runId && data.runId !== this.activeRunId) this.resumeChat({
-				sessionKey: data.sessionKey,
+			if (typeof data?.conversationId === "string" && data.conversationId === this.observedConversationId && typeof data.runId === "string" && data.runId && data.runId !== this.activeRunId) this.resumeChat({
+				conversationId: data.conversationId,
 				runId: data.runId
 			});
 		}