@matelink/cli 2026.4.16 → 2026.4.18

package/bin/matecli.mjs

@@ -14,7 +14,7 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import process from "node:process";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 const NUMERIC_CODE_LENGTH = 4;
 const GROUP_SIZE = 4;
@@ -51,7 +51,104 @@ const DEFAULT_GATEWAY_SCOPES = [
   "operator.approvals",
   "operator.pairing",
 ].join(",");
+const SESSION_CONTEXT_MIN_TOKENS = 1024;
 const CLI_ENTRY = fileURLToPath(import.meta.url);
+
+
+function buildPathString(values) {
+  const entries = [];
+  const seen = new Set();
+  for (const value of values) {
+    const raw = String(value ?? "").trim();
+    if (!raw) continue;
+    for (const part of raw.split(":")) {
+      const normalized = part.trim();
+      if (!normalized || seen.has(normalized)) continue;
+      seen.add(normalized);
+      entries.push(normalized);
+    }
+  }
+  return entries.join(":");
+}
+
+function resolveSiblingBinDirs(executablePath) {
+  const normalized = String(executablePath ?? "").trim();
+  if (!normalized) return [];
+  const binDir = path.dirname(normalized);
+  return [binDir];
+}
+
+function resolveOpenClawBinaryCandidates() {
+  const homeDir = os.homedir();
+  const candidates = new Set();
+  const addCandidate = (candidate) => {
+    const normalized = String(candidate ?? "").trim();
+    if (!normalized) {
+      return;
+    }
+    try {
+      if (fs.existsSync(normalized)) {
+        candidates.add(fs.realpathSync(normalized));
+      }
+    } catch {
+      if (fs.existsSync(normalized)) {
+        candidates.add(normalized);
+      }
+    }
+  };
+
+  for (const nodeCandidate of resolveNodeCandidates()) {
+    addCandidate(path.join(path.dirname(nodeCandidate), "openclaw"));
+  }
+  addCandidate(path.join(homeDir, ".nvm", "current", "bin", "openclaw"));
+  addCandidate(path.join(homeDir, ".volta", "bin", "openclaw"));
+  addCandidate("/opt/homebrew/bin/openclaw");
+  addCandidate("/usr/local/bin/openclaw");
+  addCandidate("/usr/bin/openclaw");
+
+  const whichOpenClaw = runCommand("which", ["openclaw"]);
+  if (whichOpenClaw.status === 0) {
+    const resolved = String(whichOpenClaw.stdout ?? "").trim();
+    if (resolved && fs.existsSync(resolved)) {
+      addCandidate(resolved);
+    }
+  }
+
+  return [...candidates];
+}
+
+function resolveOpenClawBinaryPath() {
+  for (const candidate of resolveOpenClawBinaryCandidates()) {
+    if (candidate && fs.existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  return "openclaw";
+}
+
+function buildBridgeRuntimeEnv(extraEnv = {}) {
+  const homeDir = os.homedir();
+  const nodePath = resolveBridgeServiceNodePath();
+  const openclawPath = resolveOpenClawBinaryPath();
+  const pathValue = buildPathString([
+    ...resolveSiblingBinDirs(nodePath),
+    ...resolveSiblingBinDirs(openclawPath),
+    "/opt/homebrew/bin",
+    "/usr/local/bin",
+    "/usr/bin",
+    "/bin",
+    "/usr/sbin",
+    "/sbin",
+    path.join(homeDir, ".volta", "bin"),
+    path.join(homeDir, ".nvm", "current", "bin"),
+    process.env.PATH ?? "",
+  ]);
+  return {
+    ...process.env,
+    ...extraEnv,
+    PATH: pathValue,
+  };
+}
 const CLI_LANGUAGE = detectCliLanguage();
 const CLI_I18N = {
   zh: {
@@ -446,6 +543,18 @@ function resolveOpenClawConfigPath() {
   return path.join(resolveOpenClawHome(), "openclaw.json");
 }
 
+function resolveOpenClawDistPath(fileName) {
+  return path.join(
+    resolveOpenClawHome(),
+    "extensions",
+    "memory-tdai",
+    "node_modules",
+    "openclaw",
+    "dist",
+    fileName,
+  );
+}
+
 function resolveTestNextIMStatePath() {
   return path.join(resolveOpenClawHome(), "testnextim.state.json");
 }
@@ -546,6 +655,21 @@ function resolveConfiguredWorkspaceRoot() {
   return path.resolve(resolved);
 }
 
+let sessionStoreHelpersPromise = null;
+
+async function loadSessionStoreHelpers() {
+  if (!sessionStoreHelpersPromise) {
+    sessionStoreHelpersPromise = Promise.all([
+      import(pathToFileURL(resolveOpenClawDistPath("session-utils-PHKOUUva.js")).href),
+      import(pathToFileURL(resolveOpenClawDistPath("store-DACjypj4.js")).href),
+    ]).then(([sessionUtilsMod, storeMod]) => ({
+      loadSessionEntry: sessionUtilsMod.s,
+      updateSessionStoreEntry: storeMod.f,
+    }));
+  }
+  return sessionStoreHelpersPromise;
+}
+
 function normalizeWorkspaceRelativePath(rawName) {
   const value = String(rawName ?? "").trim();
   if (!value) {
@@ -700,6 +824,7 @@ function listFixedMemoryFiles(workspaceRoot) {
         workspaceRoot,
         relativePath,
         absolutePath,
+        includeContent: true,
       });
     });
 }
@@ -814,6 +939,62 @@ async function callWorkspaceRpcLocal({
   return null;
 }
 
+async function callSessionContextRpcLocal({
+  method,
+  params,
+}) {
+  const sessionKey = String(params?.sessionKey ?? params?.key ?? "").trim();
+  if (!sessionKey) {
+    throw new Error("session key is required");
+  }
+
+  const { loadSessionEntry, updateSessionStoreEntry } = await loadSessionStoreHelpers();
+  const loaded = loadSessionEntry(sessionKey);
+  const resolvedSessionKey = String(loaded?.canonicalKey ?? sessionKey).trim() || sessionKey;
+
+  if (method === "session.context.get") {
+    return {
+      ok: true,
+      sessionKey: resolvedSessionKey,
+      contextTokens: Number.isFinite(loaded?.entry?.contextTokens)
+        ? Math.max(0, Math.floor(loaded.entry.contextTokens))
+        : null,
+      storePath: loaded?.storePath ?? "",
+    };
+  }
+
+  if (method === "session.context.set") {
+    if (!loaded?.entry || !String(loaded?.storePath ?? "").trim()) {
+      throw new Error(`session not found: ${sessionKey}`);
+    }
+    const contextTokens = Math.max(
+      SESSION_CONTEXT_MIN_TOKENS,
+      Math.floor(Number(params?.contextTokens ?? 0) || 0),
+    );
+    const updated = await updateSessionStoreEntry({
+      storePath: loaded.storePath,
+      sessionKey: resolvedSessionKey,
+      update: async (existing) => ({
+        contextTokens,
+        updatedAt: Math.max(existing?.updatedAt ?? 0, Date.now()),
+      }),
+    });
+    if (!updated) {
+      throw new Error(`session not found: ${sessionKey}`);
+    }
+    return {
+      ok: true,
+      sessionKey: resolvedSessionKey,
+      contextTokens: Number.isFinite(updated?.contextTokens)
+        ? Math.max(0, Math.floor(updated.contextTokens))
+        : contextTokens,
+      storePath: loaded.storePath,
+    };
+  }
+
+  return null;
+}
+
 function commandToString(command, args) {
   return [command, ...args]
     .map((part) => {
@@ -1291,6 +1472,40 @@ function extractErrorMessage(decoded, fallback) {
   return fallback;
 }
 
+function formatErrorDetails(error) {
+  if (!(error instanceof Error)) {
+    return String(error ?? "");
+  }
+  const details = [];
+  if (error.name && error.name !== "Error") {
+    details.push(`name=${error.name}`);
+  }
+  if (error.code) {
+    details.push(`code=${String(error.code)}`);
+  }
+  if (error.errno) {
+    details.push(`errno=${String(error.errno)}`);
+  }
+  if (error.type) {
+    details.push(`type=${String(error.type)}`);
+  }
+  if (error.cause && typeof error.cause === "object") {
+    const cause = error.cause;
+    if (cause?.code) {
+      details.push(`cause.code=${String(cause.code)}`);
+    }
+    if (cause?.errno) {
+      details.push(`cause.errno=${String(cause.errno)}`);
+    }
+    if (cause?.message) {
+      details.push(`cause=${String(cause.message)}`);
+    }
+  }
+  return details.length > 0
+    ? `${error.message} [${details.join(", ")}]`
+    : error.message;
+}
+
 async function fetchWithTimeout(url, options = {}, timeoutMs = DEFAULT_NETWORK_TIMEOUT_MS) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(new Error(`fetch timeout after ${timeoutMs}ms`)), timeoutMs);
@@ -1299,6 +1514,8 @@ async function fetchWithTimeout(url, options = {}, timeoutMs = DEFAULT_NETWORK_T
       ...options,
       signal: controller.signal,
     });
+  } catch (error) {
+    throw new Error(formatErrorDetails(error));
   } finally {
     clearTimeout(timer);
   }
@@ -1672,7 +1889,9 @@ function resolveBridgeServiceNodePath() {
 function writeBridgeLaunchScript(installConfig) {
   const scriptPath = resolveBridgeLaunchScriptPath();
   fs.mkdirSync(path.dirname(scriptPath), { recursive: true });
-  const defaultPath = [
+  const defaultPath = buildPathString([
+    ...resolveSiblingBinDirs(installConfig.nodePath),
+    ...resolveSiblingBinDirs(installConfig.openclawPath),
     "/opt/homebrew/bin",
     "/usr/local/bin",
     "/usr/bin",
@@ -1681,11 +1900,16 @@ function writeBridgeLaunchScript(installConfig) {
     "/sbin",
     path.join(os.homedir(), ".volta", "bin"),
     path.join(os.homedir(), ".nvm", "current", "bin"),
-  ].join(":");
-  const knownNodeCandidates = resolveNodeCandidates();
-  const candidateChecks = knownNodeCandidates
-    .map((candidate) => `if [ -x '${escapePosixShellSingleQuoted(candidate)}' ]; then NODE_BIN='${escapePosixShellSingleQuoted(candidate)}'; fi`)
-    .join("\n");
+  ]);
+  const knownNodeCandidates = [installConfig.nodePath, ...resolveNodeCandidates()]
+    .filter(Boolean)
+    .filter((candidate, index, values) => values.indexOf(candidate) === index);
+  const candidateChecks = knownNodeCandidates.length > 0
+    ? `${knownNodeCandidates
+        .map((candidate, index) => `${index === 0 ? 'if' : 'elif'} [ -x '${escapePosixShellSingleQuoted(candidate)}' ]; then NODE_BIN='${escapePosixShellSingleQuoted(candidate)}';`)
+        .join("\n")}
+fi`
+    : "";
   const fallbackLine = buildPosixShellExec("node", installConfig.args);
   const script = [
     "#!/bin/sh",
@@ -1722,6 +1946,7 @@ function ensureBridgeServiceInstallConfig({ relayUrl, gatewayBaseUrl }) {
     stdoutLog: path.join(logDir, "bridge.stdout.log"),
     stderrLog: path.join(logDir, "bridge.stderr.log"),
     nodePath: resolveBridgeServiceNodePath(),
+    openclawPath: resolveOpenClawBinaryPath(),
     scriptPath: CLI_ENTRY,
     args: bridgeInvocationArgs({ relayUrl, gatewayBaseUrl }),
   };
@@ -2526,7 +2751,7 @@ async function readRelayNextGatewayRequest({
     if (message.includes("timeout")) {
       return null;
     }
-    throw error;
+    throw new Error(`relay gateway poll transport failed: GET ${url} -> ${message}`);
   }
 
   if (response.status === 204) {
@@ -3037,12 +3262,20 @@ async function callGatewayRpcLocal({
     return {
       ok: true,
       methods: ["sessions.list", "sessions.abort", "sessions.delete", "sessions.usage", "sessions.patch",
-        "usage.cost", "memory.files.list", "memory.files.get", "memory.files.set", "agents.files.list", "agents.files.get", "agents.files.set",
+        "usage.cost", "session.context.get", "session.context.set",
+        "memory.files.list", "memory.files.get", "memory.files.set", "agents.files.list", "agents.files.get", "agents.files.set",
         "skills.status", "models.list", "chat.history", "chat.abort",
         "config.get", "config.patch"],
     };
   }
 
+  if (
+    method === "session.context.get" ||
+    method === "session.context.set"
+  ) {
+    return callSessionContextRpcLocal({ method, params });
+  }
+
   if (
     method === "memory.files.list" ||
     method === "memory.files.get" ||
@@ -3107,8 +3340,9 @@ async function callGatewayRpcLocalViaCli({
     args.push("--token", gatewayAuthToken);
   }
 
-  const child = spawn("openclaw", args, {
+  const child = spawn(resolveOpenClawBinaryPath(), args, {
     stdio: ["ignore", "pipe", "pipe"],
+    env: buildBridgeRuntimeEnv(),
   });
   let timedOut = false;
   const timeout = setTimeout(() => {
@@ -3537,12 +3771,12 @@ function startRelayBridgeDetached({
   }
 
   const child = spawn(
-    process.execPath,
+    resolveBridgeServiceNodePath(),
     [CLI_ENTRY, "bridge", "--relay", relayUrl, "--gateway", gatewayBaseUrl],
     {
       detached: true,
       stdio: "ignore",
-      env: { ...process.env },
+      env: buildBridgeRuntimeEnv(),
       windowsHide: process.platform === "win32",
     },
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matelink/cli",
-  "version": "2026.4.16",
+  "version": "2026.4.18",
   "private": false,
   "description": "Relay-first CLI for pairing and bridging OpenClaw gateway traffic",
   "type": "module",