@remnic/cli 1.0.6 → 1.0.8

package/dist/index.js

@@ -1298,7 +1298,8 @@ var SUPPORTED_IMPORTERS = [
   "chatgpt",
   "claude",
   "gemini",
-  "mem0"
+  "mem0",
+  "supermemory"
 ];
 function isSupportedImporterName(value) {
   return SUPPORTED_IMPORTERS.includes(value);
@@ -3702,6 +3703,16 @@ function parseOpenclawPluginState(existingConfig, configPath) {
   const slots = rawSlots ?? {};
   return { plugins, entries, slots };
 }
+function readOpenclawHooksPolicy(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function buildRemnicOpenclawHooksPolicy(legacyHooks, existingHooks) {
+  return {
+    ...readOpenclawHooksPolicy(legacyHooks),
+    ...readOpenclawHooksPolicy(existingHooks),
+    allowConversationAccess: true
+  };
+}
 function resolveOpenclawInstallMemoryDir(args) {
   const existingMemoryDir = (typeof args.existingNewEntryConfig.memoryDir === "string" ? args.existingNewEntryConfig.memoryDir : void 0) || (args.migrateLegacy && typeof args.legacyConfigToMerge.memoryDir === "string" ? args.legacyConfigToMerge.memoryDir : void 0);
   if (args.requestedMemoryDir) {
@@ -3735,6 +3746,10 @@ function resolveOpenclawPluginDir(cliPath) {
   if (cliPath) return path8.resolve(expandTilde(cliPath));
   return path8.join(resolveHomeDir(), ".openclaw", "extensions", REMNIC_OPENCLAW_PLUGIN_ID);
 }
+function resolveOpenclawLegacyPluginDir(cliPath) {
+  if (cliPath) return path8.resolve(expandTilde(cliPath));
+  return path8.join(resolveHomeDir(), ".openclaw", "extensions", REMNIC_OPENCLAW_LEGACY_PLUGIN_ID);
+}
 function formatOpenclawUpgradeStamp(now = /* @__PURE__ */ new Date()) {
   const yyyy = now.getFullYear().toString();
   const mm = String(now.getMonth() + 1).padStart(2, "0");
@@ -3920,56 +3935,59 @@ async function cmdQuery(queryText, json, explain) {
   const config = parseConfig(remnicCfg);
   const orchestrator = new Orchestrator(config);
   await orchestrator.initialize();
-  await orchestrator.deferredReady;
   const service = new EngramAccessService(orchestrator);
-  if (explain) {
-    const bench = await tryLoadBenchModule();
-    if (bench?.runExplain) {
-      const result2 = await bench.runExplain(service, queryText);
+  try {
+    if (explain) {
+      const bench = await tryLoadBenchModule();
+      if (bench?.runExplain) {
+        const result2 = await bench.runExplain(service, queryText);
+        if (json) {
+          console.log(JSON.stringify(result2, null, 2));
+        } else {
+          console.log(`Query: ${result2.query}`);
+          console.log(`Tiers used: ${result2.tiersUsed.join(" \u2192 ")}`);
+          console.log(`Total duration: ${result2.totalDurationMs}ms`);
+          for (const t of result2.tierResults) {
+            console.log(`  ${t.tier}: ${t.latencyMs}ms (${t.resultsCount} results)`);
+          }
+        }
+        return;
+      }
+      const explainStart = Date.now();
+      const recallResult = await service.recall({ query: queryText, mode: "auto" });
+      const totalDurationMs = Date.now() - explainStart;
+      const resultsCount = typeof recallResult.count === "number" ? recallResult.count : Array.isArray(recallResult.results) ? recallResult.results.length : 0;
+      const minimalExplain = {
+        query: queryText,
+        totalDurationMs,
+        resultsCount,
+        note: "Install @remnic/bench for a full tier-level explain breakdown."
+      };
       if (json) {
-        console.log(JSON.stringify(result2, null, 2));
+        console.log(JSON.stringify(minimalExplain, null, 2));
       } else {
-        console.log(`Query: ${result2.query}`);
-        console.log(`Tiers used: ${result2.tiersUsed.join(" \u2192 ")}`);
-        console.log(`Total duration: ${result2.totalDurationMs}ms`);
-        for (const t of result2.tierResults) {
-          console.log(`  ${t.tier}: ${t.latencyMs}ms (${t.resultsCount} results)`);
-        }
+        console.log(`Query: ${minimalExplain.query}`);
+        console.log(`Total duration: ${minimalExplain.totalDurationMs}ms`);
+        console.log(`Results: ${minimalExplain.resultsCount}`);
+        console.log(`Note: ${minimalExplain.note}`);
       }
       return;
     }
-    const explainStart = Date.now();
-    const recallResult = await service.recall({ query: queryText, mode: "auto" });
-    const totalDurationMs = Date.now() - explainStart;
-    const resultsCount = typeof recallResult.count === "number" ? recallResult.count : Array.isArray(recallResult.results) ? recallResult.results.length : 0;
-    const minimalExplain = {
-      query: queryText,
-      totalDurationMs,
-      resultsCount,
-      note: "Install @remnic/bench for a full tier-level explain breakdown."
-    };
+    const result = await service.recall({ query: queryText, mode: "auto" });
     if (json) {
-      console.log(JSON.stringify(minimalExplain, null, 2));
+      console.log(JSON.stringify(result, null, 2));
     } else {
-      console.log(`Query: ${minimalExplain.query}`);
-      console.log(`Total duration: ${minimalExplain.totalDurationMs}ms`);
-      console.log(`Results: ${minimalExplain.resultsCount}`);
-      console.log(`Note: ${minimalExplain.note}`);
-    }
-    return;
-  }
-  const result = await service.recall({ query: queryText, mode: "auto" });
-  if (json) {
-    console.log(JSON.stringify(result, null, 2));
-  } else {
-    const memories = result.memories ?? [];
-    if (memories.length === 0) {
-      console.log("No results.");
-      return;
-    }
-    for (const m of memories) {
-      console.log(`- ${m.content}`);
+      const memories = result.memories ?? [];
+      if (memories.length === 0) {
+        console.log("No results.");
+        return;
+      }
+      for (const m of memories) {
+        console.log(`- ${m.content}`);
+      }
     }
+  } finally {
+    orchestrator.abortDeferredInit();
   }
 }
 function extractXrayRawArgs(rest) {
@@ -4027,14 +4045,18 @@ async function cmdXray(rest) {
   await orchestrator.initialize();
   await orchestrator.deferredReady;
   const service = new EngramAccessService(orchestrator);
-  await runXrayCommand(rest, {
-    recallXray: (request) => service.recallXray(request),
-    writeFile: async (filePath, data) => {
-      const { writeFile: fsWriteFile } = await import("fs/promises");
-      await fsWriteFile(filePath, data, "utf8");
-    },
-    stdout: (line) => console.log(line)
-  });
+  try {
+    await runXrayCommand(rest, {
+      recallXray: (request) => service.recallXray(request),
+      writeFile: async (filePath, data) => {
+        const { writeFile: fsWriteFile } = await import("fs/promises");
+        await fsWriteFile(filePath, data, "utf8");
+      },
+      stdout: (line) => console.log(line)
+    });
+  } finally {
+    orchestrator.abortDeferredInit();
+  }
 }
 async function cmdVersions(rest) {
   initLogger();
@@ -6460,6 +6482,7 @@ async function cmdOpenclawInstall(opts) {
   const existingNewEntry = entries[REMNIC_OPENCLAW_PLUGIN_ID];
   const legacyConfigToMerge = migrateLegacy && legacyEntry?.config && typeof legacyEntry.config === "object" ? legacyEntry.config : {};
   const existingNewEntryConfig = existingNewEntry?.config && typeof existingNewEntry.config === "object" ? existingNewEntry.config : {};
+  const defaultModelSource = !hasNew && !migrateLegacy ? "gateway" : "plugin";
   const memoryDir = resolveOpenclawInstallMemoryDir({
     requestedMemoryDir: opts.memoryDir,
     existingNewEntryConfig,
@@ -6478,7 +6501,12 @@ async function cmdOpenclawInstall(opts) {
   const newEntry = {
     ...legacyNonConfigFields,
     ...existingNewEntryFields,
+    hooks: buildRemnicOpenclawHooksPolicy(
+      legacyNonConfigFields.hooks,
+      existingNewEntryFields.hooks
+    ),
     config: {
+      modelSource: defaultModelSource,
       ...legacyConfigToMerge,
       ...existingNewEntryConfig,
       memoryDir
@@ -6499,6 +6527,7 @@ async function cmdOpenclawInstall(opts) {
   const changes = [];
   if (!hasNew) changes.push(`+ Added plugins.entries["${REMNIC_OPENCLAW_PLUGIN_ID}"]`);
   else changes.push(`~ Updated plugins.entries["${REMNIC_OPENCLAW_PLUGIN_ID}"].config.memoryDir`);
+  changes.push(`~ Set plugins.entries["${REMNIC_OPENCLAW_PLUGIN_ID}"].hooks.allowConversationAccess = true`);
   if (!slotIsActiveLegacy && currentSlot !== REMNIC_OPENCLAW_PLUGIN_ID) {
     changes.push(`~ Set plugins.slots.memory = "${REMNIC_OPENCLAW_PLUGIN_ID}" (was: ${currentSlot ?? "(unset)"})`);
   } else if (slotIsActiveLegacy) {
@@ -6515,7 +6544,8 @@ async function cmdOpenclawInstall(opts) {
     const dryRunEntries = dryRunPlugins.entries;
     const entrySummary = dryRunEntries ? Object.keys(dryRunEntries).map((k) => {
       const cfg = dryRunEntries[k]?.config;
-      return `  ${k}: { config: { memoryDir: ${cfg?.memoryDir ?? "(unset)"}, ... } }`;
+      const hooks = dryRunEntries[k]?.hooks;
+      return `  ${k}: { hooks: { allowConversationAccess: ${hooks?.allowConversationAccess ?? "(unset)"} }, config: { memoryDir: ${cfg?.memoryDir ?? "(unset)"}, ... } }`;
     }).join("\n") : "  (none)";
     console.log("\nResulting plugins.entries:");
     console.log(entrySummary);
@@ -6562,6 +6592,7 @@ Note: The legacy '${REMNIC_OPENCLAW_LEGACY_PLUGIN_ID}' entry has been kept along
 async function cmdOpenclawUpgrade(opts) {
   const configPath = resolveOpenclawConfigPath(opts.configPath);
   const pluginDir = resolveOpenclawPluginDir(opts.pluginDir);
+  const legacyPluginDirForBackup = opts.legacyPluginDirForBackup ? resolveOpenclawLegacyPluginDir(opts.legacyPluginDirForBackup) : void 0;
   const fallbackMemoryDir = path8.join(resolveHomeDir(), ".openclaw", "workspace", "memory", "local");
   const packageSpec = `@remnic/plugin-openclaw@${opts.version ?? "latest"}`;
   const existingConfig = readOpenclawConfig(configPath);
@@ -6575,14 +6606,22 @@ async function cmdOpenclawUpgrade(opts) {
   );
   const configBackupPath = path8.join(backupDir, "openclaw.json");
   const pluginBackupDir = path8.join(backupDir, "extensions", REMNIC_OPENCLAW_PLUGIN_ID);
+  const legacyPluginBackupDir = legacyPluginDirForBackup ? path8.join(backupDir, "extensions", REMNIC_OPENCLAW_LEGACY_PLUGIN_ID) : void 0;
   assertDirectoryPathOrMissing(pluginDir, "OpenClaw plugin dir");
+  if (legacyPluginDirForBackup) {
+    assertDirectoryPathOrMissing(legacyPluginDirForBackup, "Legacy OpenClaw plugin dir");
+  }
   console.log(`OpenClaw config: ${configPath}`);
   console.log(`Plugin dir:      ${pluginDir}`);
+  if (legacyPluginDirForBackup) {
+    console.log(`Legacy dir:      ${legacyPluginDirForBackup}`);
+  }
   console.log(`Memory dir:      ${preservedMemoryDir}`);
   console.log(`Package spec:    ${packageSpec}`);
   console.log(`Backup dir:      ${backupDir}`);
   const plannedActions = [
     `backup openclaw.json and the existing ${REMNIC_OPENCLAW_PLUGIN_ID} extension`,
+    ...legacyPluginDirForBackup ? [`backup the existing ${REMNIC_OPENCLAW_LEGACY_PLUGIN_ID} extension without modifying it`] : [],
     `npm pack ${packageSpec} and stage a clean plugin copy before swap`,
     `re-run remnic openclaw install with the preserved memory dir`,
     opts.restartGateway ? "restart the OpenClaw gateway with launchctl kickstart" : "leave gateway restart to the operator (--no-restart)"
@@ -6615,6 +6654,13 @@ async function cmdOpenclawUpgrade(opts) {
   } else {
     backupNotes.push(`  No existing plugin dir found at ${pluginDir}; a fresh install will be staged`);
   }
+  if (legacyPluginDirForBackup && legacyPluginBackupDir) {
+    if (backupPathIfPresent(legacyPluginDirForBackup, legacyPluginBackupDir)) {
+      backupNotes.push(`+ Backed up legacy plugin dir to ${legacyPluginBackupDir}`);
+    } else {
+      backupNotes.push(`  No existing legacy plugin dir found at ${legacyPluginDirForBackup}; nothing to preserve`);
+    }
+  }
   let installResult;
   try {
     installResult = installPublishedOpenclawPlugin(packageSpec, pluginDir);
@@ -6680,6 +6726,22 @@ Installed published plugin from npm pack ${packageSpec}${installResult.version ?
     console.log(`  launchctl kickstart -k gui/$(id -u)/${OPENCLAW_GATEWAY_LABEL}`);
   }
 }
+async function cmdOpenclawMigrateEngram(opts) {
+  console.log(
+    `Migrating legacy ${REMNIC_OPENCLAW_LEGACY_PLUGIN_ID} installs to ${REMNIC_OPENCLAW_PLUGIN_ID}.`
+  );
+  console.log(
+    "The legacy config entry and extension directory are preserved for rollback and custom patch reference."
+  );
+  await cmdOpenclawUpgrade({
+    ...opts,
+    legacyPluginDirForBackup: opts.legacyPluginDirForBackup ?? resolveOpenclawLegacyPluginDir()
+  });
+  console.log("\nMigration notes:");
+  console.log(`  - plugins.entries["${REMNIC_OPENCLAW_PLUGIN_ID}"] is the canonical entry.`);
+  console.log(`  - plugins.entries["${REMNIC_OPENCLAW_LEGACY_PLUGIN_ID}"] is retained temporarily for rollback.`);
+  console.log("  - Re-apply any local source patches to the new package only after verifying the published build.");
+}
 async function cmdTaxonomy(rest) {
   initLogger();
   const configPath = resolveConfigPath();
@@ -7531,28 +7593,38 @@ Run 'remnic capsule <subcommand> --help' for subcommand details.`);
         const memoryDir = resolveRequiredValueFlag(args, "--memory-dir");
         const configOverride = resolveRequiredValueFlag(args, "--config");
         await cmdOpenclawInstall({ yes, dryRun, memoryDir, configPath: configOverride });
-      } else if (subAction === "upgrade") {
+      } else if (subAction === "upgrade" || subAction === "migrate-engram") {
         const yes = args.includes("--yes") || args.includes("-y") || args.includes("--force");
         const dryRun = args.includes("--dry-run");
         const memoryDir = resolveRequiredValueFlag(args, "--memory-dir");
         const configOverride = resolveRequiredValueFlag(args, "--config");
         const version = resolveRequiredValueFlag(args, "--version");
         const pluginDir = resolveRequiredValueFlag(args, "--plugin-dir");
+        const legacyPluginDir = resolveRequiredValueFlag(args, "--legacy-plugin-dir");
         const restartGateway = !args.includes("--no-restart");
-        await cmdOpenclawUpgrade({
+        const opts = {
           yes,
           dryRun,
           memoryDir,
           configPath: configOverride,
           pluginDir,
           version,
-          restartGateway
-        });
+          restartGateway,
+          legacyPluginDirForBackup: legacyPluginDir
+        };
+        if (subAction === "migrate-engram") {
+          await cmdOpenclawMigrateEngram(opts);
+        } else {
+          await cmdOpenclawUpgrade(opts);
+        }
       } else {
-        console.log(`Usage: remnic openclaw <install|upgrade>
+        console.log(`Usage: remnic openclaw <install|upgrade|migrate-engram>
 
   install    Configure OpenClaw to use Remnic as the memory plugin.
   upgrade    Backup the current setup, refresh the published npm package, and re-apply the config.
+  migrate-engram
+             Migrate a legacy @joshuaswarren/openclaw-engram install to
+             @remnic/plugin-openclaw while backing up the legacy extension.
 
              Sets plugins.entries["${REMNIC_OPENCLAW_PLUGIN_ID}"] and plugins.slots.memory
              in ~/.openclaw/openclaw.json (or $OPENCLAW_CONFIG_PATH).
@@ -7564,6 +7636,8 @@ Options:
   --config <path>         Override OpenClaw config path
   --version <tag>         Upgrade @remnic/plugin-openclaw from a specific npm tag/version
   --plugin-dir <path>     Override OpenClaw extension dir (~/.openclaw/extensions/openclaw-remnic)
+  --legacy-plugin-dir <path>
+                          Override legacy extension dir backed up by migrate-engram
   --no-restart            Skip the final launchctl kickstart after upgrade`);
       }
       break;
@@ -7586,12 +7660,15 @@ Usage:
   remnic config                Show current config
   remnic openclaw install      Configure OpenClaw to use Remnic memory (sets slot + entry)
   remnic openclaw upgrade      Safe OpenClaw npm upgrade with backups and gateway restart
+  remnic openclaw migrate-engram
+    Migrate legacy @joshuaswarren/openclaw-engram installs with legacy extension backup
     --yes / -y / --force       Skip prompts
     --dry-run                  Preview changes without writing
     --memory-dir <path>        Custom memory directory
     --config <path>            Custom OpenClaw config path
     --version <tag>            Upgrade @remnic/plugin-openclaw from a specific npm tag/version
     --plugin-dir <path>        Custom OpenClaw extension directory
+    --legacy-plugin-dir <path> Custom legacy extension directory for migration backup
     --no-restart               Skip the final launchctl kickstart after upgrade
   remnic daemon <start|stop|restart|install|uninstall|status>  Manage background server
   remnic token <generate|list|revoke> [connector-id]  Manage auth tokens

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/cli",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "CLI for Remnic memory — init, query, doctor, daemon management",
   "type": "module",
   "main": "dist/index.js",
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "yaml": "^2.4.2",
-    "@remnic/core": "^1.1.5"
+    "@remnic/core": "^1.1.9"
   },
   "peerDependencies": {
     "@remnic/bench": "^1.0.0",
@@ -35,7 +35,8 @@
     "@remnic/import-claude": "^0.1.0",
     "@remnic/import-gemini": "^0.1.0",
     "@remnic/import-lossless-claw": "^0.1.1",
-    "@remnic/import-mem0": "^0.1.0"
+    "@remnic/import-mem0": "^0.1.0",
+    "@remnic/import-supermemory": "^0.1.1"
   },
   "peerDependenciesMeta": {
     "@remnic/bench": {
@@ -61,6 +62,9 @@
     },
     "@remnic/import-mem0": {
       "optional": true
+    },
+    "@remnic/import-supermemory": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -68,12 +72,13 @@
     "typescript": "^5.9.3",
     "@remnic/bench": "1.0.1",
     "@remnic/export-weclone": "1.0.1",
-    "@remnic/import-weclone": "1.0.1",
     "@remnic/import-chatgpt": "0.1.0",
-    "@remnic/import-gemini": "0.1.0",
-    "@remnic/import-lossless-claw": "0.1.1",
+    "@remnic/import-weclone": "1.0.1",
     "@remnic/import-claude": "0.1.0",
-    "@remnic/import-mem0": "0.1.0"
+    "@remnic/import-mem0": "0.1.0",
+    "@remnic/import-lossless-claw": "0.1.1",
+    "@remnic/import-supermemory": "0.1.1",
+    "@remnic/import-gemini": "0.1.0"
   },
   "license": "MIT",
   "repository": {