@xmaxai/sdk 1.0.0 → 1.0.2

package/dist/index.cjs

@@ -441,13 +441,12 @@ function resolveRtcPublishFps(options = {}) {
 function resolveRtcPublishFrameIntervalS(options) {
   return 1 / resolveRtcPublishFps(options);
 }
-exports.MOBILE_PUBLISH_MAX_WIDTH_PX = void 0; exports.RTC_PUBLISH_FPS_WEB = void 0; exports.RTC_PUBLISH_FPS_MOBILE = void 0; exports.RTC_PUBLISH_FPS = void 0; exports.RTC_PUBLISH_FRAME_INTERVAL_S = void 0; exports.RTC_PUBLISH_FRAME_INTERVAL_MS = void 0; exports.MEDIA_TIME_EPSILON_S = void 0; exports.MEDIA_TIME_LOOP_JUMP_S = void 0;
+exports.MOBILE_PUBLISH_MAX_WIDTH_PX = void 0; exports.RTC_PUBLISH_FPS_WEB = void 0; exports.RTC_PUBLISH_FPS_MOBILE = void 0; exports.RTC_PUBLISH_FRAME_INTERVAL_S = void 0; exports.RTC_PUBLISH_FRAME_INTERVAL_MS = void 0; exports.MEDIA_TIME_EPSILON_S = void 0; exports.MEDIA_TIME_LOOP_JUMP_S = void 0;
 var init_publish_fps = __esm({
   "src/rtc/publish-fps.ts"() {
     exports.MOBILE_PUBLISH_MAX_WIDTH_PX = 768;
     exports.RTC_PUBLISH_FPS_WEB = 30;
     exports.RTC_PUBLISH_FPS_MOBILE = 24;
-    exports.RTC_PUBLISH_FPS = exports.RTC_PUBLISH_FPS_WEB;
     exports.RTC_PUBLISH_FRAME_INTERVAL_S = 1 / exports.RTC_PUBLISH_FPS_WEB;
     exports.RTC_PUBLISH_FRAME_INTERVAL_MS = 1e3 / exports.RTC_PUBLISH_FPS_WEB;
     exports.MEDIA_TIME_EPSILON_S = 1e-3;
@@ -627,17 +626,6 @@ function shouldSampleAtMediaTime(lastMediaTimeS, mediaTimeS) {
   }
   return mediaTimeS > lastMediaTimeS + exports.MEDIA_TIME_EPSILON_S;
 }
-function sampleCanvasFingerprint(ctx, width, height) {
-  const points = [
-    [0, 0],
-    [Math.max(0, (width >> 1) - 1), Math.max(0, (height >> 1) - 1)],
-    [Math.max(0, width - 1), Math.max(0, height - 1)]
-  ];
-  return points.map(([x, y]) => {
-    const data = ctx.getImageData(x, y, 1, 1).data;
-    return `${data[0]},${data[1]},${data[2]}`;
-  }).join("|");
-}
 async function applyPublishTrackConstraints(track, width, height) {
   if (typeof track.applyConstraints !== "function") {
     return;
@@ -710,12 +698,6 @@ async function createVideoFileStream(fileOrUrl, options = {}) {
   let lastDrawMediaTimeS = -1;
   let videoFrameCallbackId = null;
   let rafId = null;
-  const logPublishFrames = options.logPublishFrames ?? false;
-  let publishFrameIndex = 0;
-  let lastPublishWallMs = 0;
-  let lastPublishMediaTimeS = -1;
-  let publishFramesInWindow = 0;
-  let publishWindowStartMs = 0;
   const drawFrame = () => {
     if (destroyed) {
       return;
@@ -729,52 +711,13 @@ async function createVideoFileStream(fileOrUrl, options = {}) {
       sourceHeight
     );
   };
-  const logPublishedFrame = (mediaTimeS, presentedFrames) => {
-    if (!logPublishFrames) {
-      return;
-    }
-    publishFrameIndex += 1;
-    const wallNowMs = performance.now();
-    const wallDeltaMs = lastPublishWallMs > 0 ? wallNowMs - lastPublishWallMs : 0;
-    const mediaDeltaS = lastPublishMediaTimeS >= 0 ? mediaTimeS - lastPublishMediaTimeS : 0;
-    lastPublishWallMs = wallNowMs;
-    lastPublishMediaTimeS = mediaTimeS;
-    publishFramesInWindow += 1;
-    if (publishWindowStartMs === 0) {
-      publishWindowStartMs = wallNowMs;
-    }
-    const fingerprint = sampleCanvasFingerprint(ctx, outputWidth, outputHeight);
-    console.warn("[upload-video \u2192 publishFrame]", {
-      frameIndex: publishFrameIndex,
-      mediaTimeS: Number(mediaTimeS.toFixed(4)),
-      mediaDeltaS: Number(mediaDeltaS.toFixed(4)),
-      wallDeltaMs: Number(wallDeltaMs.toFixed(1)),
-      effectiveFps: wallDeltaMs > 0 ? Number((1e3 / wallDeltaMs).toFixed(1)) : null,
-      presentedFrames,
-      size: `${outputWidth}\xD7${outputHeight}`,
-      fingerprint
-    });
-    const windowElapsedMs = wallNowMs - publishWindowStartMs;
-    if (windowElapsedMs >= 1e3) {
-      console.warn("[upload-video \u2192 publishFps]", {
-        framesInLast1s: publishFramesInWindow,
-        avgFps: Number((publishFramesInWindow / (windowElapsedMs / 1e3)).toFixed(2)),
-        videoCurrentTime: Number(videoEl.currentTime.toFixed(4)),
-        videoPaused: videoEl.paused,
-        videoReadyState: videoEl.readyState
-      });
-      publishFramesInWindow = 0;
-      publishWindowStartMs = wallNowMs;
-    }
-  };
-  const onPlaybackSample = (mediaTimeS, presentedFrames) => {
+  const onPlaybackSample = (mediaTimeS) => {
     if (destroyed || !shouldSampleAtMediaTime(lastDrawMediaTimeS, mediaTimeS)) {
       return;
     }
     lastDrawMediaTimeS = mediaTimeS;
     lastAdvanceAt = Date.now();
     drawFrame();
-    logPublishedFrame(mediaTimeS, presentedFrames);
   };
   const schedulePlaybackWatch = () => {
     if (destroyed) {
@@ -783,7 +726,7 @@ async function createVideoFileStream(fileOrUrl, options = {}) {
     const video = videoEl;
     if (video.requestVideoFrameCallback) {
       videoFrameCallbackId = video.requestVideoFrameCallback((_now, metadata) => {
-        onPlaybackSample(metadata.mediaTime, metadata.presentedFrames);
+        onPlaybackSample(metadata.mediaTime);
         schedulePlaybackWatch();
       });
       return;
@@ -794,7 +737,6 @@ async function createVideoFileStream(fileOrUrl, options = {}) {
     });
   };
   drawFrame();
-  logPublishedFrame(videoEl.currentTime);
   schedulePlaybackWatch();
   const ensurePlaying = () => {
     if (destroyed) {
@@ -816,18 +758,6 @@ async function createVideoFileStream(fileOrUrl, options = {}) {
   videoEl.addEventListener("ended", ensurePlaying);
   videoEl.addEventListener("stalled", ensurePlaying);
   videoEl.addEventListener("waiting", ensurePlaying);
-  if (logPublishFrames) {
-    const logPlaybackEvent = (eventName) => {
-      console.warn("[upload-video \u2192 playbackEvent]", {
-        event: eventName,
-        currentTime: Number(videoEl.currentTime.toFixed(4)),
-        readyState: videoEl.readyState,
-        paused: videoEl.paused
-      });
-    };
-    videoEl.addEventListener("waiting", () => logPlaybackEvent("waiting"));
-    videoEl.addEventListener("stalled", () => logPlaybackEvent("stalled"));
-  }
   const healthIntervalMs = options.healthIntervalMs ?? 3e3;
   let healthTimer = null;
   if (options.onHealthReport) {
@@ -1009,148 +939,13 @@ var init_video_file_stream = __esm({
 // src/sdk/client.ts
 init_i18n();
 
-// src/shared/browser-toast.ts
-var TOAST_ROOT_ID = "Xmax-sdk-toast-root";
-var TOAST_DURATION_MS = 3e3;
-var toastSeed = 0;
-var timeoutMap = /* @__PURE__ */ new Map();
-var elementMap = /* @__PURE__ */ new Map();
-function ensureToastRoot() {
-  if (typeof document === "undefined") {
-    return null;
-  }
-  let root = document.getElementById(TOAST_ROOT_ID);
-  if (root) {
-    return root;
-  }
-  root = document.createElement("div");
-  root.id = TOAST_ROOT_ID;
-  root.setAttribute("aria-live", "polite");
-  Object.assign(root.style, {
-    position: "fixed",
-    left: "50%",
-    top: "24px",
-    transform: "translateX(-50%)",
-    zIndex: "3000",
-    display: "flex",
-    flexDirection: "column",
-    alignItems: "center",
-    gap: "12px",
-    pointerEvents: "none"
-  });
-  document.body.appendChild(root);
-  return root;
-}
-function createIcon(type) {
-  const icon = document.createElement("span");
-  icon.setAttribute("aria-hidden", "true");
-  icon.innerHTML = type === "success" ? '<svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 12 12" fill="none"><path d="M10 3L4.5 8.5 2 6" stroke="#4ade80" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/></svg>' : '<svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 12 12" fill="none"><circle cx="6" cy="6" r="5" stroke="#f87171" stroke-width="1.5"/><path d="M4 4l4 4M8 4L4 8" stroke="#f87171" stroke-width="1.5" stroke-linecap="round"/></svg>';
-  Object.assign(icon.style, {
-    display: "inline-flex",
-    width: "12px",
-    height: "12px",
-    flexShrink: "0"
-  });
-  return icon;
-}
-function clearToastTimer(id) {
-  const timer = timeoutMap.get(id);
-  if (timer) {
-    window.clearTimeout(timer);
-    timeoutMap.delete(id);
-  }
-}
-function destroyToast(id) {
-  if (!id) {
-    timeoutMap.forEach((timer) => window.clearTimeout(timer));
-    timeoutMap.clear();
-    elementMap.forEach((element2) => element2.remove());
-    elementMap.clear();
-    const root2 = typeof document !== "undefined" ? document.getElementById(TOAST_ROOT_ID) : null;
-    root2?.remove();
-    return;
-  }
-  clearToastTimer(id);
-  const element = elementMap.get(id);
-  element?.remove();
-  elementMap.delete(id);
-  const root = typeof document !== "undefined" ? document.getElementById(TOAST_ROOT_ID) : null;
-  if (root && !root.childElementCount) {
-    root.remove();
-  }
-}
-function showToast(type, message, options) {
-  const root = ensureToastRoot();
-  if (!root) {
-    return "";
-  }
-  const id = options?.key || `toast-${Date.now()}-${++toastSeed}`;
-  clearToastTimer(id);
-  elementMap.get(id)?.remove();
-  const isMobile = typeof window !== "undefined" && window.matchMedia("(max-width: 768px)").matches;
-  const textSize = isMobile ? "12px" : "14px";
-  const toast = document.createElement("div");
-  toast.setAttribute("role", "status");
-  Object.assign(toast.style, {
-    pointerEvents: "auto",
-    display: "flex",
-    alignItems: "center",
-    gap: "12px",
-    minWidth: "240px",
-    padding: "16px",
-    borderRadius: "12px",
-    border: "1px solid rgba(255, 255, 255, 0.20)",
-    background: "rgba(0, 0, 0, 0.80)",
-    boxShadow: "0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1)",
-    fontFamily: "Rubik, ui-sans-serif, system-ui, sans-serif",
-    fontSize: textSize,
-    fontWeight: "400",
-    lineHeight: "14px"
-  });
-  const content = document.createElement("span");
-  content.textContent = message;
-  Object.assign(content.style, {
-    paddingRight: "0px",
-    textAlign: "center",
-    color: "#ffffff",
-    fontFamily: "Rubik, ui-sans-serif, system-ui, sans-serif",
-    fontSize: textSize,
-    fontWeight: "400",
-    lineHeight: "14px"
-  });
-  toast.appendChild(createIcon(type));
-  toast.appendChild(content);
-  root.appendChild(toast);
-  elementMap.set(id, toast);
-  const timer = window.setTimeout(() => {
-    destroyToast(id);
-  }, options?.duration ?? TOAST_DURATION_MS);
-  timeoutMap.set(id, timer);
-  return id;
-}
-var browserToast = {
-  success(message, options) {
-    return showToast("success", message, options);
-  },
-  error(message, options) {
-    return showToast("error", message, options);
-  },
-  destroy(id) {
-    destroyToast(id);
-  }
-};
-
 // src/shared/error-utils.ts
 function notifyError(error, notifier, fallbackMessage) {
   const resolved = error instanceof Error ? error : Object.assign(new Error(fallbackMessage), { cause: error });
-  if (!resolved.__XmaxNotified) {
+  if (!resolved.__XmaxNotified && notifier) {
     resolved.__XmaxNotified = true;
     const message = resolved.message || fallbackMessage;
-    if (notifier) {
-      notifier(message, error);
-    } else if (typeof window !== "undefined" && typeof document !== "undefined") {
-      browserToast.error(message);
-    }
+    notifier(message, error);
   }
   return resolved;
 }
@@ -1222,7 +1017,7 @@ var XmaxOpenClient = class {
     }
     throw notifyError(error, this.onError, message);
   }
-  /** Stop heartbeat, abort in-flight API requests, and suppress error toasts during teardown. */
+  /** Stop heartbeat, abort in-flight API requests, and suppress error notifications during teardown. */
   beginTeardown() {
     this.suppressErrorNotification = true;
     this.stopHeartbeat();
@@ -1278,7 +1073,8 @@ var XmaxOpenClient = class {
         return p.data;
       }
       const mappedMessage = resolveApiErrorMessage(p.code, this.i18n.locale);
-      const errorMessage = mappedMessage ?? this.i18n.t("errors.requestRetry");
+      const backendMessage = typeof p.message === "string" && p.message.trim() ? p.message.trim() : void 0;
+      const errorMessage = mappedMessage ?? backendMessage ?? this.i18n.t("errors.requestRetry");
       throw new Error(errorMessage);
     } catch (error) {
       if (this.isAbortError(error)) {
@@ -1430,6 +1226,7 @@ function createStartRtcRoomEvent(input) {
   const resolvedPrompt = input.prompt?.trim() ?? "";
   const refImagePath = input.refImagePath?.trim() || input.refImage?.trim() || void 0;
   const useRefImage = !!refImagePath;
+  const staticImagePath = input.staticImagePath?.trim() || void 0;
   return {
     event: "start",
     user_id: input.userId?.trim() || void 0,
@@ -1441,7 +1238,9 @@ function createStartRtcRoomEvent(input) {
       prompt: resolvedPrompt,
       ref_image_path: useRefImage ? refImagePath : void 0,
       ref_image: useRefImage ? refImagePath : void 0,
-      static_generate: input.staticGenerate === void 0 ? void 0 : input.staticGenerate,
+      // Instant-only — omit when false/undefined so non-instant starts never carry leftover flags.
+      static_generate: input.staticGenerate === true ? true : void 0,
+      static_image_path: staticImagePath,
       ...input.extraParams ?? {}
     }
   };
@@ -1727,7 +1526,7 @@ var _RtcManager = class _RtcManager {
     this.lastRemoteSei = null;
     this.lastRemoteSeiUserId = null;
     this.hasLoggedSeiSendFailure = false;
-    if (previousExpectedRemoteSei !== this.expectedRemoteSei && this.remoteVideoUserId) {
+    if (previousExpectedRemoteSei !== this.expectedRemoteSei && this.remoteVideoUserId && !this.preserveRemoteDom) {
       this.pendingRemoteVideoUserId = this.remoteVideoUserId;
       this.remoteVideoUserId = null;
     }
@@ -2075,45 +1874,6 @@ var _RtcManager = class _RtcManager {
       sentFrameRate: this.lastObservedSentFrameRate
     });
   }
-  /** @deprecated Use {@link ensurePublishedInputBeforeStart}. */
-  async waitForRtcOutboundBeforeStart(options) {
-    const timeoutMs = options?.timeoutMs ?? PUBLISH_READY_TIMEOUT_MS;
-    const publishAgeMs = this.publishStartedAtMs > 0 ? performance.now() - this.publishStartedAtMs : 0;
-    const localFramesPromise = publishAgeMs >= PUBLISH_WARM_SKIP_MS ? Promise.resolve({ ready: true, frameCount: 0, elapsedMs: 0 }) : this.waitForPublishedInputFrames({
-      minFrames: PUBLISH_START_MIN_FRAMES,
-      timeoutMs: PUBLISH_START_FRAME_TIMEOUT_MS
-    });
-    const [, rtcReady] = await Promise.all([
-      localFramesPromise,
-      this.waitForLocalPublishReady({ timeoutMs })
-    ]);
-    return rtcReady;
-  }
-  /** @deprecated Use {@link waitForRtcOutboundBeforeStart}. */
-  async waitForPublishedInputFramesBeforeStart() {
-    const waitOptions = this.resolveInputFrameWaitOptions();
-    const waitTasks = [
-      this.waitForLocalPublishReady({ timeoutMs: PUBLISH_READY_TIMEOUT_MS })
-    ];
-    if (waitOptions) {
-      waitTasks.push(
-        this.waitForMinPublishDuration(waitOptions.minPublishMs),
-        this.waitForPublishedInputFrames({
-          minFrames: waitOptions.minFrames,
-          timeoutMs: waitOptions.timeoutMs
-        })
-      );
-    }
-    const [rtcResult, ...rest] = await Promise.all(waitTasks);
-    const rtcSend = rtcResult;
-    const frameResult = waitOptions ? rest[1] : { ready: true, frameCount: 0, elapsedMs: 0 };
-    return {
-      ...frameResult,
-      rtcSendReady: rtcSend.ready,
-      rtcSendReason: rtcSend.reason,
-      rtcSendElapsedMs: rtcSend.elapsedSincePublishMs
-    };
-  }
   async waitForMinPublishDuration(minMs) {
     if (minMs <= 0 || this.publishStartedAtMs <= 0) {
       return;
@@ -3608,9 +3368,6 @@ function getFitContentRect(rect, targetSize, fitMode = "contain") {
     height
   };
 }
-function getContentRect(rect, targetSize) {
-  return getFitContentRect(rect, targetSize, "contain");
-}
 function findDragMediaElement(dragSurface) {
   const root = dragSurface.parentElement ?? dragSurface;
   if (typeof root.querySelector !== "function") {
@@ -3776,6 +3533,7 @@ function drawNeon(ctx, segs, container, targetSize, dpr, fitMode, mirrored) {
 }
 var DragTrackController = class {
   constructor(container, options) {
+    this.strokeActive = false;
     this.activePointers = /* @__PURE__ */ new Map();
     this.lastTargetPoints = /* @__PURE__ */ new Map();
     this.segQueue = [];
@@ -3785,6 +3543,8 @@ var DragTrackController = class {
     this.resizeObserver = null;
     this.container = container;
     this.onTracks = options.onTracks;
+    this.onStrokeStart = options.onStrokeStart;
+    this.onStrokeEnd = options.onStrokeEnd;
     this.targetSize = options.targetSize;
     this.fitMode = options.fitMode ?? "cover";
     this.mirrored = options.mirrored ?? false;
@@ -3955,11 +3715,17 @@ var DragTrackController = class {
       this.flushTracks();
     }, 30);
   }
-  finishStroke() {
+  finishStroke(emitEnd = false) {
+    const wasActive = this.strokeActive;
+    this.strokeActive = false;
     this.stopSampling();
     this.stopDrawLoop();
     this.segQueue.length = 0;
     this.clearCanvas();
+    if (emitEnd && wasActive && this.onStrokeEnd) {
+      Promise.resolve(this.onStrokeEnd()).catch(() => {
+      });
+    }
   }
   handlePointerDown(e) {
     if (!this.enabled) {
@@ -3983,6 +3749,12 @@ var DragTrackController = class {
     if (targetPoint) {
       this.lastTargetPoints.set(e.pointerId, targetPoint);
     }
+    const strokeWasActive = this.strokeActive;
+    this.strokeActive = true;
+    if (!strokeWasActive && this.onStrokeStart) {
+      Promise.resolve(this.onStrokeStart()).catch(() => {
+      });
+    }
     this.startDrawLoop();
     this.startSampling();
   }
@@ -4015,7 +3787,7 @@ var DragTrackController = class {
     } catch {
     }
     if (this.activePointers.size === 0) {
-      this.finishStroke();
+      this.finishStroke(true);
     }
   }
   handlePointerCancel(e) {
@@ -4025,7 +3797,7 @@ var DragTrackController = class {
     this.activePointers.delete(e.pointerId);
     this.lastTargetPoints.delete(e.pointerId);
     if (this.activePointers.size === 0) {
-      this.finishStroke();
+      this.finishStroke(true);
     }
   }
 };
@@ -4199,8 +3971,11 @@ var RealtimeSession = class _RealtimeSession {
     this.localVideoSize = null;
     this.currentPrompt = "";
     this.currentGenerationModel = "";
-    this.currentStaticGenerate = void 0;
     this.disconnected = false;
+    /** True only after `connect()` bootstrap succeeds — gates `onDisconnect`. */
+    this.sessionEstablished = false;
+    this.disconnectNotified = false;
+    this.pendingDisconnectReason = "client";
     this.remoteViewHost = null;
     this.dragController = null;
     this.dragTrackFitMode = "cover";
@@ -4214,6 +3989,7 @@ var RealtimeSession = class _RealtimeSession {
     this.rtc = rtc;
     this.reportError = reportError;
     this.onRemoteStream = options.onRemoteStream;
+    this.onDisconnect = options.onDisconnect;
     this.onPublishPipelineWaitChange = clientOptions?.onPublishPipelineWaitChange;
     if (options.remoteElement) {
       this.remoteElement = options.remoteElement;
@@ -4242,7 +4018,7 @@ var RealtimeSession = class _RealtimeSession {
   }
   static async connect(stream, options, clientOptions) {
     const sdkI18n = createSDKI18n({});
-    const notifyUserError = clientOptions.onError;
+    const notifyUserError = options.onError ?? clientOptions.onError;
     const reportError = (error, fallbackMessage) => {
       throw notifyError(error, notifyUserError, fallbackMessage ?? sdkI18n.t("errors.requestFailed"));
     };
@@ -4263,6 +4039,7 @@ var RealtimeSession = class _RealtimeSession {
     const session = new _RealtimeSession(client, rtc, reportError, options, clientOptions);
     try {
       await session.bootstrap(stream, options, clientOptions.heartbeatIntervalMs ?? 1e4, prewarmed);
+      session.sessionEstablished = true;
       return session;
     } catch (error) {
       await session.safeDisconnect();
@@ -4288,11 +4065,11 @@ var RealtimeSession = class _RealtimeSession {
         heartbeatIntervalMs,
         (heartbeatSession) => {
           if (heartbeatSession.status !== ACTIVE_STATUS) {
-            void this.safeDisconnect();
+            void this.safeDisconnect({ reason: "session_inactive" });
           }
         },
         () => {
-          void this.safeDisconnect();
+          void this.safeDisconnect({ reason: "heartbeat_error" });
         }
       );
       const joinInfo = this.client.getRtcJoinInfo(createdSession);
@@ -4335,7 +4112,6 @@ var RealtimeSession = class _RealtimeSession {
     const initialState = options.initialState;
     this.currentPrompt = resolvePromptText(initialState?.prompt);
     this.currentGenerationModel = resolveGenerationModel(initialState?.model);
-    this.currentStaticGenerate = initialState?.staticGenerate;
     const publishFpsOptions = {
       mobile: options.mobile,
       highQuality: true,
@@ -4362,7 +4138,8 @@ var RealtimeSession = class _RealtimeSession {
         model: this.currentGenerationModel || void 0,
         size: options.size,
         refImage: initialRefImageUrl,
-        staticGenerate: this.currentStaticGenerate
+        staticGenerate: initialState?.staticGenerate,
+        staticImagePath: initialState?.staticImagePath?.trim() || void 0
       });
     }
   }
@@ -4441,23 +4218,19 @@ var RealtimeSession = class _RealtimeSession {
       if (options?.model !== void 0) {
         this.currentGenerationModel = resolveGenerationModel(options.model);
       }
-      if (options?.staticGenerate !== void 0) {
-        this.currentStaticGenerate = options.staticGenerate;
-      }
       await this.runStart({
         prompt: this.currentPrompt || void 0,
         model: this.currentGenerationModel || void 0,
         size: options?.size,
         refImage: resolvedRefImage,
-        staticGenerate: this.currentStaticGenerate
+        staticGenerate: options?.staticGenerate === true ? true : void 0,
+        staticImagePath: options?.staticImagePath?.trim() || void 0,
+        preserveRemoteOutput: options?.preserveRemoteOutput
       });
     } catch (error) {
       this.reportError(error);
     }
   }
-  async setMode(options) {
-    return this.restart(options);
-  }
   async refreshRemoteOutput(options) {
     if (!this.remoteVideoContainer) {
       return;
@@ -4531,7 +4304,7 @@ var RealtimeSession = class _RealtimeSession {
       return;
     }
     this.disconnected = true;
-    await this.safeDisconnect(options);
+    await this.safeDisconnect({ ...options, reason: "client" });
   }
   getSessionUid() {
     return this.sessionUid;
@@ -4540,17 +4313,20 @@ var RealtimeSession = class _RealtimeSession {
     if (!this.rtc.snapshot.joined) {
       return;
     }
+    const preserveRemoteOutput = options.preserveRemoteOutput ?? false;
+    if (preserveRemoteOutput) {
+      this.rtc.setPreserveRemoteDom(true);
+    }
     const startPrompt = options.prompt?.trim() ?? this.currentPrompt;
     if (options.model !== void 0) {
       this.currentGenerationModel = resolveGenerationModel(options.model);
     }
-    if (options.staticGenerate !== void 0) {
-      this.currentStaticGenerate = options.staticGenerate;
-    }
     const modelLabel = resolveGenerationModel(this.currentGenerationModel);
     await this.rtc.ensurePublishedInputBeforeStart();
-    this.rtc.setRemoteVideoContainer(null);
-    this.rtc.clearRemoteVideo();
+    if (!preserveRemoteOutput) {
+      this.rtc.setRemoteVideoContainer(null);
+      this.rtc.clearRemoteVideo();
+    }
     const size = resolveSessionTargetSize({
       localVideoSize: this.localVideoSize,
       overrideSize: options.size ?? this.sessionSizeOverride
@@ -4571,16 +4347,21 @@ var RealtimeSession = class _RealtimeSession {
         size,
         prompt: startPrompt,
         refImagePath: resolveRefImagePath(options.refImage),
-        staticGenerate: this.currentStaticGenerate
+        // Never reuse prior start — caller must pass Instant fields each time.
+        staticGenerate: options.staticGenerate === true ? true : void 0,
+        staticImagePath: options.staticImagePath?.trim() || void 0
       });
-      console.log("[Xmax SDK] \u771F\u5B9E\u53D1\u9001 start ->", startRoomEvent);
       await this.rtc.sendRoomEvent(startRoomEvent);
-      await this.rtc.refreshRemoteVideoBinding({ force: true });
+      await this.rtc.refreshRemoteVideoBinding({ force: !preserveRemoteOutput });
       this.updateDragController(true);
       this.scheduleNotifyRemoteStream();
     } catch (error) {
       this.rtc.configureSessionSei(null);
       throw error;
+    } finally {
+      if (preserveRemoteOutput) {
+        this.rtc.setPreserveRemoteDom(false);
+      }
     }
   }
   isDragEnabled() {
@@ -4606,17 +4387,6 @@ var RealtimeSession = class _RealtimeSession {
         mirrored: false,
         enabled: true,
         onTracks: (tracks) => {
-          const media = this.remoteViewHost?.videoHost?.querySelector("video, canvas");
-          const mediaRect = media?.getBoundingClientRect();
-          const dragRect = dragHost.getBoundingClientRect();
-          console.log("[Xmax] sendTracks", {
-            taskUid: this.taskUid,
-            targetSize: this.sessionTargetSize,
-            fitMode: this.dragTrackFitMode,
-            tracks,
-            dragRect: dragRect ? { w: dragRect.width, h: dragRect.height } : null,
-            mediaRect: mediaRect ? { w: mediaRect.width, h: mediaRect.height, l: mediaRect.left, t: mediaRect.top } : null
-          });
           void this.sendTracks(tracks);
         }
       });
@@ -4665,7 +4435,20 @@ var RealtimeSession = class _RealtimeSession {
       this.remoteStreamNotifyTimer = null;
     }
   }
+  emitDisconnect(reason) {
+    if (!this.sessionEstablished || this.disconnectNotified) {
+      return;
+    }
+    this.disconnectNotified = true;
+    try {
+      this.onDisconnect?.(reason);
+    } catch {
+    }
+  }
   async safeDisconnect(options) {
+    const reason = options?.reason ?? this.pendingDisconnectReason;
+    this.pendingDisconnectReason = reason;
+    this.disconnected = true;
     this.clearRemoteStreamNotifyTimer();
     this.lastNotifiedRemoteStream = null;
     const activeSessionUid = this.sessionUid;
@@ -4707,7 +4490,6 @@ var RealtimeSession = class _RealtimeSession {
     this.taskUid = null;
     this.currentPrompt = "";
     this.currentGenerationModel = "";
-    this.currentStaticGenerate = void 0;
     this.sessionTargetSize = null;
     this.dragController?.destroy();
     this.dragController = null;
@@ -4717,6 +4499,7 @@ var RealtimeSession = class _RealtimeSession {
       this.hiddenRemoteElement.remove();
       this.hiddenRemoteElement = null;
     }
+    this.emitDisconnect(reason);
   }
 };
 
@@ -5056,7 +4839,6 @@ exports.createTracksRtcRoomEvent = createTracksRtcRoomEvent;
 exports.createVideoFileStream = createVideoFileStream;
 exports.createXmaxClient = createXmaxClient;
 exports.getCameraEnvironmentIssue = getCameraEnvironmentIssue;
-exports.getContentRect = getContentRect;
 exports.getDefaultMessages = getDefaultMessages;
 exports.isCameraAccessError = isCameraAccessError;
 exports.isImageMediaFile = isImageMediaFile;