@alfe.ai/openclaw-chat 0.9.5 → 0.9.6

package/dist/plugin.d.cts

@@ -599,6 +599,15 @@ interface AnchorEnv {
   requireMainFilename: string | undefined;
   argv1: string | undefined;
   execPath: string;
+  /**
+   * Well-known global `node_modules` directories to try as `<dir>/openclaw`
+   * anchors, independent of PATH / `which` / execPath. Load-bearing when the
+   * plugin runs in-process inside a runtime whose PATH is stripped or whose
+   * `child_process` is sandboxed (homebrew-keg self-hosted macOS), so every
+   * environment-derived anchor above returns nothing. Optional — defaults to
+   * none (tests that don't exercise this pass `undefined`).
+   */
+  globalModulesDirs?: string[];
 }
 /**
  * Compute the ordered, de-duplicated list of resolver anchors to try, each

package/dist/plugin.d.ts

@@ -599,6 +599,15 @@ interface AnchorEnv {
   requireMainFilename: string | undefined;
   argv1: string | undefined;
   execPath: string;
+  /**
+   * Well-known global `node_modules` directories to try as `<dir>/openclaw`
+   * anchors, independent of PATH / `which` / execPath. Load-bearing when the
+   * plugin runs in-process inside a runtime whose PATH is stripped or whose
+   * `child_process` is sandboxed (homebrew-keg self-hosted macOS), so every
+   * environment-derived anchor above returns nothing. Optional — defaults to
+   * none (tests that don't exercise this pass `undefined`).
+   */
+  globalModulesDirs?: string[];
 }
 /**
  * Compute the ordered, de-duplicated list of resolver anchors to try, each

package/dist/plugin2.cjs

@@ -3,6 +3,7 @@ let node_fs_promises = require("node:fs/promises");
 let node_fs = require("node:fs");
 let node_child_process = require("node:child_process");
 let node_path = require("node:path");
+let node_url = require("node:url");
 let node_os = require("node:os");
 let _alfe_ai_chat = require("@alfe.ai/chat");
 let _alfe_ai_agent_api_client = require("@alfe.ai/agent-api-client");
@@ -2072,24 +2073,33 @@ let resolveRouteEnvelope = null;
 * degrades `chat.abort` to a logged no-op (Stop still seals the UI) rather than
 * a hard failure.
 */
-function loadOpenClawSdk(req, log, anchor) {
-	let resolvedDispatch = false;
-	try {
-		const channelInbound = req("openclaw/plugin-sdk/channel-inbound");
-		if (channelInbound.dispatchInboundDirectDmWithRuntime) {
-			dispatchInbound = channelInbound.dispatchInboundDirectDmWithRuntime;
-			resolvedDispatch = true;
+async function loadOpenClawSdk(req, log, anchor) {
+	const loadSubpath = async (subpath) => {
+		try {
+			const mod = await import((0, node_url.pathToFileURL)(req.resolve(subpath)).href);
+			return {
+				...typeof mod.default === "object" ? mod.default : void 0,
+				...mod
+			};
+		} catch {}
+		try {
+			return req(subpath);
+		} catch {
+			return;
 		}
-	} catch {}
-	try {
-		const harness = req("openclaw/plugin-sdk/agent-harness");
-		if (harness.abortEmbeddedAgentRun) abortEmbeddedAgentRun = harness.abortEmbeddedAgentRun;
-		if (harness.resolveActiveEmbeddedRunSessionId) resolveActiveRunSessionId = harness.resolveActiveEmbeddedRunSessionId;
-	} catch {}
-	try {
-		const envelope = req("openclaw/plugin-sdk/inbound-envelope");
-		if (envelope.resolveInboundRouteEnvelopeBuilderWithRuntime) resolveRouteEnvelope = envelope.resolveInboundRouteEnvelopeBuilderWithRuntime;
-	} catch {}
+	};
+	let resolvedDispatch = false;
+	const channelInbound = await loadSubpath("openclaw/plugin-sdk/channel-inbound");
+	if (channelInbound?.dispatchInboundDirectDmWithRuntime) {
+		dispatchInbound = channelInbound.dispatchInboundDirectDmWithRuntime;
+		resolvedDispatch = true;
+	}
+	const harness = await loadSubpath("openclaw/plugin-sdk/agent-harness");
+	const abortRun = harness?.abortAgentHarnessRun ?? harness?.abortEmbeddedAgentRun;
+	if (abortRun) abortEmbeddedAgentRun = abortRun;
+	if (harness?.resolveActiveEmbeddedRunSessionId) resolveActiveRunSessionId = harness.resolveActiveEmbeddedRunSessionId;
+	const envelope = await loadSubpath("openclaw/plugin-sdk/inbound-envelope");
+	if (envelope?.resolveInboundRouteEnvelopeBuilderWithRuntime) resolveRouteEnvelope = envelope.resolveInboundRouteEnvelopeBuilderWithRuntime;
 	if (resolvedDispatch) log.info(`Resolved OpenClaw SDK from ${anchor} (hard-abort=${abortEmbeddedAgentRun && resolveActiveRunSessionId ? "available" : "unavailable"})`);
 	return resolvedDispatch;
 }
@@ -2160,6 +2170,7 @@ function computeOpenClawSdkAnchors(deps) {
 	try {
 		push(deps.which("openclaw"));
 	} catch {}
+	for (const dir of deps.globalModulesDirs ?? []) push((0, node_path.join)(dir, "openclaw", "package.json"));
 	for (const base of [deps.execPath, safeRealpath(deps.realpath, deps.execPath)]) {
 		if (!base) continue;
 		try {
@@ -2178,6 +2189,27 @@ function safeRealpath(realpath, p) {
 	}
 }
 /**
+* Well-known global `node_modules` locations to try as SDK anchors, in priority
+* order. Environment-INDEPENDENT (no PATH / `which` / execPath), so they resolve
+* the SDK even when the in-process plugin context has a stripped PATH or a
+* sandboxed `child_process` (the homebrew-keg self-hosted macOS case where every
+* environment-derived anchor returns nothing). Non-existent candidates are
+* harmless — `createRequire` just fails and the next anchor runs. `NODE_PATH`,
+* when set, is an explicit module-dir list, so honour it too.
+*/
+function candidateGlobalModulesDirs() {
+	const dirs = [
+		"/opt/homebrew/lib/node_modules",
+		"/usr/local/lib/node_modules",
+		"/usr/lib/node_modules",
+		"/usr/local/share/npm/lib/node_modules"
+	];
+	const home = process.env.HOME;
+	if (home) dirs.push((0, node_path.join)(home, ".npm-global", "lib", "node_modules"));
+	for (const d of (process.env.NODE_PATH ?? "").split(node_path.delimiter)) if (d) dirs.push(d);
+	return dirs;
+}
+/**
 * Resolve OpenClaw SDK functions from the running process.
 *
 * The openclaw package is NOT in the plugin's node_modules (it's a peer dep).
@@ -2186,19 +2218,20 @@ function safeRealpath(realpath, p) {
 * relocated-node layouts), then to a `which openclaw` lookup, then fall back to
 * deriving the global modules path from process.execPath.
 */
-function resolveOpenClawSdk(log) {
+async function resolveOpenClawSdk(log) {
 	const pathEnv = process.env.PATH;
 	const anchors = computeOpenClawSdkAnchors({
 		realpath: node_fs.realpathSync,
 		which: () => whichOpenClaw(pathEnv),
 		requireMainFilename: require$1.main?.filename,
 		argv1: process.argv[1],
-		execPath: process.execPath
+		execPath: process.execPath,
+		globalModulesDirs: candidateGlobalModulesDirs()
 	});
 	for (const anchor of anchors) try {
-		if (loadOpenClawSdk((0, node_module.createRequire)(anchor), log, anchor)) return;
+		if (await loadOpenClawSdk((0, node_module.createRequire)(anchor), log, anchor)) return;
 	} catch {}
-	log.warn("OpenClaw SDK not resolvable — chat dispatch will not work");
+	log.warn(`OpenClaw SDK not resolvable — chat dispatch will not work. argv1=${process.argv[1] ?? "<none>"} execPath=${process.execPath} PATH=${pathEnv ? "set" : "EMPTY"} anchorsTried=[${anchors.join(", ")}]`);
 }
 let pluginRuntime = null;
 let chatClient = null;
@@ -2945,7 +2978,7 @@ const plugin = {
 			log.info(`Registered ${String(a2aTools.length)} agent tools`);
 		}
 		const pluginConfig = (((api.config ?? {}).plugins?.entries)?.["@alfe.ai/openclaw-chat"] ?? {}).config ?? {};
-		const startChatService = () => {
+		const startChatService = async () => {
 			const action = decideChatServiceStart({
 				connectInFlight: connectingPromise !== null,
 				clientPresent: chatClient !== null,
@@ -2966,7 +2999,7 @@ const plugin = {
 			}
 			globalThis.__alfeChatPluginActivated = true;
 			log.info("Chat plugin registering...");
-			resolveOpenClawSdk(log);
+			await resolveOpenClawSdk(log);
 			pluginRuntime = api.runtime ?? null;
 			let thisConnect = null;
 			thisConnect = Promise.resolve().then(() => {

package/dist/plugin2.js

@@ -3,6 +3,7 @@ import { mkdir, open, readFile, readdir, stat, unlink, writeFile } from "node:fs
 import { existsSync, realpathSync } from "node:fs";
 import { execFileSync } from "node:child_process";
 import { basename, delimiter, dirname, isAbsolute, join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
 import { homedir } from "node:os";
 import { ChatServiceClient, resolveAlfeChat } from "@alfe.ai/chat";
 import { AgentApiClient, installToolErrorCapture } from "@alfe.ai/agent-api-client";
@@ -2072,24 +2073,33 @@ let resolveRouteEnvelope = null;
 * degrades `chat.abort` to a logged no-op (Stop still seals the UI) rather than
 * a hard failure.
 */
-function loadOpenClawSdk(req, log, anchor) {
-	let resolvedDispatch = false;
-	try {
-		const channelInbound = req("openclaw/plugin-sdk/channel-inbound");
-		if (channelInbound.dispatchInboundDirectDmWithRuntime) {
-			dispatchInbound = channelInbound.dispatchInboundDirectDmWithRuntime;
-			resolvedDispatch = true;
+async function loadOpenClawSdk(req, log, anchor) {
+	const loadSubpath = async (subpath) => {
+		try {
+			const mod = await import(pathToFileURL(req.resolve(subpath)).href);
+			return {
+				...typeof mod.default === "object" ? mod.default : void 0,
+				...mod
+			};
+		} catch {}
+		try {
+			return req(subpath);
+		} catch {
+			return;
 		}
-	} catch {}
-	try {
-		const harness = req("openclaw/plugin-sdk/agent-harness");
-		if (harness.abortEmbeddedAgentRun) abortEmbeddedAgentRun = harness.abortEmbeddedAgentRun;
-		if (harness.resolveActiveEmbeddedRunSessionId) resolveActiveRunSessionId = harness.resolveActiveEmbeddedRunSessionId;
-	} catch {}
-	try {
-		const envelope = req("openclaw/plugin-sdk/inbound-envelope");
-		if (envelope.resolveInboundRouteEnvelopeBuilderWithRuntime) resolveRouteEnvelope = envelope.resolveInboundRouteEnvelopeBuilderWithRuntime;
-	} catch {}
+	};
+	let resolvedDispatch = false;
+	const channelInbound = await loadSubpath("openclaw/plugin-sdk/channel-inbound");
+	if (channelInbound?.dispatchInboundDirectDmWithRuntime) {
+		dispatchInbound = channelInbound.dispatchInboundDirectDmWithRuntime;
+		resolvedDispatch = true;
+	}
+	const harness = await loadSubpath("openclaw/plugin-sdk/agent-harness");
+	const abortRun = harness?.abortAgentHarnessRun ?? harness?.abortEmbeddedAgentRun;
+	if (abortRun) abortEmbeddedAgentRun = abortRun;
+	if (harness?.resolveActiveEmbeddedRunSessionId) resolveActiveRunSessionId = harness.resolveActiveEmbeddedRunSessionId;
+	const envelope = await loadSubpath("openclaw/plugin-sdk/inbound-envelope");
+	if (envelope?.resolveInboundRouteEnvelopeBuilderWithRuntime) resolveRouteEnvelope = envelope.resolveInboundRouteEnvelopeBuilderWithRuntime;
 	if (resolvedDispatch) log.info(`Resolved OpenClaw SDK from ${anchor} (hard-abort=${abortEmbeddedAgentRun && resolveActiveRunSessionId ? "available" : "unavailable"})`);
 	return resolvedDispatch;
 }
@@ -2160,6 +2170,7 @@ function computeOpenClawSdkAnchors(deps) {
 	try {
 		push(deps.which("openclaw"));
 	} catch {}
+	for (const dir of deps.globalModulesDirs ?? []) push(join(dir, "openclaw", "package.json"));
 	for (const base of [deps.execPath, safeRealpath(deps.realpath, deps.execPath)]) {
 		if (!base) continue;
 		try {
@@ -2178,6 +2189,27 @@ function safeRealpath(realpath, p) {
 	}
 }
 /**
+* Well-known global `node_modules` locations to try as SDK anchors, in priority
+* order. Environment-INDEPENDENT (no PATH / `which` / execPath), so they resolve
+* the SDK even when the in-process plugin context has a stripped PATH or a
+* sandboxed `child_process` (the homebrew-keg self-hosted macOS case where every
+* environment-derived anchor returns nothing). Non-existent candidates are
+* harmless — `createRequire` just fails and the next anchor runs. `NODE_PATH`,
+* when set, is an explicit module-dir list, so honour it too.
+*/
+function candidateGlobalModulesDirs() {
+	const dirs = [
+		"/opt/homebrew/lib/node_modules",
+		"/usr/local/lib/node_modules",
+		"/usr/lib/node_modules",
+		"/usr/local/share/npm/lib/node_modules"
+	];
+	const home = process.env.HOME;
+	if (home) dirs.push(join(home, ".npm-global", "lib", "node_modules"));
+	for (const d of (process.env.NODE_PATH ?? "").split(delimiter)) if (d) dirs.push(d);
+	return dirs;
+}
+/**
 * Resolve OpenClaw SDK functions from the running process.
 *
 * The openclaw package is NOT in the plugin's node_modules (it's a peer dep).
@@ -2186,19 +2218,20 @@ function safeRealpath(realpath, p) {
 * relocated-node layouts), then to a `which openclaw` lookup, then fall back to
 * deriving the global modules path from process.execPath.
 */
-function resolveOpenClawSdk(log) {
+async function resolveOpenClawSdk(log) {
 	const pathEnv = process.env.PATH;
 	const anchors = computeOpenClawSdkAnchors({
 		realpath: realpathSync,
 		which: () => whichOpenClaw(pathEnv),
 		requireMainFilename: require.main?.filename,
 		argv1: process.argv[1],
-		execPath: process.execPath
+		execPath: process.execPath,
+		globalModulesDirs: candidateGlobalModulesDirs()
 	});
 	for (const anchor of anchors) try {
-		if (loadOpenClawSdk(createRequire(anchor), log, anchor)) return;
+		if (await loadOpenClawSdk(createRequire(anchor), log, anchor)) return;
 	} catch {}
-	log.warn("OpenClaw SDK not resolvable — chat dispatch will not work");
+	log.warn(`OpenClaw SDK not resolvable — chat dispatch will not work. argv1=${process.argv[1] ?? "<none>"} execPath=${process.execPath} PATH=${pathEnv ? "set" : "EMPTY"} anchorsTried=[${anchors.join(", ")}]`);
 }
 let pluginRuntime = null;
 let chatClient = null;
@@ -2945,7 +2978,7 @@ const plugin = {
 			log.info(`Registered ${String(a2aTools.length)} agent tools`);
 		}
 		const pluginConfig = (((api.config ?? {}).plugins?.entries)?.["@alfe.ai/openclaw-chat"] ?? {}).config ?? {};
-		const startChatService = () => {
+		const startChatService = async () => {
 			const action = decideChatServiceStart({
 				connectInFlight: connectingPromise !== null,
 				clientPresent: chatClient !== null,
@@ -2966,7 +2999,7 @@ const plugin = {
 			}
 			globalThis.__alfeChatPluginActivated = true;
 			log.info("Chat plugin registering...");
-			resolveOpenClawSdk(log);
+			await resolveOpenClawSdk(log);
 			pluginRuntime = api.runtime ?? null;
 			let thisConnect = null;
 			thisConnect = Promise.resolve().then(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw-chat",
-  "version": "0.9.5",
+  "version": "0.9.6",
   "description": "OpenClaw chat plugin for Alfe — web widget and mobile app channels",
   "type": "module",
   "main": "./dist/plugin.js",
@@ -27,7 +27,7 @@
     "openclaw.plugin.json"
   ],
   "dependencies": {
-    "@alfe.ai/agent-api-client": "^0.10.0",
+    "@alfe.ai/agent-api-client": "^0.11.0",
     "@alfe.ai/chat": "^0.0.16",
     "@alfe.ai/config": "^0.3.0"
   },