@matelink/cli 2026.4.15 → 2026.4.17

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,6 +51,7 @@ const DEFAULT_GATEWAY_SCOPES = [
   "operator.approvals",
   "operator.pairing",
 ].join(",");
+const SESSION_CONTEXT_MIN_TOKENS = 1024;
 const CLI_ENTRY = fileURLToPath(import.meta.url);
 const CLI_LANGUAGE = detectCliLanguage();
 const CLI_I18N = {
@@ -446,6 +447,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 +559,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) {
@@ -663,11 +691,104 @@ function listWorkspaceFiles(workspaceRoot) {
   return files;
 }
 
+const FIXED_MEMORY_FILES = new Set([
+  "AGENTS.md",
+  "HEARTBEAT.md",
+  "IDENTITY.md",
+  "MEMORY.md",
+  "SOUL.md",
+  "TOOLS.md",
+  "USER.md",
+]);
+
+function normalizeFixedMemoryFileName(rawName) {
+  const normalized = String(rawName ?? "").trim().toUpperCase();
+  for (const fileName of FIXED_MEMORY_FILES) {
+    if (fileName.toUpperCase() === normalized) {
+      return fileName;
+    }
+  }
+  throw new Error(`unsupported memory file: ${String(rawName ?? "").trim()}`);
+}
+
+function listFixedMemoryFiles(workspaceRoot) {
+  return Array.from(FIXED_MEMORY_FILES)
+    .sort((a, b) => a.localeCompare(b))
+    .map((name) => {
+      const { relativePath, absolutePath } = resolveWorkspaceFilePath(workspaceRoot, name);
+      if (!fs.existsSync(absolutePath)) {
+        return buildWorkspaceFileMeta({
+          workspaceRoot,
+          relativePath,
+          absolutePath,
+          missing: true,
+        });
+      }
+      return buildWorkspaceFileMeta({
+        workspaceRoot,
+        relativePath,
+        absolutePath,
+      });
+    });
+}
+
 async function callWorkspaceRpcLocal({
   method,
   params,
 }) {
   const workspaceRoot = resolveConfiguredWorkspaceRoot();
+  if (method === "memory.files.list") {
+    return {
+      ok: true,
+      workspace: workspaceRoot,
+      files: listFixedMemoryFiles(workspaceRoot),
+    };
+  }
+
+  if (method === "memory.files.get") {
+    const fixedName = normalizeFixedMemoryFileName(params?.name);
+    const { relativePath, absolutePath } = resolveWorkspaceFilePath(workspaceRoot, fixedName);
+    if (!fs.existsSync(absolutePath)) {
+      return {
+        ok: true,
+        workspace: workspaceRoot,
+        file: buildWorkspaceFileMeta({
+          workspaceRoot,
+          relativePath,
+          absolutePath,
+          missing: true,
+        }),
+      };
+    }
+    return {
+      ok: true,
+      workspace: workspaceRoot,
+      file: buildWorkspaceFileMeta({
+        workspaceRoot,
+        relativePath,
+        absolutePath,
+        includeContent: true,
+      }),
+    };
+  }
+
+  if (method === "memory.files.set") {
+    const fixedName = normalizeFixedMemoryFileName(params?.name);
+    const { relativePath, absolutePath } = resolveWorkspaceFilePath(workspaceRoot, fixedName);
+    fs.mkdirSync(path.dirname(absolutePath), { recursive: true });
+    fs.writeFileSync(absolutePath, String(params?.content ?? ""), "utf8");
+    return {
+      ok: true,
+      workspace: workspaceRoot,
+      file: buildWorkspaceFileMeta({
+        workspaceRoot,
+        relativePath,
+        absolutePath,
+        includeContent: true,
+      }),
+    };
+  }
+
   if (method === "agents.files.list") {
     return {
       ok: true,
@@ -721,6 +842,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) => {
@@ -2944,13 +3121,24 @@ async function callGatewayRpcLocal({
     return {
       ok: true,
       methods: ["sessions.list", "sessions.abort", "sessions.delete", "sessions.usage", "sessions.patch",
-        "usage.cost", "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" ||
+    method === "memory.files.set" ||
     method === "agents.files.list" ||
     method === "agents.files.get" ||
     method === "agents.files.set"

package/package.json

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