@rrwebcloud/openclaw-session-recording 2026.3.28-1 → 2026.3.28

package/README.md

@@ -21,8 +21,6 @@ plugins:
 
 ## Notes
 
-- OpenClaw `2026.3.24+` uses the full automatic browser-runtime integration path
-- OpenClaw `2026.3.13` loads in legacy compatibility mode and reports clear next steps instead of failing on install
 - `serverUrl` defaults to `https://api.rrwebcloud.com`
 - `secretKey` is not required for the bundled browser flow
 - the plugin targets managed Chromium browser profiles such as `openclaw`

package/index.ts

@@ -2,6 +2,12 @@ import crypto from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
 import { Type } from "@sinclair/typebox";
+import {
+  clearManagedBrowserReplayContextsForSession,
+  registerManagedBrowserExtensions,
+  setManagedBrowserReplayContext,
+  unregisterManagedBrowserExtensions,
+} from "openclaw/plugin-sdk/browser-runtime";
 import { readJsonFileWithFallback, writeJsonFileAtomically } from "openclaw/plugin-sdk/json-store";
 import { definePluginEntry, type OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry";
 import { type AnyAgentTool, type OpenClawConfig } from "openclaw/plugin-sdk/plugin-entry";
@@ -39,28 +45,6 @@ type ReplayStateStore = {
 
 const RRWEB_PLUGIN_ID = "rrweb-replay";
 const DEFAULT_RRWEB_API_BASE_URL = "https://api.rrwebcloud.com";
-const LEGACY_BROWSER_RUNTIME_REASON =
-  "This OpenClaw host does not export plugin-sdk/browser-runtime. Automatic rrweb extension wiring requires OpenClaw >=2026.3.24. On legacy hosts, install/configure the rrweb browser addon separately or upgrade OpenClaw.";
-
-type BrowserRuntimeCompat = {
-  clearManagedBrowserReplayContextsForSession: (sessionKey: string) => void;
-  registerManagedBrowserExtensions: (params: {
-    sourceId: string;
-    profiles: string[];
-    extensionPaths: string[];
-  }) => void;
-  setManagedBrowserReplayContext: (params: {
-    cdpUrl: string;
-    profile: string;
-    sessionKey?: string;
-    sessionId?: string;
-    replaySessionId: string;
-    replayServerUrl?: string;
-    replayUrl?: string;
-    updatedAt: string;
-  }) => void;
-  unregisterManagedBrowserExtensions: (sourceId: string) => void;
-};
 
 const rrwebReplayConfigSchema = {
   parse(value: unknown): RrwebReplayConfig {
@@ -226,17 +210,10 @@ function buildReplaySessionState(params: {
 function describeReplayAvailability(params: {
   config: RrwebReplayConfig;
   extensionDir: string | null;
-  browserRuntimeAvailable: boolean;
 }): { enabled: boolean; reason?: string } {
   if (!params.config.enabled) {
     return { enabled: false, reason: "Plugin disabled in rrweb-replay config." };
   }
-  if (!params.browserRuntimeAvailable) {
-    return {
-      enabled: false,
-      reason: LEGACY_BROWSER_RUNTIME_REASON,
-    };
-  }
   if (!params.extensionDir) {
     return {
       enabled: false,
@@ -257,23 +234,6 @@ function describeReplayAvailability(params: {
   return { enabled: true };
 }
 
-async function loadBrowserRuntimeCompat(): Promise<BrowserRuntimeCompat | null> {
-  try {
-    const mod = (await import("openclaw/plugin-sdk/browser-runtime")) as BrowserRuntimeCompat;
-    if (
-      typeof mod.registerManagedBrowserExtensions === "function" &&
-      typeof mod.unregisterManagedBrowserExtensions === "function" &&
-      typeof mod.setManagedBrowserReplayContext === "function" &&
-      typeof mod.clearManagedBrowserReplayContextsForSession === "function"
-    ) {
-      return mod;
-    }
-  } catch {
-    // Legacy OpenClaw hosts do not expose plugin-sdk/browser-runtime.
-  }
-  return null;
-}
-
 function resolveBrowserProfileForReplay(params: {
   config: OpenClawConfig;
   preferredProfile?: string;
@@ -393,7 +353,6 @@ async function markReplaySessionEnded(params: {
 async function armReplayContext(params: {
   api: OpenClawPluginApi;
   pluginConfig: RrwebReplayConfig;
-  browserRuntime: BrowserRuntimeCompat | null;
   sessionKey?: string;
   sessionId?: string;
   preferredProfile?: string;
@@ -414,10 +373,10 @@ async function armReplayContext(params: {
     config: params.api.config,
     preferredProfile: params.preferredProfile ?? replayEntry.currentProfile,
   });
-  if (!params.browserRuntime || !profile || !profile.cdpUrl) {
+  if (!profile || !profile.cdpUrl) {
     return replayEntry;
   }
-  params.browserRuntime.setManagedBrowserReplayContext({
+  setManagedBrowserReplayContext({
     cdpUrl: profile.cdpUrl,
     profile: profile.name,
     sessionKey: params.sessionKey,
@@ -446,7 +405,6 @@ function createReplaySessionInfoTool(params: {
   api: OpenClawPluginApi;
   pluginConfig: RrwebReplayConfig;
   extensionDir: string | null;
-  browserRuntimePromise: Promise<BrowserRuntimeCompat | null>;
   context: {
     sessionKey?: string;
     sessionId?: string;
@@ -471,13 +429,11 @@ function createReplaySessionInfoTool(params: {
       ),
     }),
     execute: async (_id, rawParams) => {
-      const browserRuntime = await params.browserRuntimePromise;
       const toolParams =
         rawParams && typeof rawParams === "object" ? (rawParams as Record<string, unknown>) : null;
       const availability = describeReplayAvailability({
         config: params.pluginConfig,
         extensionDir: params.extensionDir,
-        browserRuntimeAvailable: Boolean(browserRuntime),
       });
       const activate = toolParams?.activate === true;
       const preferredProfile = toolParams
@@ -506,7 +462,6 @@ function createReplaySessionInfoTool(params: {
         entry = await armReplayContext({
           api: params.api,
           pluginConfig: params.pluginConfig,
-          browserRuntime,
           sessionKey: params.context.sessionKey,
           sessionId: params.context.sessionId,
           preferredProfile,
@@ -524,7 +479,6 @@ function createReplaySessionInfoTool(params: {
         enabled: availability.enabled,
         reason: availability.reason ?? entry.reason ?? null,
         activated: activate && availability.enabled,
-        compatibilityMode: browserRuntime ? "modern" : "legacy",
       });
     },
   };
@@ -539,27 +493,22 @@ export default definePluginEntry({
     const pluginConfig = rrwebReplayConfigSchema.parse(api.pluginConfig);
     const extensionDir = resolveExtensionDirectory({ config: pluginConfig, api });
     const serviceSourceId = `${RRWEB_PLUGIN_ID}:${api.source}`;
-    const browserRuntimePromise = loadBrowserRuntimeCompat();
+    const availability = describeReplayAvailability({ config: pluginConfig, extensionDir });
 
     api.registerService({
       id: "rrweb-replay-browser-extension",
       async start(ctx) {
-        const browserRuntime = await browserRuntimePromise;
         if (!pluginConfig.enabled) {
           ctx.logger.info("[rrweb-replay] disabled; not registering browser extension");
           return;
         }
-        if (!browserRuntime) {
-          ctx.logger.warn(`[rrweb-replay] ${LEGACY_BROWSER_RUNTIME_REASON}`);
-          return;
-        }
         if (!extensionDir) {
           ctx.logger.warn(
             "[rrweb-replay] extension directory missing; replay browser extension was not registered",
           );
           return;
         }
-        browserRuntime.registerManagedBrowserExtensions({
+        registerManagedBrowserExtensions({
           sourceId: serviceSourceId,
           profiles: pluginConfig.browserProfiles,
           extensionPaths: [extensionDir],
@@ -569,18 +518,11 @@ export default definePluginEntry({
         );
       },
       async stop() {
-        const browserRuntime = await browserRuntimePromise;
-        browserRuntime?.unregisterManagedBrowserExtensions(serviceSourceId);
+        unregisterManagedBrowserExtensions(serviceSourceId);
       },
     });
 
     api.on("session_start", async (event, ctx) => {
-      const browserRuntime = await browserRuntimePromise;
-      const availability = describeReplayAvailability({
-        config: pluginConfig,
-        extensionDir,
-        browserRuntimeAvailable: Boolean(browserRuntime),
-      });
       await upsertReplaySession({
         api,
         config: pluginConfig,
@@ -594,9 +536,8 @@ export default definePluginEntry({
     });
 
     api.on("before_reset", async (_event, ctx) => {
-      const browserRuntime = await browserRuntimePromise;
-      if (ctx.sessionKey && browserRuntime) {
-        browserRuntime.clearManagedBrowserReplayContextsForSession(ctx.sessionKey);
+      if (ctx.sessionKey) {
+        clearManagedBrowserReplayContextsForSession(ctx.sessionKey);
       }
       await markReplaySessionEnded({
         api,
@@ -606,9 +547,8 @@ export default definePluginEntry({
     });
 
     api.on("session_end", async (_event, ctx) => {
-      const browserRuntime = await browserRuntimePromise;
-      if (ctx.sessionKey && browserRuntime) {
-        browserRuntime.clearManagedBrowserReplayContextsForSession(ctx.sessionKey);
+      if (ctx.sessionKey) {
+        clearManagedBrowserReplayContextsForSession(ctx.sessionKey);
       }
       await markReplaySessionEnded({
         api,
@@ -618,12 +558,6 @@ export default definePluginEntry({
     });
 
     api.on("before_tool_call", async (event, ctx) => {
-      const browserRuntime = await browserRuntimePromise;
-      const availability = describeReplayAvailability({
-        config: pluginConfig,
-        extensionDir,
-        browserRuntimeAvailable: Boolean(browserRuntime),
-      });
       if (event.toolName !== "browser" || pluginConfig.recordingPolicy !== "browser-only") {
         return;
       }
@@ -637,7 +571,6 @@ export default definePluginEntry({
       await armReplayContext({
         api,
         pluginConfig,
-        browserRuntime,
         sessionKey: ctx.sessionKey,
         sessionId: ctx.sessionId,
         preferredProfile: rawProfile,
@@ -650,7 +583,6 @@ export default definePluginEntry({
           api,
           pluginConfig,
           extensionDir,
-          browserRuntimePromise,
           context: {
             sessionKey: context.sessionKey,
             sessionId: context.sessionId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rrwebcloud/openclaw-session-recording",
-  "version": "2026.3.28-1",
+  "version": "2026.3.28",
   "description": "OpenClaw rrweb replay plugin",
   "license": "MIT",
   "type": "module",
@@ -19,7 +19,7 @@
     "openclaw": "workspace:*"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.3.13"
+    "openclaw": ">=2026.3.24"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -35,7 +35,7 @@
       "npmSpec": "@rrwebcloud/openclaw-session-recording",
       "localPath": "extensions/rrweb-replay",
       "defaultChoice": "npm",
-      "minHostVersion": ">=2026.3.13"
+      "minHostVersion": ">=2026.3.24"
     },
     "release": {
       "publishToNpm": true