@alfe.ai/openclaw-console 0.0.1

package/dist/index.cjs

@@ -0,0 +1,2 @@
+const require_plugin = require("./plugin.cjs");
+module.exports = require_plugin;

package/dist/index.d.cts

@@ -0,0 +1,2 @@
+import plugin from "./plugin.cjs";
+export { plugin as default };

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import plugin from "./plugin.js";
+export { plugin as default };

package/dist/index.js

@@ -0,0 +1,2 @@
+import plugin from "./plugin.js";
+export { plugin as default };

package/dist/plugin.cjs

@@ -0,0 +1,79 @@
+let node_module = require("node:module");
+let _alfe_ai_console_client = require("@alfe.ai/console-client");
+//#region src/plugin.ts
+/**
+* Alfe Console plugin for OpenClaw.
+*
+* On activate, opens an outbound WS to the Alfe console service via
+* `@alfe.ai/console-client`. The console service multiplexes browser
+* sessions over that WS using the binary tunnel protocol; the client
+* proxies each tunneled request to the local OpenClaw gateway on
+* `localhost:18789` and streams responses back.
+*
+* The gateway token never leaves the agent host — the client reads it
+* from `~/.openclaw/openclaw.json` on demand.
+*/
+const pkg = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href)("../package.json");
+let consoleClient = null;
+const plugin = {
+	id: "@alfe.ai/openclaw-console",
+	name: "Alfe Console Plugin",
+	description: "Bridges the Alfe console service to the local OpenClaw control gateway",
+	version: pkg.version,
+	activate(api) {
+		const log = api.logger;
+		const pluginConfig = (((api.config ?? {}).plugins?.entries)?.["@alfe.ai/openclaw-console"] ?? {}).config ?? {};
+		const startConsoleClient = () => {
+			if (globalThis.__alfeConsolePluginActivated === true) {
+				log.debug("Console plugin already activated — skipping duplicate");
+				return;
+			}
+			globalThis.__alfeConsolePluginActivated = true;
+			const { apiKey, consoleWsUrl } = (0, _alfe_ai_console_client.resolveAlfeConsole)({ consoleWsUrl: pluginConfig.consoleWsUrl });
+			if (!consoleWsUrl || !apiKey) {
+				log.info("Console service URL or API key not configured — console plugin idle");
+				return;
+			}
+			log.info(`Connecting to console service: ${consoleWsUrl}`);
+			consoleClient = new _alfe_ai_console_client.ConsoleServiceClient({
+				wsUrl: consoleWsUrl,
+				apiKey,
+				onConnectionChange: (connected) => {
+					log.info(`Console service connection: ${connected ? "connected" : "disconnected"}`);
+				},
+				logger: log
+			});
+			consoleClient.start();
+		};
+		const stopConsoleClient = () => {
+			globalThis.__alfeConsolePluginActivated = false;
+			if (consoleClient) {
+				consoleClient.stop();
+				consoleClient = null;
+			}
+			log.info("Console plugin deactivated");
+		};
+		if (api.registerService) api.registerService({
+			id: "alfe-console-relay",
+			start: () => {
+				startConsoleClient();
+			},
+			stop: () => {
+				stopConsoleClient();
+			}
+		});
+		else startConsoleClient();
+		log.info("Console plugin registered");
+	},
+	deactivate(api) {
+		const log = api.logger;
+		if (consoleClient) {
+			consoleClient.stop();
+			consoleClient = null;
+		}
+		globalThis.__alfeConsolePluginActivated = false;
+		log.info("Console plugin deactivated (fallback path)");
+	}
+};
+//#endregion
+module.exports = plugin;

package/dist/plugin.d.cts

@@ -0,0 +1,45 @@
+//#region src/plugin.d.ts
+/**
+ * Alfe Console plugin for OpenClaw.
+ *
+ * On activate, opens an outbound WS to the Alfe console service via
+ * `@alfe.ai/console-client`. The console service multiplexes browser
+ * sessions over that WS using the binary tunnel protocol; the client
+ * proxies each tunneled request to the local OpenClaw gateway on
+ * `localhost:18789` and streams responses back.
+ *
+ * The gateway token never leaves the agent host — the client reads it
+ * from `~/.openclaw/openclaw.json` on demand.
+ */
+interface PluginLogger {
+  info(msg: string, ...args: unknown[]): void;
+  warn(msg: string, ...args: unknown[]): void;
+  error(msg: string, ...args: unknown[]): void;
+  debug(msg: string, ...args: unknown[]): void;
+}
+interface PluginServiceContext {
+  config: Record<string, unknown>;
+  workspaceDir?: string;
+  stateDir: string;
+  logger: PluginLogger;
+}
+interface PluginApi {
+  logger: PluginLogger;
+  registrationMode?: 'full' | 'setup-only' | 'setup-runtime' | 'cli-metadata';
+  config?: Record<string, unknown>;
+  registerService?(service: {
+    id: string;
+    start: (ctx: PluginServiceContext) => void | Promise<void>;
+    stop?: (ctx: PluginServiceContext) => void | Promise<void>;
+  }): void;
+}
+declare const plugin: {
+  id: string;
+  name: string;
+  description: string;
+  version: string;
+  activate(api: PluginApi): void;
+  deactivate(api: PluginApi): void;
+};
+//#endregion
+export { plugin as default };

package/dist/plugin.d.ts

@@ -0,0 +1,45 @@
+//#region src/plugin.d.ts
+/**
+ * Alfe Console plugin for OpenClaw.
+ *
+ * On activate, opens an outbound WS to the Alfe console service via
+ * `@alfe.ai/console-client`. The console service multiplexes browser
+ * sessions over that WS using the binary tunnel protocol; the client
+ * proxies each tunneled request to the local OpenClaw gateway on
+ * `localhost:18789` and streams responses back.
+ *
+ * The gateway token never leaves the agent host — the client reads it
+ * from `~/.openclaw/openclaw.json` on demand.
+ */
+interface PluginLogger {
+  info(msg: string, ...args: unknown[]): void;
+  warn(msg: string, ...args: unknown[]): void;
+  error(msg: string, ...args: unknown[]): void;
+  debug(msg: string, ...args: unknown[]): void;
+}
+interface PluginServiceContext {
+  config: Record<string, unknown>;
+  workspaceDir?: string;
+  stateDir: string;
+  logger: PluginLogger;
+}
+interface PluginApi {
+  logger: PluginLogger;
+  registrationMode?: 'full' | 'setup-only' | 'setup-runtime' | 'cli-metadata';
+  config?: Record<string, unknown>;
+  registerService?(service: {
+    id: string;
+    start: (ctx: PluginServiceContext) => void | Promise<void>;
+    stop?: (ctx: PluginServiceContext) => void | Promise<void>;
+  }): void;
+}
+declare const plugin: {
+  id: string;
+  name: string;
+  description: string;
+  version: string;
+  activate(api: PluginApi): void;
+  deactivate(api: PluginApi): void;
+};
+//#endregion
+export { plugin as default };

package/dist/plugin.js

@@ -0,0 +1,79 @@
+import { createRequire } from "node:module";
+import { ConsoleServiceClient, resolveAlfeConsole } from "@alfe.ai/console-client";
+//#region src/plugin.ts
+/**
+* Alfe Console plugin for OpenClaw.
+*
+* On activate, opens an outbound WS to the Alfe console service via
+* `@alfe.ai/console-client`. The console service multiplexes browser
+* sessions over that WS using the binary tunnel protocol; the client
+* proxies each tunneled request to the local OpenClaw gateway on
+* `localhost:18789` and streams responses back.
+*
+* The gateway token never leaves the agent host — the client reads it
+* from `~/.openclaw/openclaw.json` on demand.
+*/
+const pkg = createRequire(import.meta.url)("../package.json");
+let consoleClient = null;
+const plugin = {
+	id: "@alfe.ai/openclaw-console",
+	name: "Alfe Console Plugin",
+	description: "Bridges the Alfe console service to the local OpenClaw control gateway",
+	version: pkg.version,
+	activate(api) {
+		const log = api.logger;
+		const pluginConfig = (((api.config ?? {}).plugins?.entries)?.["@alfe.ai/openclaw-console"] ?? {}).config ?? {};
+		const startConsoleClient = () => {
+			if (globalThis.__alfeConsolePluginActivated === true) {
+				log.debug("Console plugin already activated — skipping duplicate");
+				return;
+			}
+			globalThis.__alfeConsolePluginActivated = true;
+			const { apiKey, consoleWsUrl } = resolveAlfeConsole({ consoleWsUrl: pluginConfig.consoleWsUrl });
+			if (!consoleWsUrl || !apiKey) {
+				log.info("Console service URL or API key not configured — console plugin idle");
+				return;
+			}
+			log.info(`Connecting to console service: ${consoleWsUrl}`);
+			consoleClient = new ConsoleServiceClient({
+				wsUrl: consoleWsUrl,
+				apiKey,
+				onConnectionChange: (connected) => {
+					log.info(`Console service connection: ${connected ? "connected" : "disconnected"}`);
+				},
+				logger: log
+			});
+			consoleClient.start();
+		};
+		const stopConsoleClient = () => {
+			globalThis.__alfeConsolePluginActivated = false;
+			if (consoleClient) {
+				consoleClient.stop();
+				consoleClient = null;
+			}
+			log.info("Console plugin deactivated");
+		};
+		if (api.registerService) api.registerService({
+			id: "alfe-console-relay",
+			start: () => {
+				startConsoleClient();
+			},
+			stop: () => {
+				stopConsoleClient();
+			}
+		});
+		else startConsoleClient();
+		log.info("Console plugin registered");
+	},
+	deactivate(api) {
+		const log = api.logger;
+		if (consoleClient) {
+			consoleClient.stop();
+			consoleClient = null;
+		}
+		globalThis.__alfeConsolePluginActivated = false;
+		log.info("Console plugin deactivated (fallback path)");
+	}
+};
+//#endregion
+export { plugin as default };

package/openclaw.plugin.json

@@ -0,0 +1,16 @@
+{
+  "id": "@alfe.ai/openclaw-console",
+  "name": "Alfe Console Plugin",
+  "description": "Bridges the Alfe console service to the local OpenClaw control gateway over an outbound WS",
+  "entry": "./dist/plugin.js",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "consoleWsUrl": {
+        "type": "string",
+        "description": "Override console service WebSocket URL (otherwise derived from API key)"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@alfe.ai/openclaw-console",
+  "version": "0.0.1",
+  "description": "OpenClaw plugin: bridges browser console traffic from the Alfe console service to the local OpenClaw control gateway",
+  "type": "module",
+  "main": "./dist/plugin.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "require": "./dist/plugin.cjs",
+      "import": "./dist/plugin.js"
+    }
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/plugin.js"
+    ]
+  },
+  "files": [
+    "dist",
+    "openclaw.plugin.json"
+  ],
+  "dependencies": {
+    "@alfe.ai/config": "^0.0.8",
+    "@alfe.ai/console-client": "^0.0.1"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.0"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint ."
+  }
+}