@xopcai/xopc 0.0.187 → 0.0.189

package/dist/src/gateway/service/run-gateway-agent.d.ts

@@ -1,25 +1,26 @@
+import type { TurnOrigin } from '@xopcai/endpoint-tools-protocol';
 import type { AgentService } from '../../agent/service.js';
 import type { Config } from '../../config/schema.js';
 import type { MessageBus } from '../../infra/bus/index.js';
 import type { SessionIndex } from '../../session/index.js';
 import type { ChatStreamEvent } from '../chat-stream/protocol.js';
-import type { AgentRunRelay } from '../agent-run-relay.js';
 import type { UserTurnAttachment } from '../user-turn-input.js';
 export type RunGatewayAgentYield = ChatStreamEvent;
 export type RunGatewayAgentDeps = {
     config: Config;
     agentService: AgentService;
     bus: MessageBus;
-    runRelay: AgentRunRelay;
     runAbortControllers: Map<string, AbortController>;
     activeWebchatRunBySession: Map<string, string>;
     sessionIndex: SessionIndex;
     emit: (type: string, payload: unknown) => void;
+    publishRealtime: (topic: string, event: string, data: unknown) => void;
+    completeRealtimeTopic: (topic: string) => void;
 };
 /**
  * @param runOptions.signal — When set (e.g. client disconnect), aborts in-flight generation and persists partial output.
  */
-export declare function runGatewayAgent(deps: RunGatewayAgentDeps, message: string, channel: string, chatId: string, attachments?: UserTurnAttachment[], thinking?: string, runOptions?: {
+export declare function runGatewayAgent(deps: RunGatewayAgentDeps, message: string, channel: string, chatId: string, origin: TurnOrigin, attachments?: UserTurnAttachment[], thinking?: string, runOptions?: {
     signal?: AbortSignal;
     runId?: string;
 }): AsyncGenerator<RunGatewayAgentYield, {

package/dist/src/gateway/service/run-gateway-agent.js

@@ -21,14 +21,14 @@ const log = createLogger("Gateway:Service");
 /**
 * @param runOptions.signal — When set (e.g. client disconnect), aborts in-flight generation and persists partial output.
 */
-async function* runGatewayAgent(deps, message, channel, chatId, attachments, thinking, runOptions) {
+async function* runGatewayAgent(deps, message, channel, chatId, origin, attachments, thinking, runOptions) {
 	const cappedAttachments = attachments && attachments.length > 10 ? attachments.slice(0, 10) : attachments;
 	if (attachments && cappedAttachments && attachments.length > cappedAttachments.length) log.debug({
 		dropped: attachments.length - cappedAttachments.length,
 		max: 10
 	}, "Attachments capped for webchat");
 	const runId = runOptions?.runId ?? crypto.randomUUID();
-	const { agentService, bus, runRelay, runAbortControllers, activeWebchatRunBySession, sessionIndex: sessionIndexFromDeps, emit } = deps;
+	const { agentService, bus, runAbortControllers, activeWebchatRunBySession, sessionIndex: sessionIndexFromDeps, emit, publishRealtime, completeRealtimeTopic } = deps;
 	const sessionIndex = sessionIndexFromDeps;
 	let taskRun;
 	let taskRunStatus = "failed";
@@ -44,7 +44,6 @@ async function* runGatewayAgent(deps, message, channel, chatId, attachments, thi
 		if (!meta) throw new Error("Session not found; create sessions via POST /api/sessions");
 		webchatSessionId = meta?.sessionId;
 		webchatMetadata = meta;
-		runRelay.ensureRun(runId, webchatSessionKey);
 		runAbortControllers.set(runId, new AbortController());
 	}
 	const streamSessionKey = webchatSessionKey ?? chatId;
@@ -97,16 +96,17 @@ async function* runGatewayAgent(deps, message, channel, chatId, attachments, thi
 		}
 		if (event.type === "command_completed" && event.payload.exitCode === 0 && /(^|\s)(test|vitest|jest|pytest|lint|typecheck|build)(\s|$|:)/i.test(event.payload.command)) taskRun?.captureCommand(event.payload.command, event.payload.durationMs);
 	};
-	const publishStreamEvent = (event) => channel === "webchat" ? runRelay.publish(runId, event) ?? event : event;
 	const emitAndYield = function* (events) {
 		for (const event of events) {
 			if (taskRun) captureTaskEvent(event);
-			const relayedEvent = publishStreamEvent(event);
-			if (channel === "webchat") emit("agent.stream", {
-				sessionKey: streamSessionKey,
-				event: relayedEvent
-			});
-			yield relayedEvent;
+			if (channel === "webchat") {
+				publishRealtime(`run:${runId}`, event.type, event);
+				if (event.type === "run_start") publishRealtime("sessions", "run.started", {
+					sessionKey: streamSessionKey,
+					runId
+				});
+			}
+			yield event;
 		}
 	};
 	yield* emitAndYield(mapper.start());
@@ -130,7 +130,7 @@ async function* runGatewayAgent(deps, message, channel, chatId, attachments, thi
 			}
 			let streamError;
 			try {
-				const eventStream = agentService.turnDispatcher.processDirectStreaming(stampedMessage, sessionKey, prepared, thinking, {
+				const eventStream = agentService.turnDispatcher.processDirectStreaming(stampedMessage, sessionKey, origin, prepared, thinking, {
 					signal: mergedSignal,
 					runId
 				});
@@ -143,7 +143,7 @@ async function* runGatewayAgent(deps, message, channel, chatId, attachments, thi
 				taskRunStatus = mergedSignal.aborted ? "cancelled" : "succeeded";
 				taskRunSummary = endSummary;
 				yield* emitAndYield(mapper.end(endStatus, endSummary));
-				runRelay.complete(runId);
+				completeRealtimeTopic(`run:${runId}`);
 				try {
 					const metaAfter = await sessionIndex.getSessionMetadata(sessionKey);
 					if (metaAfter?.name) emit("session.updated", {
@@ -171,7 +171,7 @@ async function* runGatewayAgent(deps, message, channel, chatId, attachments, thi
 				const errorContent = formatAgentRunErrorForClient(streamError);
 				yield* emitAndYield(mapper.error(errorContent));
 				yield* emitAndYield(mapper.end("error", streamError));
-				runRelay.complete(runId);
+				completeRealtimeTopic(`run:${runId}`);
 				return {
 					status: "error",
 					summary: streamError
@@ -242,7 +242,10 @@ async function* runGatewayAgent(deps, message, channel, chatId, attachments, thi
 			runId,
 			sessionKey: streamSessionKey,
 			timestamp: Date.now(),
-			payload: { messageId }
+			payload: {
+				messageId,
+				presentation: "answer"
+			}
 		}]);
 		yield* emitAndYield(mapper.end("success", "Message processed"));
 		taskRunStatus = "succeeded";

package/dist/src/gateway/service/session-input-coordinator.d.ts

@@ -1,3 +1,4 @@
+import type { TurnOrigin } from '@xopcai/endpoint-tools-protocol';
 import type { UserTurnAttachment } from '../user-turn-input.js';
 import { type SessionInputDelivery, type SessionInputState } from '../../storage/sqlite/index.js';
 export type SubmitSessionInput = {
@@ -7,6 +8,7 @@ export type SubmitSessionInput = {
     content: string;
     attachments?: UserTurnAttachment[];
     thinking?: string;
+    origin: TurnOrigin;
 };
 export declare class SessionInputCoordinator {
     private readonly deps;
@@ -20,6 +22,7 @@ export declare class SessionInputCoordinator {
             content: string;
             attachments?: UserTurnAttachment[];
             thinking?: string;
+            origin: TurnOrigin;
         }) => Promise<{
             status: string;
             summary: string;

package/dist/src/gateway/service/session-input-coordinator.js

@@ -65,7 +65,7 @@ var SessionInputCoordinator = class {
 		};
 		const attachments = await this.deps.prepareAttachments(sessionKey, input.attachments);
 		const runtime = this.snapshot(sessionKey);
-		const canSteer = input.delivery === "steer" && runtime.activeRunId !== void 0 && !attachments?.length;
+		const canSteer = input.origin.type !== "endpoint" && input.delivery === "steer" && runtime.activeRunId !== void 0 && !attachments?.length;
 		const effectiveDelivery = canSteer ? "steer" : "next";
 		const row = insertSessionInput({
 			id: crypto.randomUUID(),
@@ -77,6 +77,7 @@ var SessionInputCoordinator = class {
 			content,
 			attachments,
 			thinking: input.thinking,
+			origin: input.origin,
 			targetRunId: canSteer ? runtime.activeRunId : void 0
 		});
 		if (canSteer) {
@@ -121,7 +122,8 @@ var SessionInputCoordinator = class {
 						sessionKey,
 						content: input.content,
 						attachments: input.attachments,
-						thinking: input.thinking
+						thinking: input.thinking,
+						origin: input.origin
 					});
 				} catch (error) {
 					result = {

package/dist/src/gateway/service/types.d.ts

@@ -1,9 +1,4 @@
 import type { GatewayBindMode } from '../../config/schema.js';
-export interface ServiceEvent {
-    id: string;
-    type: string;
-    payload: unknown;
-}
 /** Phase-1 channel timings (init + optional defer plan + start + inline replay). Emitted as structured logs. */
 export interface GatewayChannelStartupPhase1Metrics {
     deferChannelConnectUntilAfterHttp: boolean;

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

@@ -16,11 +16,13 @@ import { listInsights, ProactiveEventService, ProactiveInboxService, ProactiveIn
 import { GatewaySessionsApi } from './service/sessions-api.js';
 import { GatewayMarketplaceService } from './service/marketplace-service.js';
 import { GatewayAgentRunner } from './service/agent-runner.js';
-import type { GatewayServiceConfig, ServiceEvent } from './service/types.js';
+import { RealtimeRuntime } from '../realtime/runtime.js';
+import type { GatewayServiceConfig } from './service/types.js';
 import { type GatewayReadinessSnapshot } from './startup-readiness.js';
 import { type ConnectorLearningCoordinator } from '../connectors/learning-coordinator.js';
 import { type ProductLanguage } from '../voice/language-profile.js';
-export type { GatewayChannelStartupPhase1Metrics, GatewayChannelStartupPhase2Metrics, GatewayServiceConfig, ServiceEvent, } from './service/types.js';
+import { EndpointToolRuntime } from '../endpoint-tools/index.js';
+export type { GatewayChannelStartupPhase1Metrics, GatewayChannelStartupPhase2Metrics, GatewayServiceConfig, } from './service/types.js';
 export declare class GatewayService {
     private serviceConfig;
     private bus;
@@ -45,7 +47,8 @@ export declare class GatewayService {
     private readonly configCoordinator;
     private readonly modelCatalogSync;
     private auth;
-    private readonly sse;
+    readonly endpointTools: EndpointToolRuntime;
+    readonly realtime: RealtimeRuntime;
     getConfig(): Config;
     getModelCatalogSync(): ModelCatalogSyncService;
     get browserRecipes(): BrowserRecipeService;
@@ -69,6 +72,7 @@ export declare class GatewayService {
     private connectedKnowledgeCoordinator;
     private stopAutomationProductEventBridge;
     private stopSessionTranscriptAutomationEvents;
+    private stopRealtimeLogBridge;
     /**
      * Webchat agent invocation surface (`runAgent`, `abortAgentRun`, `steer*`,
      * `submitClarifyResponse`, clarify-bridge dispatch). Owns the
@@ -303,12 +307,9 @@ export declare class GatewayService {
     private collectWorkflowAgentIds;
     /** Process a message directly through the agent (for CLI mode). */
     processDirect(content: string, sessionKey?: string): Promise<string>;
-    subscribe(sessionId: string, listener: (event: ServiceEvent) => Promise<void> | void): () => void;
     emit(type: string, payload: unknown): void;
     private handleAutomationRunCompleted;
     private startAutomationProductEventBridge;
-    /** Replay events since `lastEventId` for SSE reconnection. */
-    getEventsSince(sessionId: string, lastEventId: string): ServiceEvent[];
     /**
      * Validate authentication token from request headers.
      * Returns true if auth is disabled (mode: 'none') or token is valid.

package/dist/src/gateway/service.js

@@ -1,6 +1,7 @@
 import { __toCommonJS } from "../../_virtual/_rolldown/runtime.js";
 import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
 import { getLogDir } from "../utils/logger/config.js";
+import { init_log_stream, subscribeToLogs } from "../utils/logger/log-stream.js";
 import { getRuntimeLogStats } from "../utils/logger/stats.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
@@ -18,6 +19,7 @@ import { loadConfig, saveConfig } from "../config/loader.js";
 import { prewarmModelRegistry } from "../providers/model-registry.js";
 import { init_providers, providers_exports } from "../providers/index.js";
 import { TaskRepository } from "../tasks/task-repository.js";
+import { disposeAllSessionMcpRuntimes } from "../agent/mcp/bundle-mcp-runtime.js";
 import { resolveEffectiveGatewayPort } from "./host.js";
 import { AutomationService } from "../automations/service/automation-service.js";
 import { onAutomationProductEvent, publishAutomationProductEvent } from "../automations/product-events.js";
@@ -36,7 +38,6 @@ import { TaskOutboxDispatcher } from "../tasks/task-outbox-dispatcher.js";
 import { TaskRunDispatcher } from "../tasks/task-run-dispatcher.js";
 import { TaskSignalService } from "../tasks/task-signal-service.js";
 import "../tasks/index.js";
-import { disposeAllSessionMcpRuntimes } from "../agent/mcp/bundle-mcp-runtime.js";
 import "../agent/mcp/bundle-mcp-tools.js";
 import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
 import { SessionIndex } from "../session/manager.js";
@@ -63,6 +64,8 @@ import { DiscussionLiveWorker } from "../discussions/live-worker.js";
 import { DiscussionOrganizerWorker } from "../discussions/organizer-worker.js";
 import { DiscussionSealer } from "../discussions/sealer.js";
 import "../discussions/index.js";
+import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
+import "../endpoint-tools/index.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";
 import { reconcileDreamingAutomations } from "./dreaming-automation-reconciler.js";
 import { NotesStore } from "../notes/store.js";
@@ -102,7 +105,7 @@ import { GatewaySessionsApi } from "./service/sessions-api.js";
 import { GatewayMarketplaceService } from "./service/marketplace-service.js";
 import { GatewayConfigCoordinator } from "./service/config-coordinator.js";
 import { GatewayAgentRunner } from "./service/agent-runner.js";
-import { GatewaySseHub } from "./service/sse-hub.js";
+import { RealtimeRuntime } from "../realtime/runtime.js";
 import { GatewayReadiness } from "./startup-readiness.js";
 import { createGatewayStartupTrace } from "./startup-trace.js";
 import { applyAutomaticVoiceLanguage, inferProductLanguageFromEnvironment, initializeVoiceDefaults, prepareConfiguredLocalVoiceModel } from "../voice/language-profile.js";
@@ -113,6 +116,7 @@ init_channel_catalog_service();
 init_schema();
 init_providers();
 init_logger();
+init_log_stream();
 init_paths();
 init_package_version();
 init_resolve_route();
@@ -144,7 +148,8 @@ var GatewayService = class {
 		getConfig: () => this.config
 	});
 	auth;
-	sse = new GatewaySseHub();
+	endpointTools = new EndpointToolRuntime();
+	realtime = new RealtimeRuntime(this.endpointTools);
 	getConfig() {
 		return this.config;
 	}
@@ -178,6 +183,7 @@ var GatewayService = class {
 	connectedKnowledgeCoordinator = null;
 	stopAutomationProductEventBridge = null;
 	stopSessionTranscriptAutomationEvents = null;
+	stopRealtimeLogBridge = null;
 	/**
 	* Webchat agent invocation surface (`runAgent`, `abortAgentRun`, `steer*`,
 	* `submitClarifyResponse`, clarify-bridge dispatch). Owns the
@@ -220,7 +226,7 @@ var GatewayService = class {
 		this.proactiveWorker = new ProactiveWorker(new ReadonlyProactiveAgentExecutor(() => this.config));
 		this.proactiveTemporalWorker = new ProactiveTemporalWorker(this.proactive);
 		this.proactiveInboxWorker = new ProactiveInboxWorker({ deliver: async ({ inboxItem }) => {
-			this.sse.emit("proactive.inbox.created", inboxItem);
+			this.emit("proactive.inbox.created", inboxItem);
 			await this.createMobileNotificationService().deliverGatewayEvent("proactive.inbox.created", inboxItem);
 		} });
 		let bootstrapConfigChanged = initializeVoiceDefaults(this.config, inferProductLanguageFromEnvironment());
@@ -280,10 +286,10 @@ var GatewayService = class {
 		this.notesService = new NotesService(new NotesStore());
 		this.projects = new ProjectService(void 0, this.proactive);
 		const emitDiscussion = (capture) => {
-			this.sse.emit("discussion.updated", capture);
+			this.emit("discussion.updated", capture);
 		};
 		this.discussions = new DiscussionService(this.notesService, this.projects, (type, payload) => {
-			this.sse.emit(type, payload);
+			this.emit(type, payload);
 		});
 		this.discussionWorker = new DiscussionOrganizerWorker(new DiscussionOrganizer({
 			notes: this.notesService,
@@ -302,7 +308,7 @@ var GatewayService = class {
 					riskCount: organization.risks.length,
 					openQuestionCount: organization.openQuestions.length
 				};
-				this.sse.emit("discussion.completed", payload);
+				this.emit("discussion.completed", payload);
 				publishAutomationProductEvent({
 					type: "discussion.completed",
 					source: "discussions",
@@ -321,7 +327,7 @@ var GatewayService = class {
 				const transcript = this.discussions.transcript(segment.discussionId);
 				capture.then((detail) => {
 					if (!detail || !transcript) return;
-					this.sse.emit("discussion.segment.updated", {
+					this.emit("discussion.segment.updated", {
 						discussionId: segment.discussionId,
 						noteId: detail.discussion.noteId,
 						transcriptRevision: transcript.revision,
@@ -351,7 +357,11 @@ var GatewayService = class {
 			getAgentService: () => this.ensureAgentService(),
 			getChannelManager: () => this.channelManager,
 			getConfig: () => this.config,
-			emit: (type, payload) => this.sse.emit(type, payload)
+			emit: (type, payload) => this.emit(type, payload),
+			publishRealtime: (topic, event, data) => {
+				this.realtime.broker.publish(topic, event, data);
+			},
+			completeRealtimeTopic: (topic) => this.realtime.completeTopic(topic)
 		});
 		this.sessions = new GatewaySessionsApi({
 			sessionIndex: this.sessionIndex,
@@ -422,6 +432,7 @@ var GatewayService = class {
 				});
 			},
 			extensionRegistry: this.extensionLoader?.getRegistry(),
+			endpointTools: this.endpointTools,
 			getAutomationService: () => this.automationService,
 			getBrowserRecipeService: () => this.browserRecipes,
 			getNotesService: () => this.notesService,
@@ -444,8 +455,8 @@ var GatewayService = class {
 			gatewayClarify: { requestClarification: (sessionKey, request) => this.agentRunner.requestClarification({
 				sessionKey,
 				request,
-				publishSseFor: (_runId) => (e) => {
-					this._agentService.turnDispatcher.enqueueWebchatSseEvent(sessionKey, e);
+				publishStreamFor: (_runId) => (event) => {
+					this._agentService.turnDispatcher.enqueueWebchatStreamEvent(sessionKey, event);
 				}
 			}) }
 		});
@@ -542,7 +553,10 @@ var GatewayService = class {
 				return sessionKey;
 			},
 			runAgent: async (runId, sessionKey, message) => {
-				const stream = this.agentRunner.runAgent(message, "webchat", sessionKey, void 0, void 0, { runId });
+				const stream = this.agentRunner.runAgent(message, "webchat", sessionKey, {
+					type: "system",
+					source: "workflow"
+				}, void 0, void 0, { runId });
 				while (!(await stream.next()).done);
 			}
 		});
@@ -694,6 +708,9 @@ var GatewayService = class {
 	}
 	async start() {
 		if (this.running) return;
+		this.stopRealtimeLogBridge = subscribeToLogs((entry) => {
+			this.realtime.broker.publish("logs", "log.entry", entry);
+		});
 		setPairingBroadcastSink((type, payload) => {
 			this.emit(type, payload);
 		});
@@ -966,8 +983,12 @@ var GatewayService = class {
 	async stop() {
 		if (!this.running) return;
 		setPairingBroadcastSink(null);
+		this.stopRealtimeLogBridge?.();
+		this.stopRealtimeLogBridge = null;
 		log.debug("Stopping gateway service...");
 		this.readiness.markStarting();
+		this.endpointTools.close();
+		this.realtime.close();
 		await this.proactiveWorker.stop();
 		await this.discussionWorker.stop();
 		await this.discussionSealer.stop();
@@ -1408,13 +1429,13 @@ var GatewayService = class {
 	}
 	/** Process a message directly through the agent (for CLI mode). */
 	async processDirect(content, sessionKey = "agent:main:main") {
-		return this.agentService.turnDispatcher.processDirect(content, sessionKey);
-	}
-	subscribe(sessionId, listener) {
-		return this.sse.subscribe(sessionId, listener);
+		return this.agentService.turnDispatcher.processDirect(content, sessionKey, {
+			type: "system",
+			source: "internal"
+		});
 	}
 	emit(type, payload) {
-		this.sse.emit(type, payload);
+		this.realtime.broker.publish("gateway", type, payload);
 		this.createMobileNotificationService().handleGatewayEvent(type, payload);
 	}
 	handleAutomationRunCompleted(run) {
@@ -1424,7 +1445,7 @@ var GatewayService = class {
 		this.stopAutomationProductEventBridge?.();
 		this.stopSessionTranscriptAutomationEvents?.();
 		this.stopAutomationProductEventBridge = onAutomationProductEvent((event) => {
-			if (event.type.startsWith("task.")) this.sse.emit(event.type, event.payload);
+			if (event.type.startsWith("task.")) this.emit(event.type, event.payload);
 			const proactiveEvent = mapProductEventToProactive({
 				event,
 				workspaceId: this.currentWorkspacePath,
@@ -1462,10 +1483,6 @@ var GatewayService = class {
 			});
 		});
 	}
-	/** Replay events since `lastEventId` for SSE reconnection. */
-	getEventsSince(sessionId, lastEventId) {
-		return this.sse.getEventsSince(sessionId, lastEventId);
-	}
 	/**
 	* Validate authentication token from request headers.
 	* Returns true if auth is disabled (mode: 'none') or token is valid.

package/dist/src/heartbeat/index.js

@@ -1,6 +1,6 @@
 import { DEFAULT_ACK_MAX_CHARS, HEARTBEAT_OK, NO_REPLY, shouldSilence, stripHeartbeatToken } from "./tokens.js";
-import { appendCronEventLines } from "./event-prompt.js";
 import { isWithinActiveHours } from "./active-hours.js";
 import { isHeartbeatContentEmpty } from "./content-check.js";
+import { appendCronEventLines } from "./event-prompt.js";
 import { createHeartbeatWake } from "./wake.js";
 export { DEFAULT_ACK_MAX_CHARS, HEARTBEAT_OK, NO_REPLY, appendCronEventLines, createHeartbeatWake, isHeartbeatContentEmpty, isWithinActiveHours, shouldSilence, stripHeartbeatToken };

package/dist/src/mcp/channel-bridge.d.ts

@@ -1,6 +1,6 @@
 import type { Config } from '../config/schema.js';
-import type { ApprovalDecision, ApprovalKind, ClaudeChannelMode, ConversationDescriptor, PendingApproval, QueueEvent, WaitFilter } from './channel-shared.js';
-import { type GatewayCredential } from '../gateway/credential.js';
+import type { ApprovalDecision, ApprovalKind, ConversationDescriptor, PendingApproval, QueueEvent, WaitFilter } from './channel-shared.js';
+import type { GatewayCredential } from '../gateway/credential.js';
 export declare class XopcChannelBridge {
     private readonly cfg;
     private readonly params;
@@ -9,19 +9,16 @@ export declare class XopcChannelBridge {
     private readonly pendingApprovals;
     private cursor;
     private closed;
-    private eventsAbort;
+    private readonly realtimeClientId;
+    private realtime;
     constructor(cfg: Config, params: {
         gatewayUrl?: string;
         gatewayCredential?: GatewayCredential;
-        claudeChannelMode: ClaudeChannelMode;
-        verbose: boolean;
     });
-    setServer(_server: unknown): void;
     start(): Promise<void>;
     close(): Promise<void>;
-    private connectEvents;
-    private runEventsLoop;
-    private handleSseChunk;
+    private connectRealtime;
+    private handleRealtimeEvent;
     private enqueueFromBroadcast;
     private pushEvent;
     listConversations(args: {

package/dist/src/mcp/channel-bridge.js

@@ -1,15 +1,16 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_loader, loadConfig } from "../config/loader.js";
-import { gatewayCredentialAuthorization } from "../gateway/credential.js";
-import { loadUndiciRuntimeDeps } from "../infra/undici-fetch.js";
+import { RealtimeClient } from "../../packages/realtime-client/src/index.js";
 import { toConversation } from "./channel-shared.js";
 import { createGatewayHttpClientFromConfig, resolveGatewayHttpBaseUrl } from "./gateway-http-client.js";
+import { createRequire } from "node:module";
 import crypto from "node:crypto";
 //#region src/mcp/channel-bridge.ts
 init_loader();
 init_logger();
 const log = createLogger("Mcp:Bridge");
+const { WebSocket } = createRequire(import.meta.url)("ws");
 const QUEUE_LIMIT = 1e3;
 var XopcChannelBridge = class {
 	client = null;
@@ -17,12 +18,12 @@ var XopcChannelBridge = class {
 	pendingApprovals = /* @__PURE__ */ new Map();
 	cursor = 0;
 	closed = false;
-	eventsAbort = null;
+	realtimeClientId = `mcp-${crypto.randomUUID()}`;
+	realtime = null;
 	constructor(cfg, params) {
 		this.cfg = cfg;
 		this.params = params;
 	}
-	setServer(_server) {}
 	async start() {
 		log.info({ phase: "mcp.bridge.connect" }, "MCP channel bridge starting");
 		this.client = createGatewayHttpClientFromConfig({
@@ -30,7 +31,7 @@ var XopcChannelBridge = class {
 			gatewayUrl: this.params.gatewayUrl,
 			gatewayCredential: this.params.gatewayCredential
 		});
-		this.connectEvents();
+		this.connectRealtime();
 	}
 	async close() {
 		log.info({
@@ -38,84 +39,55 @@ var XopcChannelBridge = class {
 			queueSize: this.queue.length
 		}, "MCP channel bridge closing");
 		this.closed = true;
-		this.eventsAbort?.abort();
-		this.eventsAbort = null;
+		this.realtime?.disconnect();
+		this.realtime = null;
 		this.queue.length = 0;
 		this.pendingApprovals.clear();
 	}
-	connectEvents() {
+	connectRealtime() {
 		if (this.closed) return;
-		this.eventsAbort?.abort();
-		const abort = new AbortController();
-		this.eventsAbort = abort;
 		const baseUrl = resolveGatewayHttpBaseUrl(this.cfg, this.params.gatewayUrl);
-		this.runEventsLoop(baseUrl, this.params.gatewayCredential, abort.signal);
-	}
-	async runEventsLoop(baseUrl, credential, signal) {
-		const url = new URL(`${baseUrl}/api/events`);
-		const authorization = gatewayCredentialAuthorization(credential);
-		try {
-			const res = await loadUndiciRuntimeDeps().fetch(url.toString(), {
-				headers: {
-					Accept: "text/event-stream",
-					...authorization ? { Authorization: authorization } : {}
-				},
-				signal
-			});
-			if (!res.ok || !res.body) {
-				log.warn({
-					phase: "mcp.bridge.sse",
-					status: res.status,
+		this.realtime?.disconnect();
+		this.realtime = new RealtimeClient({
+			clientId: this.realtimeClientId,
+			clientKind: "mcp",
+			getWebSocketUrl: () => {
+				const url = new URL(baseUrl);
+				url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+				url.pathname = "/api/realtime/v1/ws";
+				url.search = "";
+				url.hash = "";
+				return url.toString();
+			},
+			issueTicket: async () => {
+				const response = await this.client.postJson("/api/realtime/tickets", {
+					clientId: this.realtimeClientId,
+					clientKind: "mcp"
+				});
+				if (!response.payload?.ticket) throw new Error(response.error?.message ?? "Realtime ticket response is invalid");
+				return response.payload.ticket;
+			},
+			createWebSocket: (url) => new WebSocket(url),
+			onEvent: (event) => this.handleRealtimeEvent(event),
+			onStateChange: (state, error) => {
+				if (state === "error") log.warn({
+					errorMessage: error,
+					phase: "mcp.bridge.realtime",
 					baseUrl
-				}, `Gateway events SSE connect failed: HTTP ${res.status}`);
-				return;
-			}
-			const reader = res.body.getReader();
-			const decoder = new TextDecoder();
-			let buffer = "";
-			while (!this.closed && !signal.aborted) {
-				const { done, value } = await reader.read();
-				if (done) break;
-				buffer += decoder.decode(value, { stream: true });
-				let splitAt = buffer.indexOf("\n\n");
-				while (splitAt >= 0) {
-					this.handleSseChunk(buffer.slice(0, splitAt));
-					buffer = buffer.slice(splitAt + 2);
-					splitAt = buffer.indexOf("\n\n");
-				}
+				}, `Gateway realtime connection failed: ${error ?? "unknown error"}`);
 			}
-		} catch (err) {
-			const em = err instanceof Error ? err.message : String(err);
-			if (!signal.aborted && !this.closed) log.warn({
-				err,
-				errorMessage: em,
-				phase: "mcp.bridge.sse",
-				baseUrl
-			}, `Gateway events SSE disconnected: ${em}`);
-		}
-		if (!this.closed && !signal.aborted) {
-			await new Promise((resolve) => setTimeout(resolve, 2e3));
-			if (!this.closed) this.connectEvents();
-		}
-	}
-	handleSseChunk(chunk) {
-		let eventName = "message";
-		let data = "";
-		for (const line of chunk.split("\n")) if (line.startsWith("event:")) eventName = line.slice(6).trim();
-		else if (line.startsWith("data:")) data += line.slice(5).trim();
-		if (!data) return;
-		try {
-			const parsed = JSON.parse(data);
-			this.enqueueFromBroadcast({
-				type: eventName,
-				...parsed
-			});
-		} catch {
-			this.enqueueFromBroadcast({
-				type: eventName,
-				raw: data
-			});
-		}
+		});
+		this.realtime.subscribe("gateway");
+		this.realtime.subscribe("sessions");
+		this.realtime.connect();
+	}
+	handleRealtimeEvent(event) {
+		if (event.topic !== "gateway" && event.topic !== "sessions") return;
+		const data = event.data && typeof event.data === "object" && !Array.isArray(event.data) ? event.data : { raw: event.data };
+		this.enqueueFromBroadcast({
+			...data,
+			type: event.event
+		});
 	}
 	enqueueFromBroadcast(data) {
 		const type = String(data.type ?? data.event ?? "");