@alfe.ai/openclaw-remote 0.0.4 → 0.0.6

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { n as RemotePluginConfig, t as plugin } from "./plugin.cjs";
+import { i as RemotePluginConfig, r as plugin } from "./plugin.cjs";
 
 //#region src/ssrf.d.ts
 

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { n as RemotePluginConfig, t as plugin } from "./plugin.js";
+import { i as RemotePluginConfig, r as plugin } from "./plugin.js";
 
 //#region src/ssrf.d.ts
 

package/dist/index.js

@@ -1,2 +1,2 @@
-import { n as buildIsNavigationAllowed, t as plugin } from "./plugin2.js";
+import { i as buildIsNavigationAllowed, r as plugin } from "./plugin2.js";
 export { buildIsNavigationAllowed, plugin as default };

package/dist/plugin.cjs

@@ -1,2 +1,8 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
 const require_plugin = require("./plugin2.cjs");
-module.exports = require_plugin.plugin;
+exports.buildControlUrl = require_plugin.buildControlUrl;
+exports.default = require_plugin.plugin;
+exports.deriveDashboardBaseUrl = require_plugin.deriveDashboardBaseUrl;

package/dist/plugin.d.cts

@@ -64,6 +64,22 @@ interface OpenClawPluginApi {
 }
 //#endregion
 //#region src/plugin.d.ts
+/**
+ * Derive the dashboard (control-plane) base URL from the agent's cloud apiUrl,
+ * mirroring `deriveRemoteWsUrl` so it's per-stage automatically:
+ *   https://api.dev.alfe.ai → https://app.dev.alfe.ai
+ *   https://api.alfe.ai     → https://app.alfe.ai   (prod)
+ * The `api.` → `app.` swap matches config.*.ts `dashboardDomain` for every
+ * stage. Returns undefined for a non-`api.` host (e.g. localhost/dev override)
+ * so the caller can fall back to a session-only link.
+ */
+declare function deriveDashboardBaseUrl(apiUrl: string): string | undefined;
+/**
+ * Build the dashboard deep-link ("control URL") the human opens to take over.
+ * Prefers the full agent-scoped path; if the dashboard host or agentId is
+ * unavailable, degrades gracefully (session-only path, then null).
+ */
+declare function buildControlUrl(dashboardBaseUrl: string | undefined, agentId: string | undefined, sessionId: string): string | undefined;
 declare const plugin: {
   id: string;
   name: string;
@@ -73,4 +89,4 @@ declare const plugin: {
   deactivate(api: OpenClawPluginApi): void;
 };
 //#endregion
-export { RemotePluginConfig as n, plugin as t };
+export { RemotePluginConfig as i, deriveDashboardBaseUrl as n, plugin as r, buildControlUrl as t };

package/dist/plugin.d.ts

@@ -64,6 +64,22 @@ interface OpenClawPluginApi {
 }
 //#endregion
 //#region src/plugin.d.ts
+/**
+ * Derive the dashboard (control-plane) base URL from the agent's cloud apiUrl,
+ * mirroring `deriveRemoteWsUrl` so it's per-stage automatically:
+ *   https://api.dev.alfe.ai → https://app.dev.alfe.ai
+ *   https://api.alfe.ai     → https://app.alfe.ai   (prod)
+ * The `api.` → `app.` swap matches config.*.ts `dashboardDomain` for every
+ * stage. Returns undefined for a non-`api.` host (e.g. localhost/dev override)
+ * so the caller can fall back to a session-only link.
+ */
+declare function deriveDashboardBaseUrl(apiUrl: string): string | undefined;
+/**
+ * Build the dashboard deep-link ("control URL") the human opens to take over.
+ * Prefers the full agent-scoped path; if the dashboard host or agentId is
+ * unavailable, degrades gracefully (session-only path, then null).
+ */
+declare function buildControlUrl(dashboardBaseUrl: string | undefined, agentId: string | undefined, sessionId: string): string | undefined;
 declare const plugin: {
   id: string;
   name: string;
@@ -73,4 +89,4 @@ declare const plugin: {
   deactivate(api: OpenClawPluginApi): void;
 };
 //#endregion
-export { RemotePluginConfig as n, plugin as t };
+export { RemotePluginConfig as i, deriveDashboardBaseUrl as n, plugin as r, buildControlUrl as t };

package/dist/plugin.js

@@ -1,2 +1,2 @@
-import { t as plugin } from "./plugin2.js";
-export { plugin as default };
+import { n as deriveDashboardBaseUrl, r as plugin, t as buildControlUrl } from "./plugin2.js";
+export { buildControlUrl, plugin as default, deriveDashboardBaseUrl };

package/dist/plugin2.cjs

@@ -125,11 +125,42 @@ function deriveRemoteWsUrl(apiUrl) {
 		return;
 	}
 }
+/**
+* Derive the dashboard (control-plane) base URL from the agent's cloud apiUrl,
+* mirroring `deriveRemoteWsUrl` so it's per-stage automatically:
+*   https://api.dev.alfe.ai → https://app.dev.alfe.ai
+*   https://api.alfe.ai     → https://app.alfe.ai   (prod)
+* The `api.` → `app.` swap matches config.*.ts `dashboardDomain` for every
+* stage. Returns undefined for a non-`api.` host (e.g. localhost/dev override)
+* so the caller can fall back to a session-only link.
+*/
+function deriveDashboardBaseUrl(apiUrl) {
+	try {
+		const url = new URL(apiUrl);
+		if (!url.hostname.startsWith("api.")) return void 0;
+		return `https://${url.hostname.replace("api.", "app.")}`;
+	} catch {
+		return;
+	}
+}
+/**
+* Build the dashboard deep-link ("control URL") the human opens to take over.
+* Prefers the full agent-scoped path; if the dashboard host or agentId is
+* unavailable, degrades gracefully (session-only path, then null).
+*/
+function buildControlUrl(dashboardBaseUrl, agentId, sessionId) {
+	if (!dashboardBaseUrl) return void 0;
+	const session = encodeURIComponent(sessionId);
+	if (agentId) return `${dashboardBaseUrl}/agents/${encodeURIComponent(agentId)}?tab=browser&session=${session}`;
+	return `${dashboardBaseUrl}/agents?tab=browser&session=${session}`;
+}
 let remoteClient = null;
 let browserSurface = null;
 let terminalSurface = null;
 let apiClient = null;
 let handoffTimeoutMs = DEFAULT_HANDOFF_TIMEOUT_MS;
+let dashboardBaseUrl;
+let selfAgentId;
 const sessionSurfaces = /* @__PURE__ */ new Map();
 function g() {
 	return globalThis;
@@ -193,6 +224,12 @@ function startService(pluginConfig, ssrfPolicy, workspaceDir, log) {
 		apiKey,
 		apiUrl
 	});
+	dashboardBaseUrl = deriveDashboardBaseUrl(apiUrl);
+	apiClient.whoami().then(({ agentId }) => {
+		selfAgentId = agentId;
+	}).catch((err) => {
+		log.debug(`whoami failed — takeover links will omit agentId: ${err.message}`);
+	});
 	const sendFrame = (buf) => {
 		remoteClient?.sendFrame(buf);
 	};
@@ -231,6 +268,8 @@ function stopService(log) {
 	terminalSurface?.shutdown();
 	terminalSurface = null;
 	apiClient = null;
+	dashboardBaseUrl = void 0;
+	selfAgentId = void 0;
 	sessionSurfaces.clear();
 	log.info("Remote plugin stopped");
 }
@@ -341,7 +380,7 @@ function registerTools(api) {
 	api.registerTool({
 		name: "request_browser_takeover",
 		label: "request_browser_takeover",
-		description: "Ask a human to take over the browser you're currently looking at and complete a step you can't do yourself — logging in, solving a captcha, or clicking through a manual flow. The human sees your current live page, completes the instructions, and hands control back; you then resume on the same authenticated page. Blocks until the human is done or the request times out.",
+		description: "Ask a human to take over the browser you're currently looking at and complete a step you can't do yourself — logging in, solving a captcha, or clicking through a manual flow. The human sees your current live page, completes the instructions, and hands control back; you then resume on the same authenticated page. Returns a control URL — SHARE IT WITH THE USER so they can open the takeover. Blocks until the human is done or the request times out.",
 		parameters: {
 			type: "object",
 			properties: {
@@ -368,9 +407,13 @@ function registerTools(api) {
 				url: optStr(params.url),
 				conversationId: optStr(params.conversationId)
 			});
+			const controlUrl = buildControlUrl(dashboardBaseUrl, selfAgentId, sessionId);
+			const message = controlUrl ? `Browser takeover requested (session ${sessionId}). Ask the user to open this link to take control and complete: ${controlUrl} — then wait; I'll resume automatically once they hand back.` : `Browser takeover requested (session ${sessionId}). Ask the user to open the Alfe dashboard, go to this agent's Browser tab, and take control — then wait; I'll resume automatically once they hand back.`;
 			try {
 				return {
 					sessionId,
+					controlUrl,
+					message,
 					...await surface.requestHandoff(handoffTimeoutMs)
 				};
 			} finally {
@@ -409,12 +452,24 @@ const plugin = {
 	}
 };
 //#endregion
+Object.defineProperty(exports, "buildControlUrl", {
+	enumerable: true,
+	get: function() {
+		return buildControlUrl;
+	}
+});
 Object.defineProperty(exports, "buildIsNavigationAllowed", {
 	enumerable: true,
 	get: function() {
 		return buildIsNavigationAllowed;
 	}
 });
+Object.defineProperty(exports, "deriveDashboardBaseUrl", {
+	enumerable: true,
+	get: function() {
+		return deriveDashboardBaseUrl;
+	}
+});
 Object.defineProperty(exports, "plugin", {
 	enumerable: true,
 	get: function() {

package/dist/plugin2.d.cts

@@ -1,2 +1,2 @@
-import { t as plugin } from "./plugin.cjs";
-export { plugin as default };
+import { n as deriveDashboardBaseUrl, r as plugin, t as buildControlUrl } from "./plugin.cjs";
+export { buildControlUrl, plugin as default, deriveDashboardBaseUrl };

package/dist/plugin2.d.ts

@@ -1,2 +1,2 @@
-import { t as plugin } from "./plugin.js";
-export { plugin as default };
+import { n as deriveDashboardBaseUrl, r as plugin, t as buildControlUrl } from "./plugin.js";
+export { buildControlUrl, plugin as default, deriveDashboardBaseUrl };

package/dist/plugin2.js

@@ -125,11 +125,42 @@ function deriveRemoteWsUrl(apiUrl) {
 		return;
 	}
 }
+/**
+* Derive the dashboard (control-plane) base URL from the agent's cloud apiUrl,
+* mirroring `deriveRemoteWsUrl` so it's per-stage automatically:
+*   https://api.dev.alfe.ai → https://app.dev.alfe.ai
+*   https://api.alfe.ai     → https://app.alfe.ai   (prod)
+* The `api.` → `app.` swap matches config.*.ts `dashboardDomain` for every
+* stage. Returns undefined for a non-`api.` host (e.g. localhost/dev override)
+* so the caller can fall back to a session-only link.
+*/
+function deriveDashboardBaseUrl(apiUrl) {
+	try {
+		const url = new URL(apiUrl);
+		if (!url.hostname.startsWith("api.")) return void 0;
+		return `https://${url.hostname.replace("api.", "app.")}`;
+	} catch {
+		return;
+	}
+}
+/**
+* Build the dashboard deep-link ("control URL") the human opens to take over.
+* Prefers the full agent-scoped path; if the dashboard host or agentId is
+* unavailable, degrades gracefully (session-only path, then null).
+*/
+function buildControlUrl(dashboardBaseUrl, agentId, sessionId) {
+	if (!dashboardBaseUrl) return void 0;
+	const session = encodeURIComponent(sessionId);
+	if (agentId) return `${dashboardBaseUrl}/agents/${encodeURIComponent(agentId)}?tab=browser&session=${session}`;
+	return `${dashboardBaseUrl}/agents?tab=browser&session=${session}`;
+}
 let remoteClient = null;
 let browserSurface = null;
 let terminalSurface = null;
 let apiClient = null;
 let handoffTimeoutMs = DEFAULT_HANDOFF_TIMEOUT_MS;
+let dashboardBaseUrl;
+let selfAgentId;
 const sessionSurfaces = /* @__PURE__ */ new Map();
 function g() {
 	return globalThis;
@@ -193,6 +224,12 @@ function startService(pluginConfig, ssrfPolicy, workspaceDir, log) {
 		apiKey,
 		apiUrl
 	});
+	dashboardBaseUrl = deriveDashboardBaseUrl(apiUrl);
+	apiClient.whoami().then(({ agentId }) => {
+		selfAgentId = agentId;
+	}).catch((err) => {
+		log.debug(`whoami failed — takeover links will omit agentId: ${err.message}`);
+	});
 	const sendFrame = (buf) => {
 		remoteClient?.sendFrame(buf);
 	};
@@ -231,6 +268,8 @@ function stopService(log) {
 	terminalSurface?.shutdown();
 	terminalSurface = null;
 	apiClient = null;
+	dashboardBaseUrl = void 0;
+	selfAgentId = void 0;
 	sessionSurfaces.clear();
 	log.info("Remote plugin stopped");
 }
@@ -341,7 +380,7 @@ function registerTools(api) {
 	api.registerTool({
 		name: "request_browser_takeover",
 		label: "request_browser_takeover",
-		description: "Ask a human to take over the browser you're currently looking at and complete a step you can't do yourself — logging in, solving a captcha, or clicking through a manual flow. The human sees your current live page, completes the instructions, and hands control back; you then resume on the same authenticated page. Blocks until the human is done or the request times out.",
+		description: "Ask a human to take over the browser you're currently looking at and complete a step you can't do yourself — logging in, solving a captcha, or clicking through a manual flow. The human sees your current live page, completes the instructions, and hands control back; you then resume on the same authenticated page. Returns a control URL — SHARE IT WITH THE USER so they can open the takeover. Blocks until the human is done or the request times out.",
 		parameters: {
 			type: "object",
 			properties: {
@@ -368,9 +407,13 @@ function registerTools(api) {
 				url: optStr(params.url),
 				conversationId: optStr(params.conversationId)
 			});
+			const controlUrl = buildControlUrl(dashboardBaseUrl, selfAgentId, sessionId);
+			const message = controlUrl ? `Browser takeover requested (session ${sessionId}). Ask the user to open this link to take control and complete: ${controlUrl} — then wait; I'll resume automatically once they hand back.` : `Browser takeover requested (session ${sessionId}). Ask the user to open the Alfe dashboard, go to this agent's Browser tab, and take control — then wait; I'll resume automatically once they hand back.`;
 			try {
 				return {
 					sessionId,
+					controlUrl,
+					message,
 					...await surface.requestHandoff(handoffTimeoutMs)
 				};
 			} finally {
@@ -409,4 +452,4 @@ const plugin = {
 	}
 };
 //#endregion
-export { buildIsNavigationAllowed as n, plugin as t };
+export { buildIsNavigationAllowed as i, deriveDashboardBaseUrl as n, plugin as r, buildControlUrl as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw-remote",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "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,7 +27,7 @@
     "openclaw.plugin.json"
   ],
   "dependencies": {
-    "@alfe.ai/agent-api-client": "^0.5.0",
+    "@alfe.ai/agent-api-client": "^0.6.1",
     "@alfe.ai/browser": "^0.1.0",
     "@alfe.ai/config": "0.3.0",
     "@alfe.ai/remote": "^0.1.0",