openclaw-openviking-setup-helper 0.3.0-beta.21 → 0.3.0-beta.23

package/install.js

@@ -29,10 +29,12 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 
 let REPO = process.env.REPO || "volcengine/OpenViking";
 // PLUGIN_VERSION takes precedence over BRANCH (legacy). If omitted, resolve the latest tag from GitHub.
-const pluginVersionEnv = (process.env.PLUGIN_VERSION || process.env.BRANCH || "").trim();
-let PLUGIN_VERSION = pluginVersionEnv;
-let pluginVersionExplicit = Boolean(pluginVersionEnv);
-const NPM_REGISTRY = process.env.NPM_REGISTRY || "https://registry.npmmirror.com";
+const pluginVersionEnv = (process.env.PLUGIN_VERSION || process.env.BRANCH || "").trim();
+let PLUGIN_VERSION = pluginVersionEnv;
+let pluginVersionExplicit = Boolean(pluginVersionEnv);
+const NPM_REGISTRY = process.env.NPM_REGISTRY || "https://registry.npmmirror.com";
+const DEFAULT_NPM_BUILD_MIN_OPENCLAW_VERSION = "2026.5.3";
+const OPENCLAW_SHORT_VERSION_YEAR = 2026;
 
 const IS_WIN = process.platform === "win32";
 const HOME = process.env.HOME || process.env.USERPROFILE || "";
@@ -44,12 +46,13 @@ let PLUGIN_DEST = "";  // Will be set after resolving plugin config
 // Fallback configs for old versions without manifest
 const FALLBACK_LEGACY = {
   dir: "openclaw-memory-plugin",
-  id: "memory-openviking",
-  kind: "memory",
-  slot: "memory",
-  required: ["index.ts", "config.ts", "client.ts", "openclaw.plugin.json", "package.json"],
-  optional: ["package-lock.json", ".gitignore", "memory-ranking.ts", "text-utils.ts", "process-manager.ts", "tsconfig.json"],
-};
+  id: "memory-openviking",
+  kind: "memory",
+  slot: "memory",
+  minOpenclawVersion: "2026.3.7",
+  required: ["index.ts", "config.ts", "client.ts", "openclaw.plugin.json", "package.json"],
+  optional: ["package-lock.json", ".gitignore", "memory-ranking.ts", "text-utils.ts", "process-manager.ts", "tsconfig.json"],
+};
 
 // Must match examples/openclaw-plugin/install-manifest.json (npm only installs package deps, not these .ts files).
 const FALLBACK_CURRENT = {
@@ -57,15 +60,19 @@ const FALLBACK_CURRENT = {
   id: "openviking",
   kind: "context-engine",
   slot: "contextEngine",
+  minOpenclawVersion: "2026.4.24",
   required: ["index.ts", "config.ts", "package.json", "openclaw.plugin.json"],
   optional: [
     "context-engine.ts",
+    "auto-recall.ts",
     "client.ts",
     "process-manager.ts",
     "memory-ranking.ts",
     "text-utils.ts",
     "tool-call-id.ts",
     "session-transcript-repair.ts",
+    "runtime-utils.ts",
+    "commands/setup.ts",
     "tsconfig.json",
     "package-lock.json",
     ".gitignore",
@@ -82,12 +89,17 @@ let resolvedPluginDir = "";
 let resolvedPluginId = "";
 let resolvedPluginKind = "";
 let resolvedPluginSlot = "";
-let resolvedFilesRequired = [];
-let resolvedFilesOptional = [];
-let resolvedNpmOmitDev = true;
-let resolvedMinOpenclawVersion = "";
-let resolvedMinOpenvikingVersion = "";
-let resolvedPluginReleaseId = "";
+let resolvedFilesRequired = [];
+let resolvedFilesOptional = [];
+let resolvedNpmOmitDev = true;
+let resolvedNpmBuild = false;
+let resolvedNpmBuildMinOpenclawVersion = DEFAULT_NPM_BUILD_MIN_OPENCLAW_VERSION;
+let resolvedNpmBuildScript = "build";
+let resolvedNpmPruneAfterBuild = true;
+let resolvedMinOpenclawVersion = "";
+let resolvedMinOpenvikingVersion = "";
+let resolvedPluginReleaseId = "";
+let detectedOpenClawVersion = "";
 
 let nonInteractive = false;
 let langZh = false;
@@ -402,15 +414,36 @@ function question(prompt, defaultValue = "") {
   });
 }
 
-function isValidAgentPrefixInput(value) {
-  const trimmed = String(value || "").trim();
-  return !trimmed || /^[a-zA-Z0-9_-]+$/.test(trimmed);
-}
-
-async function questionAgentPrefix(defaultValue = "") {
-  while (true) {
-    const answer = (await question(
-      tr("Agent Prefix (optional)", "Agent Prefix（可选）"),
+function isValidAgentPrefixInput(value) {
+  const trimmed = String(value || "").trim();
+  return !trimmed || /^[a-zA-Z0-9_-]+$/.test(trimmed);
+}
+
+function parseJsonObjectFromOutput(output) {
+  const text = String(output || "").trim();
+  if (!text) return null;
+  try {
+    return JSON.parse(text);
+  } catch {
+    // OpenClaw may print plugin registration logs before --json output.
+  }
+  for (let index = text.lastIndexOf("{"); index >= 0; index = text.lastIndexOf("{", index - 1)) {
+    try {
+      const parsed = JSON.parse(text.slice(index).trim());
+      if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+        return parsed;
+      }
+    } catch {
+      // Keep scanning earlier braces until the outer JSON object is found.
+    }
+  }
+  return null;
+}
+
+async function questionAgentPrefix(defaultValue = "") {
+  while (true) {
+    const answer = (await question(
+      tr("Agent Prefix (optional)", "Agent Prefix（可选）"),
       defaultValue,
     )).trim();
     if (isValidAgentPrefixInput(answer)) {
@@ -497,23 +530,68 @@ async function checkOpenClaw() {
 }
 
 // Compare versions: returns true if v1 >= v2
-function versionGte(v1, v2) {
-  const parseVersion = (v) => {
-    const cleaned = v.replace(/^v/, "").replace(/-.*$/, "");
-    const parts = cleaned.split(".").map((p) => Number.parseInt(p, 10) || 0);
-    while (parts.length < 3) parts.push(0);
+function versionGte(v1, v2) {
+  const parseVersion = (v) => {
+    const cleaned = v.replace(/^v/, "").replace(/-.*$/, "");
+    const parts = cleaned.split(".").map((p) => Number.parseInt(p, 10) || 0);
+    while (parts.length < 3) parts.push(0);
     return parts;
   };
   const [a1, a2, a3] = parseVersion(v1);
   const [b1, b2, b3] = parseVersion(v2);
   if (a1 !== b1) return a1 > b1;
-  if (a2 !== b2) return a2 > b2;
-  return a3 >= b3;
-}
-
-function isSemverLike(value) {
-  return /^v?\d+(\.\d+){1,2}$/.test(value);
-}
+  if (a2 !== b2) return a2 > b2;
+  return a3 >= b3;
+}
+
+function parseOpenClawPolicyVersion(value) {
+  const parts = String(value || "")
+    .match(/\d+/g)
+    ?.map((part) => Number.parseInt(part, 10) || 0) || [];
+  if (parts.length === 0) return [0, 0, 0];
+  if (parts[0] >= 2000) {
+    return [parts[0], parts[1] || 0, parts[2] || 0];
+  }
+  return [OPENCLAW_SHORT_VERSION_YEAR, parts[0] || 0, parts[1] || 0];
+}
+
+function openClawPolicyVersionGte(v1, v2) {
+  const a = parseOpenClawPolicyVersion(v1);
+  const b = parseOpenClawPolicyVersion(v2);
+  for (let i = 0; i < 3; i++) {
+    if (a[i] !== b[i]) return a[i] > b[i];
+  }
+  return true;
+}
+
+function applyOpenClawBuildPolicy(openClawVersion) {
+  if (!resolvedNpmBuild || !resolvedNpmBuildMinOpenclawVersion) {
+    return;
+  }
+  if (!openClawVersion || openClawVersion === "0.0.0") {
+    warn(tr(
+      "Could not determine OpenClaw version; keeping plugin source build enabled.",
+      "无法确定 OpenClaw 版本，保持插件源码构建开启。",
+    ));
+    return;
+  }
+  if (openClawPolicyVersionGte(openClawVersion, resolvedNpmBuildMinOpenclawVersion)) {
+    info(tr(
+      `OpenClaw ${openClawVersion} requires plugin source build (>= ${resolvedNpmBuildMinOpenclawVersion})`,
+      `OpenClaw ${openClawVersion} 需要插件源码构建（>= ${resolvedNpmBuildMinOpenclawVersion}）`,
+    ));
+    return;
+  }
+  resolvedNpmBuild = false;
+  info(tr(
+    `OpenClaw ${openClawVersion} is below ${resolvedNpmBuildMinOpenclawVersion}; skipping plugin source build`,
+    `OpenClaw ${openClawVersion} 低于 ${resolvedNpmBuildMinOpenclawVersion}，跳过插件源码构建`,
+  ));
+}
+
+function isSemverLike(value) {
+  return /^v?\d+(\.\d+){1,2}$/.test(value);
+}
 
 function validateRequestedPluginVersion() {
   if (!isSemverLike(PLUGIN_VERSION)) return;
@@ -534,16 +612,24 @@ if (uninstallPlugin && (upgradePluginOnly || rollbackLastUpgrade)) {
 }
 
 // Detect OpenClaw version
-async function detectOpenClawVersion() {
-  try {
-    const result = await runCapture("openclaw", ["--version"], { shell: IS_WIN });
-    if (result.code === 0 && result.out) {
-      const match = result.out.match(/\d+\.\d+(\.\d+)?/);
-      if (match) return match[0];
-    }
-  } catch {}
-  return "0.0.0";
-}
+async function detectOpenClawVersion() {
+  if (detectedOpenClawVersion) {
+    return detectedOpenClawVersion;
+  }
+  try {
+    const result = await runCapture("openclaw", ["--version"], { shell: IS_WIN });
+    const output = `${result.out || ""}\n${result.err || ""}`;
+    if (result.code === 0 && output) {
+      const match = output.match(/\d+\.\d+(\.\d+)?/);
+      if (match) {
+        detectedOpenClawVersion = match[0];
+        return detectedOpenClawVersion;
+      }
+    }
+  } catch {}
+  detectedOpenClawVersion = "0.0.0";
+  return detectedOpenClawVersion;
+}
 
 // Try to fetch a URL, return response text or null
 async function tryFetch(url, timeout = 15000) {
@@ -686,13 +772,19 @@ async function resolveDefaultPluginVersion() {
 }
 
 // Resolve plugin configuration from manifest or fallback
-async function resolvePluginConfig() {
-  const ghRaw = `https://raw.githubusercontent.com/${REPO}/${PLUGIN_VERSION}`;
-
-  info(tr(`Resolving plugin configuration for version: ${PLUGIN_VERSION}`, `正在解析插件配置，版本: ${PLUGIN_VERSION}`));
-
-  let pluginDir = "";
-  let manifestData = null;
+async function resolvePluginConfig() {
+  const ghRaw = `https://raw.githubusercontent.com/${REPO}/${PLUGIN_VERSION}`;
+
+  info(tr(`Resolving plugin configuration for version: ${PLUGIN_VERSION}`, `正在解析插件配置，版本: ${PLUGIN_VERSION}`));
+
+  resolvedNpmOmitDev = true;
+  resolvedNpmBuild = false;
+  resolvedNpmBuildMinOpenclawVersion = DEFAULT_NPM_BUILD_MIN_OPENCLAW_VERSION;
+  resolvedNpmBuildScript = "build";
+  resolvedNpmPruneAfterBuild = true;
+
+  let pluginDir = "";
+  let manifestData = null;
 
   // Try to detect plugin directory and download manifest
   const manifestCurrent = await tryFetch(`${ghRaw}/examples/openclaw-plugin/install-manifest.json`);
@@ -729,13 +821,25 @@ async function resolvePluginConfig() {
     resolvedPluginId = manifestData.plugin?.id || "";
     resolvedPluginKind = manifestData.plugin?.kind || "";
     resolvedPluginSlot = manifestData.plugin?.slot || "";
-    resolvedMinOpenclawVersion = manifestData.compatibility?.minOpenclawVersion || "";
-    resolvedMinOpenvikingVersion = manifestData.compatibility?.minOpenvikingVersion || "";
-    resolvedPluginReleaseId = manifestData.pluginVersion || manifestData.release?.id || "";
-    resolvedNpmOmitDev = manifestData.npm?.omitDev !== false;
-    resolvedFilesRequired = manifestData.files?.required || [];
-    resolvedFilesOptional = manifestData.files?.optional || [];
-  } else {
+    resolvedMinOpenclawVersion = manifestData.compatibility?.minOpenclawVersion || "";
+    resolvedMinOpenvikingVersion = manifestData.compatibility?.minOpenvikingVersion || "";
+    resolvedPluginReleaseId = manifestData.pluginVersion || manifestData.release?.id || "";
+    const npmConfig = manifestData.npm && typeof manifestData.npm === "object"
+      ? manifestData.npm
+      : {};
+    resolvedNpmOmitDev = npmConfig.omitDev !== false;
+    resolvedNpmBuild = npmConfig.build === true || npmConfig.buildFromSource === true;
+    resolvedNpmBuildMinOpenclawVersion =
+      typeof npmConfig.buildMinOpenclawVersion === "string" && npmConfig.buildMinOpenclawVersion.trim()
+        ? npmConfig.buildMinOpenclawVersion.trim()
+        : DEFAULT_NPM_BUILD_MIN_OPENCLAW_VERSION;
+    resolvedNpmBuildScript = typeof npmConfig.buildScript === "string" && npmConfig.buildScript.trim()
+      ? npmConfig.buildScript.trim()
+      : "build";
+    resolvedNpmPruneAfterBuild = npmConfig.pruneAfterBuild !== false;
+    resolvedFilesRequired = manifestData.files?.required || [];
+    resolvedFilesOptional = manifestData.files?.optional || [];
+  } else {
     // No manifest — determine plugin identity by package.json name
     let fallbackKey = pluginDir === "openclaw-memory-plugin" ? "legacy" : "current";
     let compatVer = "";
@@ -764,11 +868,15 @@ async function resolvePluginConfig() {
     resolvedPluginId = fallback.id;
     resolvedPluginKind = fallback.kind;
     resolvedPluginSlot = fallback.slot;
-    resolvedFilesRequired = fallback.required;
-    resolvedFilesOptional = fallback.optional;
-    resolvedNpmOmitDev = true;
-
-    // If no compatVer from package.json, try main branch manifest
+    resolvedFilesRequired = fallback.required;
+    resolvedFilesOptional = fallback.optional;
+    resolvedNpmOmitDev = true;
+    resolvedNpmBuild = false;
+    resolvedNpmBuildMinOpenclawVersion = DEFAULT_NPM_BUILD_MIN_OPENCLAW_VERSION;
+    resolvedNpmBuildScript = "build";
+    resolvedNpmPruneAfterBuild = true;
+
+    // If no compatVer from package.json, try main branch manifest
     if (!compatVer && PLUGIN_VERSION !== "main") {
       const mainRaw = `https://raw.githubusercontent.com/${REPO}/main`;
       const mainManifest = await tryFetch(`${mainRaw}/examples/openclaw-plugin/install-manifest.json`);
@@ -783,7 +891,7 @@ async function resolvePluginConfig() {
       }
     }
 
-    resolvedMinOpenclawVersion = compatVer || "2026.3.7";
+    resolvedMinOpenclawVersion = compatVer || fallback.minOpenclawVersion || "2026.3.7";
     resolvedMinOpenvikingVersion = "";
   }
 
@@ -799,11 +907,12 @@ async function checkOpenClawCompatibility() {
     return;
   }
 
-  const ocVersion = await detectOpenClawVersion();
-  info(tr(`Detected OpenClaw version: ${ocVersion}`, `检测到 OpenClaw 版本: ${ocVersion}`));
-
-  // If no minimum version required, pass
-  if (!resolvedMinOpenclawVersion) {
+  const ocVersion = await detectOpenClawVersion();
+  info(tr(`Detected OpenClaw version: ${ocVersion}`, `检测到 OpenClaw 版本: ${ocVersion}`));
+  applyOpenClawBuildPolicy(ocVersion);
+
+  // If no minimum version required, pass
+  if (!resolvedMinOpenclawVersion) {
     return;
   }
 
@@ -1309,7 +1418,7 @@ async function prepareStrongPluginUpgrade() {
   info(tr(`Upgrade audit file: ${getUpgradeAuditPath()}`, `升级审计文件: ${getUpgradeAuditPath()}`));
 }
 
-async function downloadPluginFile(destDir, fileName, url, required, index, total) {
+async function downloadPluginFile(destDir, fileName, url, required, index, total) {
   const maxRetries = 3;
   const destPath = join(destDir, fileName);
 
@@ -1369,12 +1478,109 @@ async function downloadPluginFile(destDir, fileName, url, required, index, total
 
   console.log("");
   err(tr(`Download failed after ${maxRetries} retries: ${url}`, `下载失败（已重试 ${maxRetries} 次）: ${url}`));
-  process.exit(1);
-}
-
-async function downloadPlugin(destDir) {
-  const ghRaw = `https://raw.githubusercontent.com/${REPO}/${PLUGIN_VERSION}`;
-  const pluginDir = resolvedPluginDir;
+  process.exit(1);
+}
+
+function runtimeOutputCandidatesForEntry(entry) {
+  const normalized = String(entry || "").replace(/\\/g, "/").replace(/^\.\//, "");
+  if (!normalized.endsWith(".ts")) {
+    return [];
+  }
+  const withoutExt = normalized.slice(0, -3);
+  return [
+    `dist/${withoutExt}.js`,
+    `dist/${withoutExt}.mjs`,
+    `dist/${withoutExt}.cjs`,
+    `${withoutExt}.js`,
+    `${withoutExt}.mjs`,
+    `${withoutExt}.cjs`,
+  ];
+}
+
+async function assertBuiltRuntimeOutputs(destDir) {
+  let pkg = null;
+  try {
+    pkg = JSON.parse(await readFile(join(destDir, "package.json"), "utf8"));
+  } catch {
+    return;
+  }
+
+  const entries = [];
+  const extensions = pkg?.openclaw?.extensions;
+  if (Array.isArray(extensions)) {
+    for (const entry of extensions) {
+      if (typeof entry === "string") entries.push(entry);
+    }
+  }
+  if (typeof pkg?.openclaw?.setupEntry === "string") {
+    entries.push(pkg.openclaw.setupEntry);
+  }
+
+  const missing = [];
+  for (const entry of entries) {
+    const candidates = runtimeOutputCandidatesForEntry(entry);
+    if (candidates.length === 0) continue;
+    const found = candidates.some((candidate) => existsSync(join(destDir, ...candidate.split("/"))));
+    if (!found) {
+      missing.push(`${entry} (expected one of: ${candidates.join(", ")})`);
+    }
+  }
+
+  if (missing.length === 0) {
+    return;
+  }
+
+  err(tr(
+    `Plugin build did not create required runtime output:\n  - ${missing.join("\n  - ")}`,
+    `插件构建未生成必需的运行时产物：\n  - ${missing.join("\n  - ")}`,
+  ));
+  process.exit(1);
+}
+
+async function installPluginNpmDependencies(destDir) {
+  if (!resolvedNpmBuild) {
+    info(tr("Installing plugin npm dependencies...", "正在安装插件 npm 依赖..."));
+    const npmArgs = resolvedNpmOmitDev
+      ? ["install", "--omit=dev", "--no-audit", "--no-fund", "--registry", NPM_REGISTRY]
+      : ["install", "--no-audit", "--no-fund", "--registry", NPM_REGISTRY];
+    await run("npm", npmArgs, { cwd: destDir, silent: false });
+    return;
+  }
+
+  info(tr(
+    "Installing plugin npm dependencies for source build...",
+    "正在安装插件源码构建所需的 npm 依赖...",
+  ));
+  await run("npm", [
+    "install",
+    "--include=dev",
+    "--no-audit",
+    "--no-fund",
+    "--registry",
+    NPM_REGISTRY,
+  ], { cwd: destDir, silent: false });
+
+  info(tr(
+    `Building plugin runtime output with npm run ${resolvedNpmBuildScript}...`,
+    `正在执行 npm run ${resolvedNpmBuildScript} 构建插件运行时产物...`,
+  ));
+  await run("npm", ["run", resolvedNpmBuildScript], { cwd: destDir, silent: false });
+  await assertBuiltRuntimeOutputs(destDir);
+
+  if (resolvedNpmOmitDev && resolvedNpmPruneAfterBuild) {
+    info(tr("Pruning plugin dev dependencies...", "正在裁剪插件开发依赖..."));
+    await run("npm", [
+      "prune",
+      "--omit=dev",
+      "--no-audit",
+      "--no-fund",
+    ], { cwd: destDir, silent: false });
+  }
+}
+
+async function downloadPlugin(destDir) {
+  const ghRaw = `https://raw.githubusercontent.com/${REPO}/${PLUGIN_VERSION}`;
+  const pluginDir = resolvedPluginDir;
   const total = resolvedFilesRequired.length + resolvedFilesOptional.length;
 
   await mkdir(destDir, { recursive: true });
@@ -1398,14 +1604,9 @@ async function downloadPlugin(destDir) {
     await downloadPluginFile(destDir, name, url, false, i, total);
   }
 
-  // npm install
-  info(tr("Installing plugin npm dependencies...", "正在安装插件 npm 依赖..."));
-  const npmArgs = resolvedNpmOmitDev
-    ? ["install", "--omit=dev", "--no-audit", "--no-fund", "--registry", NPM_REGISTRY]
-    : ["install", "--no-audit", "--no-fund", "--registry", NPM_REGISTRY];
-  await run("npm", npmArgs, { cwd: destDir, silent: false });
-  info(tr(`Plugin deployed: ${PLUGIN_DEST}`, `插件部署完成: ${PLUGIN_DEST}`));
-}
+  await installPluginNpmDependencies(destDir);
+  info(tr(`Plugin deployed: ${PLUGIN_DEST}`, `插件部署完成: ${PLUGIN_DEST}`));
+}
 
 async function createPluginStagingDir() {
   const pluginId = resolvedPluginId || "openviking";
@@ -1730,11 +1931,9 @@ async function configureOpenClawPlugin({
     }
   } catch { /* ignore read errors */ }
 
-  let setupResult = null;
-  if (setupJsonSupported) {
-    const setupArgs = needWorkdirFlag
-      ? ["--workdir", OPENCLAW_DIR, "openviking", "setup"]
-      : ["openviking", "setup"];
+  let setupResult = null;
+  if (setupJsonSupported) {
+    const setupArgs = ["openviking", "setup"];
     setupArgs.push("--base-url", effectiveRuntimeConfig.baseUrl || remoteBaseUrl);
     setupArgs.push("--json");
     if (effectiveRuntimeConfig.apiKey) {
@@ -1769,14 +1968,10 @@ async function configureOpenClawPlugin({
     ));
   }
 
-  let parsed = null;
-  if (setupResult) {
-    try {
-      parsed = JSON.parse(setupResult.out.trim());
-    } catch {
-      // If JSON parse fails, fall back to checking exit code
-    }
-  }
+  let parsed = null;
+  if (setupResult) {
+    parsed = parseJsonObjectFromOutput(`${setupResult.out || ""}\n${setupResult.err || ""}`);
+  }
 
   if (parsed) {
     if (parsed.success) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-openviking-setup-helper",
-  "version": "0.3.0-beta.21",
+  "version": "0.3.0-beta.23",
   "description": "Setup helper for installing OpenViking memory plugin into OpenClaw",
   "type": "module",
   "bin": {