@remnic/server 1.0.4 → 9.3.515

package/README.md

@@ -1,8 +1,8 @@
 # @remnic/server
 
-Standalone Remnic memory server -- HTTP and MCP interfaces without requiring OpenClaw.
+Standalone Remnic memory and context server -- HTTP and MCP interfaces without requiring OpenClaw.
 
-Part of [Remnic](https://github.com/joshuaswarren/remnic), the universal memory layer for AI agents.
+Part of [Remnic](https://github.com/joshuaswarren/remnic), open-source memory and context for user-aware agents.
 
 ## Install
 
@@ -23,15 +23,28 @@ Both interfaces connect to the same [`@remnic/core`](https://www.npmjs.com/packa
 
 ## Usage
 
+Run the standalone server:
+
+```bash
+npx --package @remnic/server remnic-server --help
+npx --package @remnic/server remnic-server --port 4318
+```
+
+The package also ships the legacy `engram-server` binary for compatibility.
+The bin wrappers are source-controlled so package managers can link them during
+workspace installs; release builds verify that both targets have Node shebangs
+and can start their help command before publish.
+
 ```typescript
-import { createServer } from "@remnic/server";
+import { startServer } from "@remnic/server";
 
-const server = createServer({
+const server = await startServer({
   port: 3141,
   authToken: process.env.REMNIC_AUTH_TOKEN,
 });
 
-await server.start();
+console.log(`Remnic server listening on http://${server.host}:${server.port}`);
+await server.stop();
 ```
 
 ## License

package/bin/engram-server.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runServerBin } from "./server-bin.js";
+
+await runServerBin("engram-server");

package/bin/remnic-server.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runServerBin } from "./server-bin.js";
+
+await runServerBin("remnic-server");

package/bin/server-bin.js

@@ -0,0 +1,41 @@
+export function shouldPrintHelpWithoutCli(argv) {
+  return argv.length === 1 && (argv[0] === "--help" || argv[0] === "-h");
+}
+
+export async function runServerBin(commandName, options = {}) {
+  const argv = options.argv ?? process.argv.slice(2);
+  const help = `
+${commandName} - Standalone Remnic memory server
+
+Usage:
+  ${commandName} [options]
+
+Options:
+  --config <path>     Path to config file (default: remnic.config.json)
+  --host <addr>       Bind address (default: 127.0.0.1)
+  --port <number>     Port number (default: 4318)
+  --auth-token <tok>  Bearer token for auth (or set REMNIC_AUTH_TOKEN)
+  --help              Show this help
+
+Environment:
+  REMNIC_CONFIG_PATH   Config file path (ENGRAM_CONFIG_PATH also supported)
+  REMNIC_PORT          Server port (ENGRAM_PORT also supported)
+  REMNIC_HOST          Bind address (ENGRAM_HOST also supported)
+  REMNIC_AUTH_TOKEN    Auth bearer token (ENGRAM_AUTH_TOKEN also supported)
+  REMNIC_MEMORY_DIR    Override memory directory (ENGRAM_MEMORY_DIR also supported)
+  OPENAI_API_KEY       OpenAI API key for extraction; ignored when config sets openaiApiKey=false
+`;
+
+  if (shouldPrintHelpWithoutCli(argv)) {
+    (options.stdout ?? console.log)(help);
+    return;
+  }
+
+  const loadCliMain = options.loadCliMain ?? (() => import("../dist/index.js"));
+  const { cliMain } = await loadCliMain();
+
+  await cliMain(argv).catch((err) => {
+    (options.stderr ?? process.stderr.write.bind(process.stderr))(`Fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+    (options.exit ?? process.exit)(1);
+  });
+}

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+import { PluginConfig, EngramAccessService, EngramAccessHttpServer } from '@remnic/core';
+
+/**
+ * @remnic/server
+ *
+ * Standalone Remnic memory server.
+ *
+ * Loads config from `remnic.config.json` (or env vars), creates an Orchestrator,
+ * and starts the HTTP access server with MCP endpoint — no OpenClaw required.
+ *
+ * Usage:
+ *   npx --package @remnic/server remnic-server
+ *   npx --package @remnic/server remnic-server --config ./my-remnic.json
+ *   npx --package @remnic/server remnic-server --port 4320
+ */
+
+interface ServerConfig {
+    remnic: Record<string, unknown>;
+    server: {
+        host?: string;
+        port?: unknown;
+        authToken?: string;
+        principal?: string;
+        maxBodyBytes?: number;
+        adminConsoleEnabled?: boolean;
+        adminConsolePublicDir?: string;
+    };
+}
+interface ParsedServerConfig {
+    host: string;
+    port: number;
+    authToken?: string;
+    principal?: string;
+    maxBodyBytes?: number;
+    adminConsoleEnabled: boolean;
+    adminConsolePublicDir?: string;
+}
+declare function parseServerConfig(raw: Partial<ServerConfig["server"]>, options?: {
+    portSource?: string;
+}): ParsedServerConfig;
+declare function loadConfigFile(configPath: string): ServerConfig;
+declare function mergeRemnicConfigForServer(fileRemnic: Record<string, unknown>, envRemnic: Record<string, unknown> | undefined): Record<string, unknown>;
+interface ServerResult {
+    config: PluginConfig;
+    service: EngramAccessService;
+    httpServer: EngramAccessHttpServer;
+    host: string;
+    port: number;
+    /** Stop HTTP, cancel startup work, abort deferred init, and destroy the orchestrator. */
+    stop: () => Promise<void>;
+    /** Cancel any pending startup-sync retry timers. Called automatically on shutdown. */
+    cancelStartupSync: () => void;
+    /** Abort deferred orchestrator initialization (QMD sync, warmup, cache). */
+    abortDeferredInit: () => void;
+}
+declare function startServer(options?: {
+    configPath?: string;
+    host?: string;
+    port?: number;
+    authToken?: string;
+}): Promise<ServerResult>;
+declare function cliMain(argv?: string[]): Promise<void>;
+
+export { type ParsedServerConfig, type ServerConfig, type ServerResult, cliMain, loadConfigFile, mergeRemnicConfigForServer, parseServerConfig, startServer };

package/dist/index.js

@@ -3,14 +3,72 @@
 // src/index.ts
 import fs from "fs";
 import path from "path";
-import { parseConfig, Orchestrator, EngramAccessService, EngramAccessHttpServer, initLogger, log, getAllValidTokens, getAllValidTokensCached } from "@remnic/core";
+import { parseConfig, isOpenaiApiKeyDisabled, Orchestrator, EngramAccessService, EngramAccessHttpServer, initLogger, log, getAllValidTokens, getAllValidTokensCached, expandTildePath } from "@remnic/core";
 function readCompatEnv(primary, legacy) {
   return process.env[primary] ?? process.env[legacy];
 }
+function parseServerPort(value, source) {
+  const port = typeof value === "string" ? Number(value.trim()) : value;
+  if (typeof port !== "number" || !Number.isInteger(port) || port < 1 || port > 65535) {
+    throw new Error(`Invalid ${source}: expected an integer port from 1 to 65535`);
+  }
+  return port;
+}
+function parseOptionalString(value, source) {
+  if (value === void 0) return void 0;
+  if (typeof value !== "string") {
+    throw new Error(`Invalid ${source}: expected a string`);
+  }
+  return value;
+}
+function parseOptionalNonEmptyString(value, source) {
+  const parsed = parseOptionalString(value, source);
+  if (parsed === void 0) return void 0;
+  if (parsed.trim() === "") {
+    throw new Error(`Invalid ${source}: expected a non-empty string`);
+  }
+  return parsed;
+}
+function parseOptionalPositiveInteger(value, source) {
+  if (value === void 0) return void 0;
+  const parsed = typeof value === "string" ? Number(value.trim()) : value;
+  if (typeof parsed !== "number" || !Number.isInteger(parsed) || parsed < 1) {
+    throw new Error(`Invalid ${source}: expected a positive integer`);
+  }
+  return parsed;
+}
+function parseOptionalBoolean(value, source) {
+  if (value === void 0) return void 0;
+  if (typeof value === "boolean") return value;
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (["true", "1", "yes", "on"].includes(normalized)) return true;
+    if (["false", "0", "no", "off"].includes(normalized)) return false;
+  }
+  throw new Error(`Invalid ${source}: expected a boolean`);
+}
+function parseServerConfig(raw, options) {
+  return {
+    host: parseOptionalNonEmptyString(raw.host, "server.host") ?? "127.0.0.1",
+    port: raw.port === void 0 ? 4318 : parseServerPort(raw.port, options?.portSource ?? "server.port"),
+    authToken: parseOptionalString(raw.authToken, "server.authToken"),
+    principal: parseOptionalString(raw.principal, "server.principal"),
+    maxBodyBytes: parseOptionalPositiveInteger(raw.maxBodyBytes, "server.maxBodyBytes"),
+    adminConsoleEnabled: parseOptionalBoolean(raw.adminConsoleEnabled, "server.adminConsoleEnabled") ?? false,
+    adminConsolePublicDir: parseOptionalString(raw.adminConsolePublicDir, "server.adminConsolePublicDir")
+  };
+}
+function resolveUserPath(value) {
+  return path.resolve(expandTildePath(value));
+}
 function resolveConfigPath(cliPath) {
-  if (cliPath) return path.resolve(cliPath);
+  if (cliPath) {
+    return { path: resolveUserPath(cliPath), explicit: true, source: "--config" };
+  }
   const envPath = readCompatEnv("REMNIC_CONFIG_PATH", "ENGRAM_CONFIG_PATH");
-  if (envPath) return path.resolve(envPath);
+  if (envPath) {
+    return { path: resolveUserPath(envPath), explicit: true, source: "REMNIC_CONFIG_PATH/ENGRAM_CONFIG_PATH" };
+  }
   const homeDir = process.env.HOME ?? "~";
   const candidates = [
     path.join(process.cwd(), "remnic.config.json"),
@@ -19,24 +77,59 @@ function resolveConfigPath(cliPath) {
     path.join(homeDir, ".config", "engram", "config.json")
   ];
   for (const candidate of candidates) {
-    if (fs.existsSync(candidate)) return candidate;
+    if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {
+      return { path: candidate, explicit: false, source: "auto-discovery" };
+    }
   }
-  return path.join(homeDir, ".config", "remnic", "config.json");
+  return { path: path.join(homeDir, ".config", "remnic", "config.json"), explicit: false, source: "auto-discovery" };
+}
+function isPlainRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function requirePlainConfigBlock(raw, key, configPath) {
+  const value = raw[key];
+  if (value === void 0) return void 0;
+  if (!isPlainRecord(value)) {
+    throw new Error(`Invalid config file ${configPath}: ${key} must be a JSON object`);
+  }
+  return value;
 }
 function loadConfigFile(configPath) {
   const raw = JSON.parse(fs.readFileSync(configPath, "utf8"));
+  if (!isPlainRecord(raw)) {
+    throw new Error(`Invalid config file ${configPath}: top-level config must be a JSON object`);
+  }
+  const remnic = requirePlainConfigBlock(raw, "remnic", configPath);
+  const engram = requirePlainConfigBlock(raw, "engram", configPath);
+  const server = requirePlainConfigBlock(raw, "server", configPath);
   return {
-    remnic: raw.remnic ?? raw.engram ?? raw ?? {},
-    server: raw.server ?? {}
+    remnic: remnic ?? engram ?? raw,
+    server: server ?? {}
   };
 }
+function loadResolvedConfig(resolved) {
+  if (!fs.existsSync(resolved.path)) {
+    if (resolved.explicit) {
+      throw new Error(`Config file from ${resolved.source} not found: ${resolved.path}`);
+    }
+    return { remnic: {}, server: {} };
+  }
+  const stat = fs.statSync(resolved.path);
+  if (!stat.isFile()) {
+    if (!resolved.explicit) {
+      return { remnic: {}, server: {} };
+    }
+    throw new Error(`Config file from ${resolved.source} is not a regular file: ${resolved.path}`);
+  }
+  return loadConfigFile(resolved.path);
+}
 function envOverrides() {
   const overrides = {};
   const remnic = {};
   const port = readCompatEnv("REMNIC_PORT", "ENGRAM_PORT");
   const host = readCompatEnv("REMNIC_HOST", "ENGRAM_HOST");
   const authToken = readCompatEnv("REMNIC_AUTH_TOKEN", "ENGRAM_AUTH_TOKEN");
-  if (port) overrides.port = parseInt(port, 10);
+  if (port) overrides.port = port;
   if (host) overrides.host = host;
   if (authToken) overrides.authToken = authToken;
   if (process.env.OPENAI_API_KEY) remnic.openaiApiKey = process.env.OPENAI_API_KEY;
@@ -44,54 +137,177 @@ function envOverrides() {
   if (memoryDir) remnic.memoryDir = memoryDir;
   return { ...overrides, ...Object.keys(remnic).length > 0 ? { remnic } : {} };
 }
+function mergeRemnicConfigForServer(fileRemnic, envRemnic) {
+  const effectiveEnvRemnic = { ...envRemnic ?? {} };
+  if (isOpenaiApiKeyDisabled(fileRemnic.openaiApiKey)) {
+    delete effectiveEnvRemnic.openaiApiKey;
+  }
+  return { ...fileRemnic, ...effectiveEnvRemnic };
+}
+function abortableDelay(ms, signal) {
+  if (signal.aborted) return Promise.resolve();
+  return new Promise((resolve) => {
+    const timer = setTimeout(resolve, ms);
+    const onAbort = () => {
+      clearTimeout(timer);
+      resolve();
+    };
+    signal.addEventListener("abort", onAbort, { once: true });
+  });
+}
+async function cleanupFailedStartup(orchestrator, httpServer) {
+  try {
+    await httpServer.stop();
+  } catch (err) {
+    log.warn(`HTTP startup failure cleanup could not stop server: ${err}`);
+  }
+  try {
+    await orchestrator.destroy();
+  } catch (err) {
+    log.warn(`HTTP startup failure cleanup could not destroy orchestrator: ${err}`);
+  }
+}
 async function startServer(options) {
   initLogger();
-  const configPath = resolveConfigPath(options?.configPath);
-  const fileConfig = fs.existsSync(configPath) ? loadConfigFile(configPath) : { remnic: {}, server: {} };
+  const resolvedConfigPath = resolveConfigPath(options?.configPath);
+  const fileConfig = loadResolvedConfig(resolvedConfigPath);
   const env = envOverrides();
-  const remnicConfig = { ...fileConfig.remnic, ...env.remnic ?? {} };
+  const { remnic: envRemnic, ...envServer } = env;
+  const remnicConfig = mergeRemnicConfigForServer(fileConfig.remnic, envRemnic);
+  const cliServerConfig = {};
+  if (options?.host !== void 0) cliServerConfig.host = options.host;
+  if (options?.port !== void 0) cliServerConfig.port = parseServerPort(options.port, "options.port");
+  if (options?.authToken !== void 0) cliServerConfig.authToken = options.authToken;
   const serverConfig = {
     ...fileConfig.server,
-    ...env,
-    ...options?.host ? { host: options.host } : {},
-    ...options?.port ? { port: options.port } : {},
-    ...options?.authToken ? { authToken: options.authToken } : {}
+    ...envServer,
+    ...cliServerConfig
   };
+  const portSource = cliServerConfig.port !== void 0 ? "options.port" : envServer.port !== void 0 ? "REMNIC_PORT/ENGRAM_PORT" : "server.port";
+  const parsedServerConfig = parseServerConfig(serverConfig, { portSource });
   const config = parseConfig(remnicConfig);
   const orchestrator = new Orchestrator(config);
+  await orchestrator.initialize();
   const service = new EngramAccessService(orchestrator);
-  const authToken = serverConfig.authToken ?? readCompatEnv("REMNIC_AUTH_TOKEN", "ENGRAM_AUTH_TOKEN") ?? "";
+  const authToken = parsedServerConfig.authToken ?? readCompatEnv("REMNIC_AUTH_TOKEN", "ENGRAM_AUTH_TOKEN") ?? "";
   if (!authToken && getAllValidTokens().length === 0) {
     log.warn("No auth token set \u2014 server will reject all requests. Set REMNIC_AUTH_TOKEN, server.authToken in config, or generate tokens with 'remnic token generate'.");
   }
   const httpServer = new EngramAccessHttpServer({
     service,
-    host: serverConfig.host ?? "127.0.0.1",
-    port: serverConfig.port ?? 4318,
+    host: parsedServerConfig.host,
+    port: parsedServerConfig.port,
     authToken: authToken || void 0,
     authTokensGetter: () => getAllValidTokensCached(),
-    principal: serverConfig.principal,
-    maxBodyBytes: serverConfig.maxBodyBytes,
-    adminConsoleEnabled: serverConfig.adminConsoleEnabled ?? false,
+    principal: parsedServerConfig.principal,
+    maxBodyBytes: parsedServerConfig.maxBodyBytes,
+    adminConsoleEnabled: parsedServerConfig.adminConsoleEnabled,
+    adminConsolePublicDir: parsedServerConfig.adminConsolePublicDir ? path.resolve(expandTildePath(parsedServerConfig.adminConsolePublicDir)) : void 0,
     citationsEnabled: config.citationsEnabled,
     citationsAutoDetect: config.citationsAutoDetect
   });
-  const { host, port } = await httpServer.start();
-  return { config, service, httpServer, host, port };
+  let host;
+  let port;
+  try {
+    ({ host, port } = await httpServer.start());
+  } catch (err) {
+    await cleanupFailedStartup(orchestrator, httpServer);
+    throw err;
+  }
+  const startupSyncAbort = new AbortController();
+  const originalStop = httpServer.stop.bind(httpServer);
+  let stopPromise;
+  const stop = async () => {
+    if (stopPromise) return stopPromise;
+    stopPromise = (async () => {
+      startupSyncAbort.abort();
+      orchestrator.abortDeferredInit();
+      try {
+        await originalStop();
+      } finally {
+        await orchestrator.destroy();
+      }
+    })();
+    return stopPromise;
+  };
+  httpServer.stop = stop;
+  orchestrator.deferredReady.then(() => {
+    if (startupSyncAbort.signal.aborted) {
+      log.debug("QMD startup-sync: cancelled before deferred init completed");
+      return;
+    }
+    if (!config.qmdEnabled || orchestrator.qmd.debugStatus() === "backend=noop") {
+      log.debug("QMD startup-sync: search disabled or noop backend, skipping retries");
+      return;
+    }
+    const needsRetry = !orchestrator.qmd.isAvailable() || !orchestrator.deferredSyncSucceeded;
+    if (!needsRetry) {
+      log.debug("QMD startup-sync: deferred init completed successfully, no retries needed");
+      return;
+    }
+    const RETRY_DELAYS_MS = [5e3, 15e3, 3e4, 6e4, 12e4];
+    if (startupSyncAbort.signal.aborted) {
+      log.debug("QMD startup-sync retry: cancelled before retry task started");
+      return;
+    }
+    (async () => {
+      for (const delay of RETRY_DELAYS_MS) {
+        await abortableDelay(delay, startupSyncAbort.signal);
+        if (startupSyncAbort.signal.aborted) {
+          log.debug("QMD startup-sync retry: cancelled by shutdown");
+          return;
+        }
+        const synced = await orchestrator.startupSearchSync(startupSyncAbort.signal);
+        if (!synced) {
+          if (orchestrator.qmd.debugStatus() === "backend=noop") {
+            log.debug("QMD startup-sync retry: search intentionally disabled; stopping retries");
+            return;
+          }
+          log.debug(`QMD startup-sync retry: not available yet (next retry in ${RETRY_DELAYS_MS[RETRY_DELAYS_MS.indexOf(delay) + 1] ?? "n/a"}ms)`);
+          continue;
+        }
+        return;
+      }
+      log.warn("QMD startup-sync retry: exhausted all retries; search index may be stale");
+    })().catch((err) => {
+      log.warn(`QMD startup-sync retry: unexpected error: ${err}`);
+    });
+  }).catch((err) => {
+    log.warn(`Deferred init error: ${err}`);
+  });
+  return { config, service, httpServer, host, port, stop, cancelStartupSync: () => startupSyncAbort.abort(), abortDeferredInit: () => orchestrator.abortDeferredInit() };
 }
+var BOOLEAN_CLI_OPTIONS = /* @__PURE__ */ new Set(["help"]);
+var VALUE_CLI_OPTIONS = /* @__PURE__ */ new Set(["config", "host", "port", "auth-token"]);
 function parseCliArgs(argv) {
   const args = {};
   for (let i = 0; i < argv.length; i++) {
     const token = argv[i];
+    if (token === "-h") {
+      args.help = "true";
+      continue;
+    }
     if (token.startsWith("--")) {
-      const key = token.slice(2);
-      const next = argv[i + 1];
-      if (next && !next.startsWith("--")) {
-        args[key] = next;
-        i++;
-      } else {
+      const [key, inlineValue] = token.slice(2).split(/=(.*)/s, 2);
+      if (!key) {
+        throw new Error(`Invalid option ${token}`);
+      }
+      if (BOOLEAN_CLI_OPTIONS.has(key)) {
+        if (inlineValue !== void 0) {
+          throw new Error(`Option --${key} does not accept a value`);
+        }
         args[key] = "true";
+        continue;
+      }
+      if (!VALUE_CLI_OPTIONS.has(key)) {
+        throw new Error(`Unknown option --${key}`);
+      }
+      const value = inlineValue ?? argv[i + 1];
+      if (value === void 0 || inlineValue === void 0 && value.startsWith("--") || value.trim() === "") {
+        throw new Error(`Missing value for --${key}`);
       }
+      args[key] = value;
+      if (inlineValue === void 0) i++;
     }
   }
   return args;
@@ -118,27 +334,27 @@ Environment:
   REMNIC_HOST          Bind address (ENGRAM_HOST also supported)
   REMNIC_AUTH_TOKEN    Auth bearer token (ENGRAM_AUTH_TOKEN also supported)
   REMNIC_MEMORY_DIR    Override memory directory (ENGRAM_MEMORY_DIR also supported)
-  OPENAI_API_KEY       OpenAI API key for extraction
+  OPENAI_API_KEY       OpenAI API key for extraction; ignored when config sets openaiApiKey=false
 `);
     process.exit(0);
   }
   const result = await startServer({
     configPath: args.config,
     host: args.host,
-    port: args.port ? parseInt(args.port, 10) : void 0,
+    port: args.port === void 0 ? void 0 : parseServerPort(args.port, "--port"),
     authToken: args["auth-token"]
   });
   console.log(`Remnic server listening on http://${result.host}:${result.port}`);
   const shutdown = async (signal) => {
     console.log(`
 Received ${signal}, shutting down...`);
-    await result.httpServer.stop();
+    await result.stop();
     process.exit(0);
   };
   process.on("SIGINT", () => shutdown("SIGINT"));
   process.on("SIGTERM", () => shutdown("SIGTERM"));
 }
-if (process.argv[1] && (/remnic-server[\\/](?:dist|src)[\\/]index\.[jt]s$/.test(process.argv[1]) || /engram-server[\\/](?:dist|src)[\\/]index\.[jt]s$/.test(process.argv[1]) || process.argv[1].endsWith("remnic-server") || process.argv[1].endsWith("engram-server"))) {
+if (process.argv[1] && /(?:remnic-server|engram-server)[\\/](?:dist|src)[\\/]index\.[jt]s$/.test(process.argv[1])) {
   cliMain().catch((err) => {
     process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
 `);
@@ -147,6 +363,9 @@ if (process.argv[1] && (/remnic-server[\\/](?:dist|src)[\\/]index\.[jt]s$/.test(
 }
 export {
   cliMain,
+  loadConfigFile,
+  mergeRemnicConfigForServer,
+  parseServerConfig,
   startServer
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @remnic/server\n *\n * Standalone Remnic memory server.\n *\n * Loads config from `remnic.config.json` (or env vars), creates an Orchestrator,\n * and starts the HTTP access server with MCP endpoint — no OpenClaw required.\n *\n * Usage:\n *   npx remnic-server\n *   npx remnic-server --config ./my-remnic.json\n *   npx remnic-server --port 4320\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { parseConfig, Orchestrator, EngramAccessService, EngramAccessHttpServer, initLogger, log, getAllValidTokens, getAllValidTokensCached, type PluginConfig } from \"@remnic/core\";\n\n// ── Config loading ──────────────────────────────────────────────────────────\n\nexport interface ServerConfig {\n  remnic: Record<string, unknown>;\n  server: {\n    host?: string;\n    port?: number;\n    authToken?: string;\n    principal?: string;\n    maxBodyBytes?: number;\n    adminConsoleEnabled?: boolean;\n  };\n}\n\nfunction readCompatEnv(primary: string, legacy: string): string | undefined {\n  return process.env[primary] ?? process.env[legacy];\n}\n\nfunction resolveConfigPath(cliPath?: string): string {\n  if (cliPath) return path.resolve(cliPath);\n\n  const envPath = readCompatEnv(\"REMNIC_CONFIG_PATH\", \"ENGRAM_CONFIG_PATH\");\n  if (envPath) return path.resolve(envPath);\n\n  const homeDir = process.env.HOME ?? \"~\";\n  const candidates = [\n    path.join(process.cwd(), \"remnic.config.json\"),\n    path.join(process.cwd(), \"engram.config.json\"),\n    path.join(homeDir, \".config\", \"remnic\", \"config.json\"),\n    path.join(homeDir, \".config\", \"engram\", \"config.json\"),\n  ];\n  for (const candidate of candidates) {\n    if (fs.existsSync(candidate)) return candidate;\n  }\n\n  return path.join(homeDir, \".config\", \"remnic\", \"config.json\");\n}\n\nfunction loadConfigFile(configPath: string): ServerConfig {\n  const raw = JSON.parse(fs.readFileSync(configPath, \"utf8\"));\n  return {\n    remnic: raw.remnic ?? raw.engram ?? raw ?? {},\n    server: raw.server ?? {},\n  };\n}\n\nfunction envOverrides(): Partial<ServerConfig[\"server\"]> & { remnic?: Record<string, unknown> } {\n  const overrides: Record<string, unknown> = {};\n  const remnic: Record<string, unknown> = {};\n\n  const port = readCompatEnv(\"REMNIC_PORT\", \"ENGRAM_PORT\");\n  const host = readCompatEnv(\"REMNIC_HOST\", \"ENGRAM_HOST\");\n  const authToken = readCompatEnv(\"REMNIC_AUTH_TOKEN\", \"ENGRAM_AUTH_TOKEN\");\n  if (port) overrides.port = parseInt(port, 10);\n  if (host) overrides.host = host;\n  if (authToken) overrides.authToken = authToken;\n\n  if (process.env.OPENAI_API_KEY) remnic.openaiApiKey = process.env.OPENAI_API_KEY;\n  const memoryDir = readCompatEnv(\"REMNIC_MEMORY_DIR\", \"ENGRAM_MEMORY_DIR\");\n  if (memoryDir) remnic.memoryDir = memoryDir;\n\n  return { ...overrides, ...(Object.keys(remnic).length > 0 ? { remnic } : {}) };\n}\n\n// ── Server startup ──────────────────────────────────────────────────────────\n\nexport interface ServerResult {\n  config: PluginConfig;\n  service: EngramAccessService;\n  httpServer: EngramAccessHttpServer;\n  host: string;\n  port: number;\n}\n\nexport async function startServer(options?: {\n  configPath?: string;\n  host?: string;\n  port?: number;\n  authToken?: string;\n}): Promise<ServerResult> {\n  initLogger();\n\n  const configPath = resolveConfigPath(options?.configPath);\n  const fileConfig = fs.existsSync(configPath)\n    ? loadConfigFile(configPath)\n    : { remnic: {}, server: {} };\n\n  const env = envOverrides();\n\n  // Merge: file < env < cli flags\n  const remnicConfig = { ...fileConfig.remnic, ...(env.remnic ?? {}) };\n  const serverConfig = {\n    ...fileConfig.server,\n    ...env,\n    ...(options?.host ? { host: options.host } : {}),\n    ...(options?.port ? { port: options.port } : {}),\n    ...(options?.authToken ? { authToken: options.authToken } : {}),\n  };\n\n  const config = parseConfig(remnicConfig);\n  const orchestrator = new Orchestrator(config);\n  const service = new EngramAccessService(orchestrator);\n\n  const authToken = serverConfig.authToken ?? readCompatEnv(\"REMNIC_AUTH_TOKEN\", \"ENGRAM_AUTH_TOKEN\") ?? \"\";\n\n  // Connector tokens are loaded dynamically per request via authTokensGetter\n  // so that token generate/revoke takes effect without server restart\n  if (!authToken && getAllValidTokens().length === 0) {\n    log.warn(\"No auth token set — server will reject all requests. Set REMNIC_AUTH_TOKEN, server.authToken in config, or generate tokens with 'remnic token generate'.\");\n  }\n\n  const httpServer = new EngramAccessHttpServer({\n    service,\n    host: serverConfig.host ?? \"127.0.0.1\",\n    port: serverConfig.port ?? 4318,\n    authToken: authToken || undefined,\n    authTokensGetter: () => getAllValidTokensCached(),\n    principal: serverConfig.principal,\n    maxBodyBytes: serverConfig.maxBodyBytes,\n    adminConsoleEnabled: serverConfig.adminConsoleEnabled ?? false,\n    citationsEnabled: config.citationsEnabled,\n    citationsAutoDetect: config.citationsAutoDetect,\n  });\n\n  const { host, port } = await httpServer.start();\n\n  return { config, service, httpServer, host, port };\n}\n\n// ── CLI entry point ──────────────────────────────────────────────────────────\n\nfunction parseCliArgs(argv: string[]): Record<string, string | undefined> {\n  const args: Record<string, string | undefined> = {};\n  for (let i = 0; i < argv.length; i++) {\n    const token = argv[i];\n    if (token.startsWith(\"--\")) {\n      const key = token.slice(2);\n      const next = argv[i + 1];\n      if (next && !next.startsWith(\"--\")) {\n        args[key] = next;\n        i++;\n      } else {\n        args[key] = \"true\";\n      }\n    }\n  }\n  return args;\n}\n\nexport async function cliMain(argv: string[] = process.argv.slice(2)): Promise<void> {\n  const args = parseCliArgs(argv);\n\n  if (args.help) {\n    console.log(`\nremnic-server — Standalone Remnic memory server\n\nUsage:\n  remnic-server [options]\n\nOptions:\n  --config <path>     Path to config file (default: remnic.config.json)\n  --host <addr>       Bind address (default: 127.0.0.1)\n  --port <number>     Port number (default: 4318)\n  --auth-token <tok>  Bearer token for auth (or set REMNIC_AUTH_TOKEN)\n  --help              Show this help\n\nEnvironment:\n  REMNIC_CONFIG_PATH   Config file path (ENGRAM_CONFIG_PATH also supported)\n  REMNIC_PORT          Server port (ENGRAM_PORT also supported)\n  REMNIC_HOST          Bind address (ENGRAM_HOST also supported)\n  REMNIC_AUTH_TOKEN    Auth bearer token (ENGRAM_AUTH_TOKEN also supported)\n  REMNIC_MEMORY_DIR    Override memory directory (ENGRAM_MEMORY_DIR also supported)\n  OPENAI_API_KEY       OpenAI API key for extraction\n`);\n    process.exit(0);\n  }\n\n  const result = await startServer({\n    configPath: args.config,\n    host: args.host,\n    port: args.port ? parseInt(args.port, 10) : undefined,\n    authToken: args[\"auth-token\"],\n  });\n\n  console.log(`Remnic server listening on http://${result.host}:${result.port}`);\n\n  // Graceful shutdown\n  const shutdown = async (signal: string) => {\n    console.log(`\\nReceived ${signal}, shutting down...`);\n    await result.httpServer.stop();\n    process.exit(0);\n  };\n\n  process.on(\"SIGINT\", () => shutdown(\"SIGINT\"));\n  process.on(\"SIGTERM\", () => shutdown(\"SIGTERM\"));\n}\n\n// Auto-run when executed directly\n// Matches: `node .../remnic-server/dist/index.js`, `node .../remnic-server/src/index.ts`,\n// `npx remnic-server`, `npx engram-server`, but NOT test files under those directories\nif (\n  process.argv[1] &&\n  (/remnic-server[\\\\/](?:dist|src)[\\\\/]index\\.[jt]s$/.test(process.argv[1]) ||\n   /engram-server[\\\\/](?:dist|src)[\\\\/]index\\.[jt]s$/.test(process.argv[1]) ||\n   process.argv[1].endsWith(\"remnic-server\") ||\n   process.argv[1].endsWith(\"engram-server\"))\n) {\n  cliMain().catch((err) => {\n    process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}\\n`);\n    process.exit(1);\n  });\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @remnic/server\n *\n * Standalone Remnic memory server.\n *\n * Loads config from `remnic.config.json` (or env vars), creates an Orchestrator,\n * and starts the HTTP access server with MCP endpoint — no OpenClaw required.\n *\n * Usage:\n *   npx --package @remnic/server remnic-server\n *   npx --package @remnic/server remnic-server --config ./my-remnic.json\n *   npx --package @remnic/server remnic-server --port 4320\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { parseConfig, isOpenaiApiKeyDisabled, Orchestrator, EngramAccessService, EngramAccessHttpServer, initLogger, log, getAllValidTokens, getAllValidTokensCached, expandTildePath, type PluginConfig } from \"@remnic/core\";\n\n// ── Config loading ──────────────────────────────────────────────────────────\n\nexport interface ServerConfig {\n  remnic: Record<string, unknown>;\n  server: {\n    host?: string;\n    port?: unknown;\n    authToken?: string;\n    principal?: string;\n    maxBodyBytes?: number;\n    adminConsoleEnabled?: boolean;\n    adminConsolePublicDir?: string;\n  };\n}\n\nfunction readCompatEnv(primary: string, legacy: string): string | undefined {\n  return process.env[primary] ?? process.env[legacy];\n}\n\nfunction parseServerPort(value: unknown, source: string): number {\n  const port = typeof value === \"string\" ? Number(value.trim()) : value;\n  if (\n    typeof port !== \"number\" ||\n    !Number.isInteger(port) ||\n    port < 1 ||\n    port > 65535\n  ) {\n    throw new Error(`Invalid ${source}: expected an integer port from 1 to 65535`);\n  }\n  return port;\n}\n\nfunction parseOptionalString(value: unknown, source: string): string | undefined {\n  if (value === undefined) return undefined;\n  if (typeof value !== \"string\") {\n    throw new Error(`Invalid ${source}: expected a string`);\n  }\n  return value;\n}\n\nfunction parseOptionalNonEmptyString(value: unknown, source: string): string | undefined {\n  const parsed = parseOptionalString(value, source);\n  if (parsed === undefined) return undefined;\n  if (parsed.trim() === \"\") {\n    throw new Error(`Invalid ${source}: expected a non-empty string`);\n  }\n  return parsed;\n}\n\nfunction parseOptionalPositiveInteger(value: unknown, source: string): number | undefined {\n  if (value === undefined) return undefined;\n  const parsed = typeof value === \"string\" ? Number(value.trim()) : value;\n  if (\n    typeof parsed !== \"number\" ||\n    !Number.isInteger(parsed) ||\n    parsed < 1\n  ) {\n    throw new Error(`Invalid ${source}: expected a positive integer`);\n  }\n  return parsed;\n}\n\nfunction parseOptionalBoolean(value: unknown, source: string): boolean | undefined {\n  if (value === undefined) return undefined;\n  if (typeof value === \"boolean\") return value;\n  if (typeof value === \"string\") {\n    const normalized = value.trim().toLowerCase();\n    if ([\"true\", \"1\", \"yes\", \"on\"].includes(normalized)) return true;\n    if ([\"false\", \"0\", \"no\", \"off\"].includes(normalized)) return false;\n  }\n  throw new Error(`Invalid ${source}: expected a boolean`);\n}\n\nexport interface ParsedServerConfig {\n  host: string;\n  port: number;\n  authToken?: string;\n  principal?: string;\n  maxBodyBytes?: number;\n  adminConsoleEnabled: boolean;\n  adminConsolePublicDir?: string;\n}\n\nexport function parseServerConfig(\n  raw: Partial<ServerConfig[\"server\"]>,\n  options?: { portSource?: string },\n): ParsedServerConfig {\n  return {\n    host: parseOptionalNonEmptyString(raw.host, \"server.host\") ?? \"127.0.0.1\",\n    port: raw.port === undefined\n      ? 4318\n      : parseServerPort(raw.port, options?.portSource ?? \"server.port\"),\n    authToken: parseOptionalString(raw.authToken, \"server.authToken\"),\n    principal: parseOptionalString(raw.principal, \"server.principal\"),\n    maxBodyBytes: parseOptionalPositiveInteger(raw.maxBodyBytes, \"server.maxBodyBytes\"),\n    adminConsoleEnabled: parseOptionalBoolean(raw.adminConsoleEnabled, \"server.adminConsoleEnabled\") ?? false,\n    adminConsolePublicDir: parseOptionalString(raw.adminConsolePublicDir, \"server.adminConsolePublicDir\"),\n  };\n}\n\ninterface ResolvedConfigPath {\n  path: string;\n  explicit: boolean;\n  source: string;\n}\n\nfunction resolveUserPath(value: string): string {\n  return path.resolve(expandTildePath(value));\n}\n\nfunction resolveConfigPath(cliPath?: string): ResolvedConfigPath {\n  if (cliPath) {\n    return { path: resolveUserPath(cliPath), explicit: true, source: \"--config\" };\n  }\n\n  const envPath = readCompatEnv(\"REMNIC_CONFIG_PATH\", \"ENGRAM_CONFIG_PATH\");\n  if (envPath) {\n    return { path: resolveUserPath(envPath), explicit: true, source: \"REMNIC_CONFIG_PATH/ENGRAM_CONFIG_PATH\" };\n  }\n\n  const homeDir = process.env.HOME ?? \"~\";\n  const candidates = [\n    path.join(process.cwd(), \"remnic.config.json\"),\n    path.join(process.cwd(), \"engram.config.json\"),\n    path.join(homeDir, \".config\", \"remnic\", \"config.json\"),\n    path.join(homeDir, \".config\", \"engram\", \"config.json\"),\n  ];\n  for (const candidate of candidates) {\n    if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {\n      return { path: candidate, explicit: false, source: \"auto-discovery\" };\n    }\n  }\n\n  return { path: path.join(homeDir, \".config\", \"remnic\", \"config.json\"), explicit: false, source: \"auto-discovery\" };\n}\n\nfunction isPlainRecord(value: unknown): value is Record<string, unknown> {\n  return !!value && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction requirePlainConfigBlock(\n  raw: Record<string, unknown>,\n  key: \"remnic\" | \"engram\" | \"server\",\n  configPath: string,\n): Record<string, unknown> | undefined {\n  const value = raw[key];\n  if (value === undefined) return undefined;\n  if (!isPlainRecord(value)) {\n    throw new Error(`Invalid config file ${configPath}: ${key} must be a JSON object`);\n  }\n  return value;\n}\n\nexport function loadConfigFile(configPath: string): ServerConfig {\n  const raw = JSON.parse(fs.readFileSync(configPath, \"utf8\"));\n  if (!isPlainRecord(raw)) {\n    throw new Error(`Invalid config file ${configPath}: top-level config must be a JSON object`);\n  }\n  const remnic = requirePlainConfigBlock(raw, \"remnic\", configPath);\n  const engram = requirePlainConfigBlock(raw, \"engram\", configPath);\n  const server = requirePlainConfigBlock(raw, \"server\", configPath);\n  return {\n    remnic: remnic ?? engram ?? raw,\n    server: server ?? {},\n  };\n}\n\nfunction loadResolvedConfig(resolved: ResolvedConfigPath): ServerConfig {\n  if (!fs.existsSync(resolved.path)) {\n    if (resolved.explicit) {\n      throw new Error(`Config file from ${resolved.source} not found: ${resolved.path}`);\n    }\n    return { remnic: {}, server: {} };\n  }\n\n  const stat = fs.statSync(resolved.path);\n  if (!stat.isFile()) {\n    if (!resolved.explicit) {\n      return { remnic: {}, server: {} };\n    }\n    throw new Error(`Config file from ${resolved.source} is not a regular file: ${resolved.path}`);\n  }\n\n  return loadConfigFile(resolved.path);\n}\n\nfunction envOverrides(): Partial<ServerConfig[\"server\"]> & { remnic?: Record<string, unknown> } {\n  const overrides: Record<string, unknown> = {};\n  const remnic: Record<string, unknown> = {};\n\n  const port = readCompatEnv(\"REMNIC_PORT\", \"ENGRAM_PORT\");\n  const host = readCompatEnv(\"REMNIC_HOST\", \"ENGRAM_HOST\");\n  const authToken = readCompatEnv(\"REMNIC_AUTH_TOKEN\", \"ENGRAM_AUTH_TOKEN\");\n  if (port) overrides.port = port;\n  if (host) overrides.host = host;\n  if (authToken) overrides.authToken = authToken;\n\n  if (process.env.OPENAI_API_KEY) remnic.openaiApiKey = process.env.OPENAI_API_KEY;\n  const memoryDir = readCompatEnv(\"REMNIC_MEMORY_DIR\", \"ENGRAM_MEMORY_DIR\");\n  if (memoryDir) remnic.memoryDir = memoryDir;\n\n  return { ...overrides, ...(Object.keys(remnic).length > 0 ? { remnic } : {}) };\n}\n\nexport function mergeRemnicConfigForServer(\n  fileRemnic: Record<string, unknown>,\n  envRemnic: Record<string, unknown> | undefined,\n): Record<string, unknown> {\n  const effectiveEnvRemnic = { ...(envRemnic ?? {}) };\n  if (isOpenaiApiKeyDisabled(fileRemnic.openaiApiKey)) {\n    // A local/gateway-only deployment can explicitly disable the direct\n    // OpenAI client. Preserve that opt-out even when the process has a\n    // global OPENAI_API_KEY for unrelated tools.\n    delete effectiveEnvRemnic.openaiApiKey;\n  }\n  return { ...fileRemnic, ...effectiveEnvRemnic };\n}\n\n// ── Helpers ─────────────────────────────────────────────────────────────────\n\n/**\n * Like `setTimeout` wrapped in a Promise, but respects an `AbortSignal`.\n * Resolves immediately (without throwing) when the signal fires so the\n * caller can check `signal.aborted` and exit cleanly.\n */\nfunction abortableDelay(ms: number, signal: AbortSignal): Promise<void> {\n  if (signal.aborted) return Promise.resolve();\n  return new Promise<void>((resolve) => {\n    const timer = setTimeout(resolve, ms);\n    const onAbort = () => {\n      clearTimeout(timer);\n      resolve();\n    };\n    signal.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n\nasync function cleanupFailedStartup(\n  orchestrator: Orchestrator,\n  httpServer: EngramAccessHttpServer,\n): Promise<void> {\n  try {\n    await httpServer.stop();\n  } catch (err) {\n    log.warn(`HTTP startup failure cleanup could not stop server: ${err}`);\n  }\n\n  try {\n    await orchestrator.destroy();\n  } catch (err) {\n    log.warn(`HTTP startup failure cleanup could not destroy orchestrator: ${err}`);\n  }\n}\n\n// ── Server startup ──────────────────────────────────────────────────────────\n\nexport interface ServerResult {\n  config: PluginConfig;\n  service: EngramAccessService;\n  httpServer: EngramAccessHttpServer;\n  host: string;\n  port: number;\n  /** Stop HTTP, cancel startup work, abort deferred init, and destroy the orchestrator. */\n  stop: () => Promise<void>;\n  /** Cancel any pending startup-sync retry timers. Called automatically on shutdown. */\n  cancelStartupSync: () => void;\n  /** Abort deferred orchestrator initialization (QMD sync, warmup, cache). */\n  abortDeferredInit: () => void;\n}\n\nexport async function startServer(options?: {\n  configPath?: string;\n  host?: string;\n  port?: number;\n  authToken?: string;\n}): Promise<ServerResult> {\n  initLogger();\n\n  const resolvedConfigPath = resolveConfigPath(options?.configPath);\n  const fileConfig = loadResolvedConfig(resolvedConfigPath);\n\n  const env = envOverrides();\n  const { remnic: envRemnic, ...envServer } = env;\n\n  // Merge: file < env < cli flags\n  const remnicConfig = mergeRemnicConfigForServer(fileConfig.remnic, envRemnic);\n  const cliServerConfig: Partial<ServerConfig[\"server\"]> = {};\n  if (options?.host !== undefined) cliServerConfig.host = options.host;\n  if (options?.port !== undefined) cliServerConfig.port = parseServerPort(options.port, \"options.port\");\n  if (options?.authToken !== undefined) cliServerConfig.authToken = options.authToken;\n\n  const serverConfig = {\n    ...fileConfig.server,\n    ...envServer,\n    ...cliServerConfig,\n  };\n  const portSource = cliServerConfig.port !== undefined\n    ? \"options.port\"\n    : envServer.port !== undefined\n      ? \"REMNIC_PORT/ENGRAM_PORT\"\n      : \"server.port\";\n  const parsedServerConfig = parseServerConfig(serverConfig, { portSource });\n\n  const config = parseConfig(remnicConfig);\n  const orchestrator = new Orchestrator(config);\n  await orchestrator.initialize();\n\n  // Start the HTTP server immediately so health checks, MCP handshakes,\n  // and liveness probes can connect while deferred init is still running.\n  const service = new EngramAccessService(orchestrator);\n\n  const authToken = parsedServerConfig.authToken ?? readCompatEnv(\"REMNIC_AUTH_TOKEN\", \"ENGRAM_AUTH_TOKEN\") ?? \"\";\n\n  // Connector tokens are loaded dynamically per request via authTokensGetter\n  // so that token generate/revoke takes effect without server restart\n  if (!authToken && getAllValidTokens().length === 0) {\n    log.warn(\"No auth token set — server will reject all requests. Set REMNIC_AUTH_TOKEN, server.authToken in config, or generate tokens with 'remnic token generate'.\");\n  }\n\n  const httpServer = new EngramAccessHttpServer({\n    service,\n    host: parsedServerConfig.host,\n    port: parsedServerConfig.port,\n    authToken: authToken || undefined,\n    authTokensGetter: () => getAllValidTokensCached(),\n    principal: parsedServerConfig.principal,\n    maxBodyBytes: parsedServerConfig.maxBodyBytes,\n    adminConsoleEnabled: parsedServerConfig.adminConsoleEnabled,\n    adminConsolePublicDir: parsedServerConfig.adminConsolePublicDir\n      ? path.resolve(expandTildePath(parsedServerConfig.adminConsolePublicDir))\n      : undefined,\n    citationsEnabled: config.citationsEnabled,\n    citationsAutoDetect: config.citationsAutoDetect,\n  });\n\n  let host: string;\n  let port: number;\n  try {\n    ({ host, port } = await httpServer.start());\n  } catch (err) {\n    await cleanupFailedStartup(orchestrator, httpServer);\n    throw err;\n  }\n\n  // Fire-and-forget: wait for deferred init (QMD probe, collection setup,\n  // warmup) then check QMD availability and retry if needed. This does NOT\n  // block the server listener — connections are accepted immediately above.\n  // An AbortController allows the shutdown handler to cancel pending retries.\n  const startupSyncAbort = new AbortController();\n\n  // Wrap httpServer.stop() so that existing callers also get full lifecycle\n  // cleanup: retry timers, deferred init, HTTP listener, and orchestrator.\n  const originalStop = httpServer.stop.bind(httpServer);\n  let stopPromise: Promise<void> | undefined;\n  const stop = async (): Promise<void> => {\n    if (stopPromise) return stopPromise;\n    stopPromise = (async () => {\n      startupSyncAbort.abort();\n      orchestrator.abortDeferredInit();\n      try {\n        await originalStop();\n      } finally {\n        await orchestrator.destroy();\n      }\n    })();\n    return stopPromise;\n  };\n  httpServer.stop = stop;\n\n  orchestrator.deferredReady.then(() => {\n    if (startupSyncAbort.signal.aborted) {\n      log.debug(\"QMD startup-sync: cancelled before deferred init completed\");\n      return;\n    }\n\n    // Skip retries when search is explicitly disabled via config or when the\n    // orchestrator already resolved to a noop backend (e.g. missing collection\n    // detected during deferredInitialize). Both cases mean no sync should ever\n    // run; scheduling retries would create misleading operational noise and\n    // unnecessary background work on every server start.\n    if (!config.qmdEnabled || orchestrator.qmd.debugStatus() === \"backend=noop\") {\n      log.debug(\"QMD startup-sync: search disabled or noop backend, skipping retries\");\n      return;\n    }\n\n    // Retry when either: (a) QMD is not available yet (cold-start race), or\n    // (b) QMD is available but the deferred init sync step failed silently\n    // (e.g., update errors swallowed by backend, throttle skip, transient\n    // network failure). Without (b), the daemon permanently serves stale\n    // recall after a failed sync despite healthy QMD probe.\n    const needsRetry = !orchestrator.qmd.isAvailable() || !orchestrator.deferredSyncSucceeded;\n    if (!needsRetry) {\n      log.debug(\"QMD startup-sync: deferred init completed successfully, no retries needed\");\n      return;\n    }\n\n    const RETRY_DELAYS_MS = [5_000, 15_000, 30_000, 60_000, 120_000];\n    if (startupSyncAbort.signal.aborted) {\n      log.debug(\"QMD startup-sync retry: cancelled before retry task started\");\n      return;\n    }\n    (async () => {\n      for (const delay of RETRY_DELAYS_MS) {\n        await abortableDelay(delay, startupSyncAbort.signal);\n\n        if (startupSyncAbort.signal.aborted) {\n          log.debug(\"QMD startup-sync retry: cancelled by shutdown\");\n          return;\n        }\n\n        const synced = await orchestrator.startupSearchSync(startupSyncAbort.signal);\n        if (!synced) {\n          if (orchestrator.qmd.debugStatus() === \"backend=noop\") {\n            log.debug(\"QMD startup-sync retry: search intentionally disabled; stopping retries\");\n            return;\n          }\n          log.debug(`QMD startup-sync retry: not available yet (next retry in ${RETRY_DELAYS_MS[RETRY_DELAYS_MS.indexOf(delay) + 1] ?? \"n/a\"}ms)`);\n          continue;\n        }\n\n        return; // sync succeeded, stop retrying\n      }\n\n      log.warn(\"QMD startup-sync retry: exhausted all retries; search index may be stale\");\n    })().catch((err: unknown) => {\n      log.warn(`QMD startup-sync retry: unexpected error: ${err}`);\n    });\n  }).catch((err: unknown) => {\n    log.warn(`Deferred init error: ${err}`);\n  });\n\n  return { config, service, httpServer, host, port, stop, cancelStartupSync: () => startupSyncAbort.abort(), abortDeferredInit: () => orchestrator.abortDeferredInit() };\n}\n\n// ── CLI entry point ──────────────────────────────────────────────────────────\n\nconst BOOLEAN_CLI_OPTIONS = new Set([\"help\"]);\nconst VALUE_CLI_OPTIONS = new Set([\"config\", \"host\", \"port\", \"auth-token\"]);\n\nfunction parseCliArgs(argv: string[]): Record<string, string | undefined> {\n  const args: Record<string, string | undefined> = {};\n  for (let i = 0; i < argv.length; i++) {\n    const token = argv[i];\n    if (token === \"-h\") {\n      args.help = \"true\";\n      continue;\n    }\n\n    if (token.startsWith(\"--\")) {\n      const [key, inlineValue] = token.slice(2).split(/=(.*)/s, 2);\n      if (!key) {\n        throw new Error(`Invalid option ${token}`);\n      }\n\n      if (BOOLEAN_CLI_OPTIONS.has(key)) {\n        if (inlineValue !== undefined) {\n          throw new Error(`Option --${key} does not accept a value`);\n        }\n        args[key] = \"true\";\n        continue;\n      }\n\n      if (!VALUE_CLI_OPTIONS.has(key)) {\n        throw new Error(`Unknown option --${key}`);\n      }\n\n      const value = inlineValue ?? argv[i + 1];\n      if (\n        value === undefined ||\n        (inlineValue === undefined && value.startsWith(\"--\")) ||\n        value.trim() === \"\"\n      ) {\n        throw new Error(`Missing value for --${key}`);\n      }\n\n      args[key] = value;\n      if (inlineValue === undefined) i++;\n    }\n  }\n  return args;\n}\n\nexport async function cliMain(argv: string[] = process.argv.slice(2)): Promise<void> {\n  const args = parseCliArgs(argv);\n\n  if (args.help) {\n    console.log(`\nremnic-server — Standalone Remnic memory server\n\nUsage:\n  remnic-server [options]\n\nOptions:\n  --config <path>     Path to config file (default: remnic.config.json)\n  --host <addr>       Bind address (default: 127.0.0.1)\n  --port <number>     Port number (default: 4318)\n  --auth-token <tok>  Bearer token for auth (or set REMNIC_AUTH_TOKEN)\n  --help              Show this help\n\nEnvironment:\n  REMNIC_CONFIG_PATH   Config file path (ENGRAM_CONFIG_PATH also supported)\n  REMNIC_PORT          Server port (ENGRAM_PORT also supported)\n  REMNIC_HOST          Bind address (ENGRAM_HOST also supported)\n  REMNIC_AUTH_TOKEN    Auth bearer token (ENGRAM_AUTH_TOKEN also supported)\n  REMNIC_MEMORY_DIR    Override memory directory (ENGRAM_MEMORY_DIR also supported)\n  OPENAI_API_KEY       OpenAI API key for extraction; ignored when config sets openaiApiKey=false\n`);\n    process.exit(0);\n  }\n\n  const result = await startServer({\n    configPath: args.config,\n    host: args.host,\n    port: args.port === undefined ? undefined : parseServerPort(args.port, \"--port\"),\n    authToken: args[\"auth-token\"],\n  });\n\n  console.log(`Remnic server listening on http://${result.host}:${result.port}`);\n\n  // Graceful shutdown\n  const shutdown = async (signal: string) => {\n    console.log(`\\nReceived ${signal}, shutting down...`);\n    await result.stop();\n    process.exit(0);\n  };\n\n  process.on(\"SIGINT\", () => shutdown(\"SIGINT\"));\n  process.on(\"SIGTERM\", () => shutdown(\"SIGTERM\"));\n}\n\n// Auto-run when executed directly\n// Matches direct execution of `node .../remnic-server/dist/index.js` or\n// `node .../remnic-server/src/index.ts`. Package command names are handled by\n// the bin wrappers in ../bin so importing this module cannot start twice.\nif (\n  process.argv[1] &&\n  /(?:remnic-server|engram-server)[\\\\/](?:dist|src)[\\\\/]index\\.[jt]s$/.test(process.argv[1])\n) {\n  cliMain().catch((err) => {\n    process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}\\n`);\n    process.exit(1);\n  });\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,19 +1,22 @@
 {
   "name": "@remnic/server",
-  "version": "1.0.4",
+  "version": "9.3.515",
   "description": "Standalone Remnic memory server — HTTP + MCP without OpenClaw",
   "type": "module",
   "main": "dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
   },
   "bin": {
-    "remnic-server": "./dist/bin/remnic-server.js",
-    "engram-server": "./dist/bin/engram-server.js"
+    "remnic-server": "./bin/remnic-server.js",
+    "engram-server": "./bin/engram-server.js"
   },
   "files": [
+    "bin/*.js",
     "dist"
   ],
   "publishConfig": {
@@ -21,11 +24,12 @@
     "provenance": true
   },
   "dependencies": {
-    "@remnic/core": "^1.0.2"
+    "@remnic/core": "^9.3.515"
   },
   "devDependencies": {
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "@remnic/core": "^9.3.515"
   },
   "license": "MIT",
   "repository": {
@@ -34,7 +38,9 @@
     "directory": "packages/remnic-server"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format esm --target es2022 --platform node --outDir dist && tsup bin/remnic-server.ts bin/engram-server.ts --format esm --target es2022 --platform node --outDir dist/bin",
+    "build": "npm run check-types && tsup src/index.ts --format esm --target es2022 --platform node --outDir dist --dts && node scripts/verify-bin.mjs",
+    "verify:bin": "node scripts/verify-bin.mjs",
+    "precheck-types": "node ../../scripts/ensure-bench-build-deps.mjs",
     "check-types": "tsc --noEmit"
   }
 }

package/dist/bin/chunk-MKNXEH3P.js

@@ -1,152 +0,0 @@
-// openclaw-engram: Local-first memory plugin
-
-// src/index.ts
-import fs from "fs";
-import path from "path";
-import { parseConfig, Orchestrator, EngramAccessService, EngramAccessHttpServer, initLogger, log, getAllValidTokens, getAllValidTokensCached } from "@remnic/core";
-function readCompatEnv(primary, legacy) {
-  return process.env[primary] ?? process.env[legacy];
-}
-function resolveConfigPath(cliPath) {
-  if (cliPath) return path.resolve(cliPath);
-  const envPath = readCompatEnv("REMNIC_CONFIG_PATH", "ENGRAM_CONFIG_PATH");
-  if (envPath) return path.resolve(envPath);
-  const homeDir = process.env.HOME ?? "~";
-  const candidates = [
-    path.join(process.cwd(), "remnic.config.json"),
-    path.join(process.cwd(), "engram.config.json"),
-    path.join(homeDir, ".config", "remnic", "config.json"),
-    path.join(homeDir, ".config", "engram", "config.json")
-  ];
-  for (const candidate of candidates) {
-    if (fs.existsSync(candidate)) return candidate;
-  }
-  return path.join(homeDir, ".config", "remnic", "config.json");
-}
-function loadConfigFile(configPath) {
-  const raw = JSON.parse(fs.readFileSync(configPath, "utf8"));
-  return {
-    remnic: raw.remnic ?? raw.engram ?? raw ?? {},
-    server: raw.server ?? {}
-  };
-}
-function envOverrides() {
-  const overrides = {};
-  const remnic = {};
-  const port = readCompatEnv("REMNIC_PORT", "ENGRAM_PORT");
-  const host = readCompatEnv("REMNIC_HOST", "ENGRAM_HOST");
-  const authToken = readCompatEnv("REMNIC_AUTH_TOKEN", "ENGRAM_AUTH_TOKEN");
-  if (port) overrides.port = parseInt(port, 10);
-  if (host) overrides.host = host;
-  if (authToken) overrides.authToken = authToken;
-  if (process.env.OPENAI_API_KEY) remnic.openaiApiKey = process.env.OPENAI_API_KEY;
-  const memoryDir = readCompatEnv("REMNIC_MEMORY_DIR", "ENGRAM_MEMORY_DIR");
-  if (memoryDir) remnic.memoryDir = memoryDir;
-  return { ...overrides, ...Object.keys(remnic).length > 0 ? { remnic } : {} };
-}
-async function startServer(options) {
-  initLogger();
-  const configPath = resolveConfigPath(options?.configPath);
-  const fileConfig = fs.existsSync(configPath) ? loadConfigFile(configPath) : { remnic: {}, server: {} };
-  const env = envOverrides();
-  const remnicConfig = { ...fileConfig.remnic, ...env.remnic ?? {} };
-  const serverConfig = {
-    ...fileConfig.server,
-    ...env,
-    ...options?.host ? { host: options.host } : {},
-    ...options?.port ? { port: options.port } : {},
-    ...options?.authToken ? { authToken: options.authToken } : {}
-  };
-  const config = parseConfig(remnicConfig);
-  const orchestrator = new Orchestrator(config);
-  const service = new EngramAccessService(orchestrator);
-  const authToken = serverConfig.authToken ?? readCompatEnv("REMNIC_AUTH_TOKEN", "ENGRAM_AUTH_TOKEN") ?? "";
-  if (!authToken && getAllValidTokens().length === 0) {
-    log.warn("No auth token set \u2014 server will reject all requests. Set REMNIC_AUTH_TOKEN, server.authToken in config, or generate tokens with 'remnic token generate'.");
-  }
-  const httpServer = new EngramAccessHttpServer({
-    service,
-    host: serverConfig.host ?? "127.0.0.1",
-    port: serverConfig.port ?? 4318,
-    authToken: authToken || void 0,
-    authTokensGetter: () => getAllValidTokensCached(),
-    principal: serverConfig.principal,
-    maxBodyBytes: serverConfig.maxBodyBytes,
-    adminConsoleEnabled: serverConfig.adminConsoleEnabled ?? false,
-    citationsEnabled: config.citationsEnabled,
-    citationsAutoDetect: config.citationsAutoDetect
-  });
-  const { host, port } = await httpServer.start();
-  return { config, service, httpServer, host, port };
-}
-function parseCliArgs(argv) {
-  const args = {};
-  for (let i = 0; i < argv.length; i++) {
-    const token = argv[i];
-    if (token.startsWith("--")) {
-      const key = token.slice(2);
-      const next = argv[i + 1];
-      if (next && !next.startsWith("--")) {
-        args[key] = next;
-        i++;
-      } else {
-        args[key] = "true";
-      }
-    }
-  }
-  return args;
-}
-async function cliMain(argv = process.argv.slice(2)) {
-  const args = parseCliArgs(argv);
-  if (args.help) {
-    console.log(`
-remnic-server \u2014 Standalone Remnic memory server
-
-Usage:
-  remnic-server [options]
-
-Options:
-  --config <path>     Path to config file (default: remnic.config.json)
-  --host <addr>       Bind address (default: 127.0.0.1)
-  --port <number>     Port number (default: 4318)
-  --auth-token <tok>  Bearer token for auth (or set REMNIC_AUTH_TOKEN)
-  --help              Show this help
-
-Environment:
-  REMNIC_CONFIG_PATH   Config file path (ENGRAM_CONFIG_PATH also supported)
-  REMNIC_PORT          Server port (ENGRAM_PORT also supported)
-  REMNIC_HOST          Bind address (ENGRAM_HOST also supported)
-  REMNIC_AUTH_TOKEN    Auth bearer token (ENGRAM_AUTH_TOKEN also supported)
-  REMNIC_MEMORY_DIR    Override memory directory (ENGRAM_MEMORY_DIR also supported)
-  OPENAI_API_KEY       OpenAI API key for extraction
-`);
-    process.exit(0);
-  }
-  const result = await startServer({
-    configPath: args.config,
-    host: args.host,
-    port: args.port ? parseInt(args.port, 10) : void 0,
-    authToken: args["auth-token"]
-  });
-  console.log(`Remnic server listening on http://${result.host}:${result.port}`);
-  const shutdown = async (signal) => {
-    console.log(`
-Received ${signal}, shutting down...`);
-    await result.httpServer.stop();
-    process.exit(0);
-  };
-  process.on("SIGINT", () => shutdown("SIGINT"));
-  process.on("SIGTERM", () => shutdown("SIGTERM"));
-}
-if (process.argv[1] && (/remnic-server[\\/](?:dist|src)[\\/]index\.[jt]s$/.test(process.argv[1]) || /engram-server[\\/](?:dist|src)[\\/]index\.[jt]s$/.test(process.argv[1]) || process.argv[1].endsWith("remnic-server") || process.argv[1].endsWith("engram-server"))) {
-  cliMain().catch((err) => {
-    process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  });
-}
-
-export {
-  cliMain
-};
-//# sourceMappingURL=chunk-MKNXEH3P.js.map

package/dist/bin/chunk-MKNXEH3P.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/index.ts"],"sourcesContent":["/**\n * @remnic/server\n *\n * Standalone Remnic memory server.\n *\n * Loads config from `remnic.config.json` (or env vars), creates an Orchestrator,\n * and starts the HTTP access server with MCP endpoint — no OpenClaw required.\n *\n * Usage:\n *   npx remnic-server\n *   npx remnic-server --config ./my-remnic.json\n *   npx remnic-server --port 4320\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { parseConfig, Orchestrator, EngramAccessService, EngramAccessHttpServer, initLogger, log, getAllValidTokens, getAllValidTokensCached, type PluginConfig } from \"@remnic/core\";\n\n// ── Config loading ──────────────────────────────────────────────────────────\n\nexport interface ServerConfig {\n  remnic: Record<string, unknown>;\n  server: {\n    host?: string;\n    port?: number;\n    authToken?: string;\n    principal?: string;\n    maxBodyBytes?: number;\n    adminConsoleEnabled?: boolean;\n  };\n}\n\nfunction readCompatEnv(primary: string, legacy: string): string | undefined {\n  return process.env[primary] ?? process.env[legacy];\n}\n\nfunction resolveConfigPath(cliPath?: string): string {\n  if (cliPath) return path.resolve(cliPath);\n\n  const envPath = readCompatEnv(\"REMNIC_CONFIG_PATH\", \"ENGRAM_CONFIG_PATH\");\n  if (envPath) return path.resolve(envPath);\n\n  const homeDir = process.env.HOME ?? \"~\";\n  const candidates = [\n    path.join(process.cwd(), \"remnic.config.json\"),\n    path.join(process.cwd(), \"engram.config.json\"),\n    path.join(homeDir, \".config\", \"remnic\", \"config.json\"),\n    path.join(homeDir, \".config\", \"engram\", \"config.json\"),\n  ];\n  for (const candidate of candidates) {\n    if (fs.existsSync(candidate)) return candidate;\n  }\n\n  return path.join(homeDir, \".config\", \"remnic\", \"config.json\");\n}\n\nfunction loadConfigFile(configPath: string): ServerConfig {\n  const raw = JSON.parse(fs.readFileSync(configPath, \"utf8\"));\n  return {\n    remnic: raw.remnic ?? raw.engram ?? raw ?? {},\n    server: raw.server ?? {},\n  };\n}\n\nfunction envOverrides(): Partial<ServerConfig[\"server\"]> & { remnic?: Record<string, unknown> } {\n  const overrides: Record<string, unknown> = {};\n  const remnic: Record<string, unknown> = {};\n\n  const port = readCompatEnv(\"REMNIC_PORT\", \"ENGRAM_PORT\");\n  const host = readCompatEnv(\"REMNIC_HOST\", \"ENGRAM_HOST\");\n  const authToken = readCompatEnv(\"REMNIC_AUTH_TOKEN\", \"ENGRAM_AUTH_TOKEN\");\n  if (port) overrides.port = parseInt(port, 10);\n  if (host) overrides.host = host;\n  if (authToken) overrides.authToken = authToken;\n\n  if (process.env.OPENAI_API_KEY) remnic.openaiApiKey = process.env.OPENAI_API_KEY;\n  const memoryDir = readCompatEnv(\"REMNIC_MEMORY_DIR\", \"ENGRAM_MEMORY_DIR\");\n  if (memoryDir) remnic.memoryDir = memoryDir;\n\n  return { ...overrides, ...(Object.keys(remnic).length > 0 ? { remnic } : {}) };\n}\n\n// ── Server startup ──────────────────────────────────────────────────────────\n\nexport interface ServerResult {\n  config: PluginConfig;\n  service: EngramAccessService;\n  httpServer: EngramAccessHttpServer;\n  host: string;\n  port: number;\n}\n\nexport async function startServer(options?: {\n  configPath?: string;\n  host?: string;\n  port?: number;\n  authToken?: string;\n}): Promise<ServerResult> {\n  initLogger();\n\n  const configPath = resolveConfigPath(options?.configPath);\n  const fileConfig = fs.existsSync(configPath)\n    ? loadConfigFile(configPath)\n    : { remnic: {}, server: {} };\n\n  const env = envOverrides();\n\n  // Merge: file < env < cli flags\n  const remnicConfig = { ...fileConfig.remnic, ...(env.remnic ?? {}) };\n  const serverConfig = {\n    ...fileConfig.server,\n    ...env,\n    ...(options?.host ? { host: options.host } : {}),\n    ...(options?.port ? { port: options.port } : {}),\n    ...(options?.authToken ? { authToken: options.authToken } : {}),\n  };\n\n  const config = parseConfig(remnicConfig);\n  const orchestrator = new Orchestrator(config);\n  const service = new EngramAccessService(orchestrator);\n\n  const authToken = serverConfig.authToken ?? readCompatEnv(\"REMNIC_AUTH_TOKEN\", \"ENGRAM_AUTH_TOKEN\") ?? \"\";\n\n  // Connector tokens are loaded dynamically per request via authTokensGetter\n  // so that token generate/revoke takes effect without server restart\n  if (!authToken && getAllValidTokens().length === 0) {\n    log.warn(\"No auth token set — server will reject all requests. Set REMNIC_AUTH_TOKEN, server.authToken in config, or generate tokens with 'remnic token generate'.\");\n  }\n\n  const httpServer = new EngramAccessHttpServer({\n    service,\n    host: serverConfig.host ?? \"127.0.0.1\",\n    port: serverConfig.port ?? 4318,\n    authToken: authToken || undefined,\n    authTokensGetter: () => getAllValidTokensCached(),\n    principal: serverConfig.principal,\n    maxBodyBytes: serverConfig.maxBodyBytes,\n    adminConsoleEnabled: serverConfig.adminConsoleEnabled ?? false,\n    citationsEnabled: config.citationsEnabled,\n    citationsAutoDetect: config.citationsAutoDetect,\n  });\n\n  const { host, port } = await httpServer.start();\n\n  return { config, service, httpServer, host, port };\n}\n\n// ── CLI entry point ──────────────────────────────────────────────────────────\n\nfunction parseCliArgs(argv: string[]): Record<string, string | undefined> {\n  const args: Record<string, string | undefined> = {};\n  for (let i = 0; i < argv.length; i++) {\n    const token = argv[i];\n    if (token.startsWith(\"--\")) {\n      const key = token.slice(2);\n      const next = argv[i + 1];\n      if (next && !next.startsWith(\"--\")) {\n        args[key] = next;\n        i++;\n      } else {\n        args[key] = \"true\";\n      }\n    }\n  }\n  return args;\n}\n\nexport async function cliMain(argv: string[] = process.argv.slice(2)): Promise<void> {\n  const args = parseCliArgs(argv);\n\n  if (args.help) {\n    console.log(`\nremnic-server — Standalone Remnic memory server\n\nUsage:\n  remnic-server [options]\n\nOptions:\n  --config <path>     Path to config file (default: remnic.config.json)\n  --host <addr>       Bind address (default: 127.0.0.1)\n  --port <number>     Port number (default: 4318)\n  --auth-token <tok>  Bearer token for auth (or set REMNIC_AUTH_TOKEN)\n  --help              Show this help\n\nEnvironment:\n  REMNIC_CONFIG_PATH   Config file path (ENGRAM_CONFIG_PATH also supported)\n  REMNIC_PORT          Server port (ENGRAM_PORT also supported)\n  REMNIC_HOST          Bind address (ENGRAM_HOST also supported)\n  REMNIC_AUTH_TOKEN    Auth bearer token (ENGRAM_AUTH_TOKEN also supported)\n  REMNIC_MEMORY_DIR    Override memory directory (ENGRAM_MEMORY_DIR also supported)\n  OPENAI_API_KEY       OpenAI API key for extraction\n`);\n    process.exit(0);\n  }\n\n  const result = await startServer({\n    configPath: args.config,\n    host: args.host,\n    port: args.port ? parseInt(args.port, 10) : undefined,\n    authToken: args[\"auth-token\"],\n  });\n\n  console.log(`Remnic server listening on http://${result.host}:${result.port}`);\n\n  // Graceful shutdown\n  const shutdown = async (signal: string) => {\n    console.log(`\\nReceived ${signal}, shutting down...`);\n    await result.httpServer.stop();\n    process.exit(0);\n  };\n\n  process.on(\"SIGINT\", () => shutdown(\"SIGINT\"));\n  process.on(\"SIGTERM\", () => shutdown(\"SIGTERM\"));\n}\n\n// Auto-run when executed directly\n// Matches: `node .../remnic-server/dist/index.js`, `node .../remnic-server/src/index.ts`,\n// `npx remnic-server`, `npx engram-server`, but NOT test files under those directories\nif (\n  process.argv[1] &&\n  (/remnic-server[\\\\/](?:dist|src)[\\\\/]index\\.[jt]s$/.test(process.argv[1]) ||\n   /engram-server[\\\\/](?:dist|src)[\\\\/]index\\.[jt]s$/.test(process.argv[1]) ||\n   process.argv[1].endsWith(\"remnic-server\") ||\n   process.argv[1].endsWith(\"engram-server\"))\n) {\n  cliMain().catch((err) => {\n    process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}\\n`);\n    process.exit(1);\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/bin/engram-server.js

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-// openclaw-engram: Local-first memory plugin
-import {
-  cliMain
-} from "./chunk-MKNXEH3P.js";
-
-// bin/engram-server.ts
-cliMain().catch((err) => {
-  process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
-`);
-  process.exit(1);
-});
-//# sourceMappingURL=engram-server.js.map

package/dist/bin/engram-server.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../bin/engram-server.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * engram-server binary entry point.\n * Delegates to @remnic/server CLI main.\n */\nimport { cliMain } from \"../src/index.js\";\n\ncliMain().catch((err) => {\n  process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}\\n`);\n  process.exit(1);\n});\n"],"mappings":";;;;;;;AAOA,QAAQ,EAAE,MAAM,CAAC,QAAQ;AACvB,UAAQ,OAAO,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,CAAI;AACnF,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}

package/dist/bin/remnic-server.js

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-// openclaw-engram: Local-first memory plugin
-import {
-  cliMain
-} from "./chunk-MKNXEH3P.js";
-
-// bin/remnic-server.ts
-cliMain().catch((err) => {
-  process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}
-`);
-  process.exit(1);
-});
-//# sourceMappingURL=remnic-server.js.map

package/dist/bin/remnic-server.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../bin/remnic-server.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * remnic-server binary entry point.\n * Delegates to @remnic/server CLI main.\n */\nimport { cliMain } from \"../src/index.js\";\n\ncliMain().catch((err) => {\n  process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}\\n`);\n  process.exit(1);\n});\n"],"mappings":";;;;;;;AAOA,QAAQ,EAAE,MAAM,CAAC,QAAQ;AACvB,UAAQ,OAAO,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,CAAI;AACnF,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}