@alfe.ai/openclaw-remote 0.0.13 → 0.0.15

package/dist/plugin2.cjs

@@ -3,6 +3,7 @@ let _alfe_ai_agent_api_client = require("@alfe.ai/agent-api-client");
 let _alfe_ai_remote = require("@alfe.ai/remote");
 let _alfe_ai_browser = require("@alfe.ai/browser");
 let _alfe_ai_terminal = require("@alfe.ai/terminal");
+let _alfe_ai_openclaw_plugin_kit = require("@alfe.ai/openclaw-plugin-kit");
 let node_module = require("node:module");
 //#region src/ssrf.ts
 /** Hostnames blocked outright (case-insensitive, exact match). */
@@ -106,7 +107,7 @@ function buildIsNavigationAllowed(policy, log) {
 * created inside registerService.start.
 */
 const pkg = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href)("../package.json");
-const ACTIVATED_KEY = "__alfeRemotePluginActivated";
+const ACTIVATED_KEY = (0, _alfe_ai_openclaw_plugin_kit.getActivationKey)("remote");
 const DEFAULT_HANDOFF_TIMEOUT_MS = 600 * 1e3;
 const DEFAULT_CHROME_PATH = "/usr/bin/google-chrome-stable";
 /**
@@ -162,9 +163,6 @@ let handoffTimeoutMs = DEFAULT_HANDOFF_TIMEOUT_MS;
 let dashboardBaseUrl;
 let selfAgentId;
 const sessionSurfaces = /* @__PURE__ */ new Map();
-function g() {
-	return globalThis;
-}
 /** Coerce an unknown tool param to a string (empty if not a string). */
 function asStr(v) {
 	return typeof v === "string" ? v : "";
@@ -200,11 +198,11 @@ function dispatchFrame(frame, log) {
 	handler.handleFrame(frame);
 }
 function startService(pluginConfig, ssrfPolicy, workspaceDir, log) {
-	if (g()[ACTIVATED_KEY] === true) {
-		log.debug("Alfe Remote plugin already activated — skipping duplicate");
-		return;
-	}
-	g()[ACTIVATED_KEY] = true;
+	(0, _alfe_ai_openclaw_plugin_kit.guardedStart)(ACTIVATED_KEY, log, () => {
+		startServiceInner(pluginConfig, ssrfPolicy, workspaceDir, log);
+	});
+}
+function startServiceInner(pluginConfig, ssrfPolicy, workspaceDir, log) {
 	let alfeConfig = null;
 	try {
 		alfeConfig = (0, _alfe_ai_config.resolveConfig)();
@@ -216,7 +214,7 @@ function startService(pluginConfig, ssrfPolicy, workspaceDir, log) {
 	const wsUrl = pluginConfig.remoteWsUrl ?? (apiUrl ? deriveRemoteWsUrl(apiUrl) : void 0);
 	if (!wsUrl || !apiKey || !apiUrl) {
 		log.info("Remote relay URL or credentials not configured — plugin running without relay");
-		g()[ACTIVATED_KEY] = false;
+		(0, _alfe_ai_openclaw_plugin_kit.resetActivation)(ACTIVATED_KEY);
 		return;
 	}
 	handoffTimeoutMs = pluginConfig.handoffTimeoutMs ?? DEFAULT_HANDOFF_TIMEOUT_MS;
@@ -260,7 +258,6 @@ function startService(pluginConfig, ssrfPolicy, workspaceDir, log) {
 	log.info(`Remote plugin started — relay ${wsUrl}`);
 }
 function stopService(log) {
-	g()[ACTIVATED_KEY] = false;
 	remoteClient?.stop();
 	remoteClient = null;
 	browserSurface?.shutdown();
@@ -271,6 +268,7 @@ function stopService(log) {
 	dashboardBaseUrl = void 0;
 	selfAgentId = void 0;
 	sessionSurfaces.clear();
+	(0, _alfe_ai_openclaw_plugin_kit.resetActivation)(ACTIVATED_KEY);
 	log.info("Remote plugin stopped");
 }
 function registerTools(api) {

package/dist/plugin2.js

@@ -4,6 +4,7 @@ import { AgentApiClient, installToolErrorCapture } from "@alfe.ai/agent-api-clie
 import { RemoteFrameType, RemoteServiceClient, decodeJson } from "@alfe.ai/remote";
 import { BrowserSurface } from "@alfe.ai/browser";
 import { TerminalSurface } from "@alfe.ai/terminal";
+import { getActivationKey, guardedStart, resetActivation } from "@alfe.ai/openclaw-plugin-kit";
 //#region src/ssrf.ts
 /** Hostnames blocked outright (case-insensitive, exact match). */
 const BLOCKED_HOSTNAMES = new Set(["localhost"]);
@@ -106,7 +107,7 @@ function buildIsNavigationAllowed(policy, log) {
 * created inside registerService.start.
 */
 const pkg = createRequire(import.meta.url)("../package.json");
-const ACTIVATED_KEY = "__alfeRemotePluginActivated";
+const ACTIVATED_KEY = getActivationKey("remote");
 const DEFAULT_HANDOFF_TIMEOUT_MS = 600 * 1e3;
 const DEFAULT_CHROME_PATH = "/usr/bin/google-chrome-stable";
 /**
@@ -162,9 +163,6 @@ let handoffTimeoutMs = DEFAULT_HANDOFF_TIMEOUT_MS;
 let dashboardBaseUrl;
 let selfAgentId;
 const sessionSurfaces = /* @__PURE__ */ new Map();
-function g() {
-	return globalThis;
-}
 /** Coerce an unknown tool param to a string (empty if not a string). */
 function asStr(v) {
 	return typeof v === "string" ? v : "";
@@ -200,11 +198,11 @@ function dispatchFrame(frame, log) {
 	handler.handleFrame(frame);
 }
 function startService(pluginConfig, ssrfPolicy, workspaceDir, log) {
-	if (g()[ACTIVATED_KEY] === true) {
-		log.debug("Alfe Remote plugin already activated — skipping duplicate");
-		return;
-	}
-	g()[ACTIVATED_KEY] = true;
+	guardedStart(ACTIVATED_KEY, log, () => {
+		startServiceInner(pluginConfig, ssrfPolicy, workspaceDir, log);
+	});
+}
+function startServiceInner(pluginConfig, ssrfPolicy, workspaceDir, log) {
 	let alfeConfig = null;
 	try {
 		alfeConfig = resolveConfig();
@@ -216,7 +214,7 @@ function startService(pluginConfig, ssrfPolicy, workspaceDir, log) {
 	const wsUrl = pluginConfig.remoteWsUrl ?? (apiUrl ? deriveRemoteWsUrl(apiUrl) : void 0);
 	if (!wsUrl || !apiKey || !apiUrl) {
 		log.info("Remote relay URL or credentials not configured — plugin running without relay");
-		g()[ACTIVATED_KEY] = false;
+		resetActivation(ACTIVATED_KEY);
 		return;
 	}
 	handoffTimeoutMs = pluginConfig.handoffTimeoutMs ?? DEFAULT_HANDOFF_TIMEOUT_MS;
@@ -260,7 +258,6 @@ function startService(pluginConfig, ssrfPolicy, workspaceDir, log) {
 	log.info(`Remote plugin started — relay ${wsUrl}`);
 }
 function stopService(log) {
-	g()[ACTIVATED_KEY] = false;
 	remoteClient?.stop();
 	remoteClient = null;
 	browserSurface?.shutdown();
@@ -271,6 +268,7 @@ function stopService(log) {
 	dashboardBaseUrl = void 0;
 	selfAgentId = void 0;
 	sessionSurfaces.clear();
+	resetActivation(ACTIVATED_KEY);
 	log.info("Remote plugin stopped");
 }
 function registerTools(api) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw-remote",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "OpenClaw plugin for Alfe's interactive remote-control relay — browser co-browse + web terminal surfaces over one outbound WS",
   "type": "module",
   "main": "./dist/plugin.js",
@@ -27,11 +27,12 @@
     "openclaw.plugin.json"
   ],
   "dependencies": {
-    "@alfe.ai/agent-api-client": "^0.12.0",
+    "@alfe.ai/agent-api-client": "^0.14.0",
+    "@alfe.ai/openclaw-plugin-kit": "0.1.0",
     "@alfe.ai/browser": "^0.2.0",
-    "@alfe.ai/config": "0.3.0",
+    "@alfe.ai/config": "0.4.0",
     "@alfe.ai/remote": "^0.1.0",
-    "@alfe.ai/terminal": "^0.1.1"
+    "@alfe.ai/terminal": "^0.1.2"
   },
   "peerDependencies": {
     "openclaw": ">=2026.3.0"