@remnic/core 1.1.11 → 1.1.13

package/README.md

@@ -1,8 +1,8 @@
 # @remnic/core
 
-Framework-agnostic memory engine for AI agents. Orchestration, storage, extraction, search, and trust zones -- all local, all private.
+Framework-agnostic memory and context engine for user-aware agents. Orchestration, storage, extraction, search, and trust zones -- inspectable and local by default.
 
-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
 
@@ -12,7 +12,7 @@ npm install @remnic/core
 
 ## What it does
 
-Remnic Core is the engine that powers persistent memory across AI agent sessions. It handles:
+Remnic Core is the engine that powers scoped memory and context across AI agent sessions. It handles:
 
 - **Memory orchestration** -- three-phase flow: recall before sessions, buffer during, extract after
 - **Storage** -- plain markdown files with YAML frontmatter on your local filesystem

package/dist/access-cli.d.ts

@@ -9,7 +9,8 @@ type AccessCliOptions = {
     preferredId?: string;
 };
 declare function main(argv?: string[], options?: AccessCliOptions): Promise<void>;
+declare function sanitizeAccessCliErrorMessage(message: string): string;
 declare function printUsage(): void;
 declare function runCli(argv?: string[], options?: AccessCliOptions): Promise<void>;
 
-export { type AccessCliOptions, main, printUsage, runCli };
+export { type AccessCliOptions, main, printUsage, runCli, sanitizeAccessCliErrorMessage };

package/dist/access-cli.js

@@ -1,152 +1,197 @@
 import {
   Orchestrator
-} from "./chunk-KUHRUM6B.js";
-import "./chunk-4DXC6HQQ.js";
+} from "./chunk-GA454ALV.js";
 import "./chunk-CK5NTM2S.js";
+import "./chunk-KOSORCJG.js";
+import "./chunk-BFBF3XEF.js";
+import "./chunk-HHLLAQGZ.js";
+import "./chunk-UWK5OXUJ.js";
+import "./chunk-VNO6ZJ35.js";
+import "./chunk-34DQE4KF.js";
+import "./chunk-56K5QLHX.js";
+import "./chunk-7N4KAIGN.js";
+import "./chunk-TPDBFYEG.js";
+import "./chunk-ZTFCYYEZ.js";
+import "./chunk-7XYTQGCC.js";
+import "./chunk-TECVW3JP.js";
+import "./chunk-RYED3SPJ.js";
+import "./chunk-KUJVMMZQ.js";
+import "./chunk-U4SCL7B7.js";
 import "./chunk-FSFEQI74.js";
+import "./chunk-OIGNEXKZ.js";
 import "./chunk-MDYG7VI7.js";
 import "./chunk-Z5AAYHUC.js";
 import "./chunk-S75M5ZRK.js";
 import "./chunk-TPB3I2AC.js";
 import "./chunk-UHGBNIOS.js";
-import "./chunk-PHNGXFQ6.js";
-import "./chunk-ETOW6ACV.js";
-import "./chunk-ZTSE2ZJ6.js";
+import "./chunk-H3ME6L6D.js";
+import "./chunk-XJNBEDFE.js";
+import "./chunk-VWT3F4IV.js";
 import "./chunk-JR4ZC3G4.js";
-import "./chunk-K4FLSOR5.js";
-import "./chunk-V3RXWQIE.js";
 import "./chunk-5IZL4DCV.js";
-import "./chunk-X7XN6YU4.js";
 import "./chunk-5NPGSAVB.js";
 import "./chunk-C7VW7C3F.js";
+import "./chunk-OZKZ2TRP.js";
+import "./chunk-K4FLSOR5.js";
+import "./chunk-V3RXWQIE.js";
+import "./chunk-WPGJYVUH.js";
+import "./chunk-X7XN6YU4.js";
+import "./chunk-ZZTOURJI.js";
 import "./chunk-YDBIWGNI.js";
 import "./chunk-7DHTMOND.js";
-import "./chunk-WPGJYVUH.js";
 import "./chunk-YCN4BVDK.js";
-import "./chunk-ZZTOURJI.js";
 import "./chunk-D654IBA6.js";
-import "./chunk-H63EDPFJ.js";
 import "./chunk-3GPTTA4J.js";
 import "./chunk-IISBCCWR.js";
-import "./chunk-GGD5W7TB.js";
-import "./chunk-XMVFHBHT.js";
+import "./chunk-U3WSW6PZ.js";
+import "./chunk-H63EDPFJ.js";
+import "./chunk-PD6O7AXF.js";
 import "./chunk-YAZNBMNF.js";
-import "./chunk-Z5S5HNGY.js";
+import "./chunk-LCR46JY5.js";
+import "./chunk-C4SQJZAF.js";
+import "./chunk-W3LR522O.js";
+import "./chunk-4RA3C3EV.js";
 import "./chunk-WW3QQF4H.js";
 import "./chunk-54V4BZWP.js";
 import "./chunk-QR3C7BKQ.js";
-import "./chunk-NN3LPQ5D.js";
-import "./chunk-S2JJBLJG.js";
-import "./chunk-74WWN7ZW.js";
-import "./chunk-DF3RVK3X.js";
-import "./chunk-C4SQJZAF.js";
+import "./chunk-EDTHC6UD.js";
+import "./chunk-DB5A3NHS.js";
+import "./chunk-7IASACLB.js";
+import "./chunk-6NKAQ74D.js";
+import "./chunk-OAZ5MFUB.js";
+import "./chunk-PYPOFEMK.js";
 import "./chunk-3IQ2TR4N.js";
 import "./chunk-VEWZZM3H.js";
-import "./chunk-6AUUAZEX.js";
+import "./chunk-5NXIJZFX.js";
 import "./chunk-Y4FHOFJ2.js";
-import "./chunk-Z2E7VW55.js";
-import "./chunk-LIO5X3CM.js";
+import "./chunk-NMZY542O.js";
+import "./chunk-3PG3H5TD.js";
 import "./chunk-2NMMFZ5T.js";
-import "./chunk-SRBJUAMP.js";
+import "./chunk-I5V2VDIW.js";
+import "./chunk-ME6ESPZU.js";
+import "./chunk-RHY3HH7P.js";
+import "./chunk-EJI5XIBB.js";
+import "./chunk-2PRQG7PV.js";
+import "./chunk-LUDTDZLK.js";
 import "./chunk-PYXS46O7.js";
 import "./chunk-3QKK7QOS.js";
-import "./chunk-RXTFCYQF.js";
-import "./chunk-JRNQ3RNA.js";
-import "./chunk-PB5KW5PL.js";
+import "./chunk-P4NEIHUT.js";
+import "./chunk-W4RVMTHR.js";
+import "./chunk-MC26UJIM.js";
 import "./chunk-CULXMQJH.js";
-import "./chunk-E6K4NIEU.js";
-import "./chunk-57QNCUEZ.js";
+import "./chunk-5375UYTQ.js";
+import "./chunk-FF4KLI5W.js";
+import "./chunk-EABGC2TL.js";
+import "./chunk-PU63GXWS.js";
+import "./chunk-6RVI47ZR.js";
+import "./chunk-XVVIG67A.js";
+import "./chunk-PIRJPV5T.js";
+import "./chunk-RXDLTSWT.js";
+import "./chunk-3VAL7ZL2.js";
+import "./chunk-TMQLARTH.js";
+import "./chunk-MJFNCJXV.js";
+import "./chunk-NJ3MJQZX.js";
+import "./chunk-QQUAB63I.js";
+import "./chunk-PR5FBTFU.js";
+import "./chunk-FJ43PRLT.js";
+import "./chunk-LLQ2LLWF.js";
+import "./chunk-7DTASS5T.js";
 import "./chunk-YRMVARQP.js";
-import "./chunk-P77UEOU2.js";
 import {
   resolveRemnicPluginEntry
 } from "./chunk-U66YHYC7.js";
-import "./chunk-EABGC2TL.js";
-import "./chunk-4IS4SXIQ.js";
-import "./chunk-6TBWYBJ3.js";
-import "./chunk-HMDCOMYU.js";
+import "./chunk-BJ3KMYTB.js";
+import "./chunk-HXXBL2KD.js";
+import "./chunk-LPMVBPA3.js";
 import "./chunk-JXS5PDQ7.js";
-import "./chunk-K6WK37A6.js";
+import "./chunk-HMDCOMYU.js";
+import "./chunk-7SEAZFFB.js";
+import "./chunk-D46YSIYX.js";
 import "./chunk-AJU4PJGY.js";
 import "./chunk-C6QPK5GG.js";
-import "./chunk-7SEAZFFB.js";
-import "./chunk-FYIYMQ5N.js";
-import {
-  parseConfig
-} from "./chunk-6Z6UH6TK.js";
-import "./chunk-Z5LAYHGJ.js";
+import "./chunk-2KI4QFHU.js";
 import "./chunk-OZHRDTDX.js";
-import "./chunk-3PG3H5TD.js";
+import "./chunk-3UXOZBHV.js";
 import "./chunk-KVE7R4CG.js";
 import "./chunk-4WMCPJWX.js";
-import "./chunk-JBMSGZEQ.js";
-import "./chunk-C5HUWVH2.js";
-import "./chunk-EJI5XIBB.js";
-import "./chunk-VX2IUQFE.js";
-import "./chunk-S3IP6R6K.js";
-import "./chunk-L2EXJQJP.js";
+import "./chunk-5RGLBDQF.js";
+import "./chunk-DINWEURR.js";
+import "./chunk-FLTNHQK6.js";
 import "./chunk-7SI52C65.js";
+import "./chunk-L2EXJQJP.js";
 import "./chunk-UZB5KHKX.js";
-import "./chunk-KWBPHZUU.js";
+import "./chunk-RK6F44Y6.js";
+import {
+  parseConfig
+} from "./chunk-2QR3XXIC.js";
+import "./chunk-PHK3HARR.js";
+import "./chunk-Z5LAYHGJ.js";
 import "./chunk-6HZ6AO2P.js";
 import "./chunk-JWPLJLDU.js";
 import "./chunk-N53K2EXC.js";
 import "./chunk-XYIK4LF6.js";
-import "./chunk-URB2WSKZ.js";
+import "./chunk-NZL6GGQE.js";
 import "./chunk-PVGDJXVK.js";
 import "./chunk-NGAVDO7E.js";
 import {
   EngramAccessService
-} from "./chunk-WGK4VHGP.js";
-import "./chunk-QIGOEM65.js";
+} from "./chunk-M23FSH32.js";
+import "./chunk-ZKSK55RC.js";
+import "./chunk-WELDCG6C.js";
+import "./chunk-GGKRUQOO.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-O4XJUPSF.js";
-import "./chunk-SOBJ6NEY.js";
 import "./chunk-H7XKCNR6.js";
-import "./chunk-EYNQTST2.js";
-import "./chunk-D54LZC5L.js";
-import "./chunk-EQINRHYR.js";
-import "./chunk-2YMTO4ZJ.js";
-import "./chunk-EIR5VLIH.js";
-import "./chunk-HJYHRE4S.js";
-import "./chunk-IBX3VFOM.js";
+import "./chunk-FBYESMQ2.js";
+import "./chunk-SOBJ6NEY.js";
+import "./chunk-FDU6HUUL.js";
+import "./chunk-QDZ2RLEC.js";
+import "./chunk-MGKYQQYF.js";
+import "./chunk-GL6I6MEQ.js";
+import "./chunk-3APJ5EVB.js";
 import "./chunk-5UM2VJ6D.js";
+import "./chunk-EFJ3MQ4V.js";
+import "./chunk-EIR5VLIH.js";
 import "./chunk-PCUKNJAZ.js";
-import "./chunk-EEQLFRUM.js";
+import "./chunk-RRF5UOBJ.js";
 import "./chunk-NBNN5GOB.js";
-import "./chunk-OR64ZGRZ.js";
-import "./chunk-GVPWB7EY.js";
-import "./chunk-2LGMW3DJ.js";
+import "./chunk-NNVTUXEB.js";
 import "./chunk-QDW3E4RD.js";
+import "./chunk-25MQ7IHJ.js";
 import "./chunk-GDFS42HT.js";
+import "./chunk-U3PN77QT.js";
 import "./chunk-RK2Y4XOM.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-WIICJPET.js";
-import "./chunk-G2WADRQ3.js";
-import "./chunk-74EMIVE4.js";
-import "./chunk-IXEJRKCZ.js";
-import "./chunk-DT5TVLJE.js";
-import "./chunk-N5AKDXAI.js";
-import "./chunk-TBBDFYXW.js";
-import "./chunk-WTFWLUSX.js";
-import "./chunk-MCC6KDQF.js";
+import "./chunk-VW676BEI.js";
+import "./chunk-7AAT6G4Q.js";
+import "./chunk-5UZXUTVO.js";
 import "./chunk-YNJHCGDT.js";
+import "./chunk-P7FMDTKL.js";
 import "./chunk-NN2DKE4T.js";
-import "./chunk-VQXK37XA.js";
+import "./chunk-Q7P4WJDP.js";
+import "./chunk-SCU65EZI.js";
+import "./chunk-3KW65B36.js";
+import "./chunk-3HPAPHUK.js";
 import "./chunk-PFV5C235.js";
 import "./chunk-RULE4VG5.js";
-import "./chunk-SCU65EZI.js";
-import "./chunk-XJKFSSDW.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-FVQJYWH7.js";
-import "./chunk-4DJQYKMN.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-FAAFWE4G.js";
+import {
+  expandTildePath
+} from "./chunk-QRNI5JBH.js";
+import "./chunk-ZY2MNJR6.js";
+import "./chunk-MY6TPVXW.js";
+import "./chunk-DT5TVLJE.js";
+import "./chunk-UWVJF25J.js";
+import "./chunk-4DJQYKMN.js";
 import {
   readEnvVar,
   resolveHomeDir
-} from "./chunk-MARWOCVP.js";
+} from "./chunk-XIG5PDM7.js";
+import "./chunk-TBBDFYXW.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-DGXUHMOV.js";
 import "./chunk-LPSF4OQH.js";
@@ -154,27 +199,34 @@ import "./chunk-TVVEYCNW.js";
 import "./chunk-RFYAYKTD.js";
 import "./chunk-LBLXEFWK.js";
 import "./chunk-XKECPATV.js";
-import "./chunk-P73JTV34.js";
-import "./chunk-457A4P3L.js";
-import "./chunk-OA3L7BFR.js";
-import "./chunk-767ODGE6.js";
+import "./chunk-2F2W355T.js";
+import "./chunk-KNKUID7G.js";
+import "./chunk-WEHSQBFR.js";
+import "./chunk-J4EB7DNW.js";
+import "./chunk-I6K5FBRQ.js";
+import "./chunk-AGZQD76C.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
 import "./chunk-A6XUJE5D.js";
+import "./chunk-AH2JUU6X.js";
+import "./chunk-AC5LO7IU.js";
+import "./chunk-SOAU2OE2.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/access-cli.ts
 import fs from "fs";
 import path from "path";
 var UsageError = class extends Error {
-  constructor(kind, optionName) {
+  constructor(kind, optionName, acceptedValues) {
     super("invalid access-cli arguments");
     this.kind = kind;
     this.optionName = optionName;
+    this.acceptedValues = acceptedValues;
   }
   kind;
   optionName;
+  acceptedValues;
 };
 function formatUsageError(error) {
   switch (error.kind) {
@@ -182,6 +234,14 @@ function formatUsageError(error) {
       return "unsupported command";
     case "unexpected-positional":
       return "unexpected positional argument";
+    case "unknown-option":
+      return `unknown option: --${error.optionName ?? "unknown"}`;
+    case "invalid-option": {
+      const accepted = error.acceptedValues?.length ? `. Accepted: ${error.acceptedValues.join(", ")}.` : "";
+      return `invalid value for --${error.optionName ?? "unknown"}${accepted}`;
+    }
+    case "option-does-not-take-value":
+      return `option does not accept a value: --${error.optionName ?? "unknown"}`;
     case "missing-option":
       return `missing required option: --${error.optionName ?? "unknown"}`;
     case "missing-content":
@@ -204,6 +264,7 @@ function usage() {
     "",
     "Browse options:",
     "  --namespace <name>",
+    "  --principal <principal>",
     "  --query <text>",
     "  --category <name>",
     "  --status <name>",
@@ -226,11 +287,50 @@ function usage() {
     "  --dry-run"
   ].join("\n");
 }
+var COMMAND_SPECS = {
+  browse: {
+    valueOptions: /* @__PURE__ */ new Set([
+      "namespace",
+      "principal",
+      "query",
+      "category",
+      "status",
+      "sort",
+      "limit",
+      "offset"
+    ]),
+    flagOptions: /* @__PURE__ */ new Set()
+  },
+  store: {
+    valueOptions: /* @__PURE__ */ new Set([
+      "namespace",
+      "session-key",
+      "principal",
+      "content",
+      "content-file",
+      "category",
+      "confidence",
+      "tag",
+      "entity-ref",
+      "ttl",
+      "source-reason",
+      "idempotency-key"
+    ]),
+    flagOptions: /* @__PURE__ */ new Set(["dry-run"])
+  }
+};
+var BROWSE_SORT_VALUES = Object.freeze([
+  "updated_desc",
+  "updated_asc",
+  "created_desc",
+  "created_asc"
+]);
 function parseArgs(argv) {
   const [commandRaw, ...rest] = argv;
   if (commandRaw !== "browse" && commandRaw !== "store") {
     throw new UsageError("unsupported-command");
   }
+  const spec = COMMAND_SPECS[commandRaw];
   const options = {};
   const flags = /* @__PURE__ */ new Set();
   for (let i = 0; i < rest.length; i += 1) {
@@ -238,12 +338,41 @@ function parseArgs(argv) {
     if (!token.startsWith("--")) {
       throw new UsageError("unexpected-positional");
     }
-    const key = token.slice(2);
-    const next = rest[i + 1];
-    if (!next || next.startsWith("--")) {
+    const rawKey = token.slice(2);
+    if (!rawKey) {
+      throw new UsageError("unknown-option", rawKey);
+    }
+    const equalsIndex = rawKey.indexOf("=");
+    const key = equalsIndex === -1 ? rawKey : rawKey.slice(0, equalsIndex);
+    const inlineValue = equalsIndex === -1 ? void 0 : rawKey.slice(equalsIndex + 1);
+    if (!spec.valueOptions.has(key) && !spec.flagOptions.has(key)) {
+      throw new UsageError("unknown-option", key);
+    }
+    if (spec.flagOptions.has(key)) {
+      if (inlineValue !== void 0) {
+        throw new UsageError("option-does-not-take-value", key);
+      }
+      const next2 = rest[i + 1];
+      if (next2 && !next2.startsWith("--")) {
+        throw new UsageError("option-does-not-take-value", key);
+      }
       flags.add(key);
       continue;
     }
+    if (inlineValue !== void 0) {
+      if (inlineValue.length === 0) {
+        throw new UsageError("missing-option", key);
+      }
+      if (!options[key]) {
+        options[key] = [];
+      }
+      options[key].push(inlineValue);
+      continue;
+    }
+    const next = rest[i + 1];
+    if (next === void 0 || next.length === 0 || next.startsWith("--")) {
+      throw new UsageError("missing-option", key);
+    }
     if (!options[key]) {
       options[key] = [];
     }
@@ -271,26 +400,51 @@ function requireOption(args, name) {
   }
   return value;
 }
-function parseIntegerOption(args, name) {
+function parseIntegerOption(args, name, options = {}) {
   const raw = getLastOption(args, name);
   if (!raw) return void 0;
-  const value = parseInt(raw, 10);
-  if (!Number.isFinite(value)) {
+  const trimmed = raw.trim();
+  if (!/^[+-]?\d+$/.test(trimmed)) {
+    throw new UsageError("invalid-integer", name);
+  }
+  const value = Number(trimmed);
+  if (!Number.isSafeInteger(value)) {
     throw new UsageError("invalid-integer", name);
   }
+  if (options.min !== void 0 && value < options.min) {
+    throw new UsageError("invalid-option", name, [`integer >= ${options.min}`]);
+  }
   return value;
 }
-function parseFloatOption(args, name) {
+function parseBrowseSortOption(args, name) {
   const raw = getLastOption(args, name);
   if (!raw) return void 0;
-  const value = Number.parseFloat(raw);
+  if (BROWSE_SORT_VALUES.includes(raw)) {
+    return raw;
+  }
+  throw new UsageError("invalid-option", name, BROWSE_SORT_VALUES);
+}
+function parseFloatOption(args, name, options = {}) {
+  const raw = getLastOption(args, name);
+  if (!raw) return void 0;
+  const trimmed = raw.trim();
+  if (!/^[+-]?(?:(?:\d+\.?\d*)|(?:\.\d+))(?:e[+-]?\d+)?$/i.test(trimmed)) {
+    throw new UsageError("invalid-number", name);
+  }
+  const value = Number(trimmed);
   if (!Number.isFinite(value)) {
     throw new UsageError("invalid-number", name);
   }
+  if (options.min !== void 0 && value < options.min) {
+    throw new UsageError("invalid-number", name);
+  }
+  if (options.max !== void 0 && value > options.max) {
+    throw new UsageError("invalid-number", name);
+  }
   return value;
 }
 function loadPluginConfig(preferredId) {
-  const configPath = readEnvVar("OPENCLAW_ENGRAM_CONFIG_PATH") || readEnvVar("OPENCLAW_CONFIG_PATH") || path.join(resolveHomeDir(), ".openclaw", "openclaw.json");
+  const configPath = expandOptionalPath(readEnvVar("OPENCLAW_CONFIG_PATH")) || expandOptionalPath(readEnvVar("OPENCLAW_ENGRAM_CONFIG_PATH")) || path.join(resolveHomeDir(), ".openclaw", "openclaw.json");
   const raw = JSON.parse(fs.readFileSync(configPath, "utf8"));
   const entry = resolveRemnicPluginEntry(raw, preferredId);
   return entry?.["config"] ?? {};
@@ -303,42 +457,70 @@ function buildRuntime(preferredId) {
   };
 }
 async function runBrowse(args, preferredId) {
-  const { service } = buildRuntime(preferredId);
-  const result = await service.memoryBrowse({
+  const browseArgs = {
     namespace: getLastOption(args, "namespace"),
+    principal: getLastOption(args, "principal"),
     query: getLastOption(args, "query"),
     category: getLastOption(args, "category"),
     status: getLastOption(args, "status"),
-    sort: getLastOption(args, "sort"),
-    limit: parseIntegerOption(args, "limit"),
-    offset: parseIntegerOption(args, "offset")
-  });
+    sort: parseBrowseSortOption(args, "sort"),
+    limit: parseIntegerOption(args, "limit", { min: 1 }),
+    offset: parseIntegerOption(args, "offset", { min: 0 })
+  };
+  const { config, service } = buildRuntime(preferredId);
+  const request = {
+    namespace: browseArgs.namespace,
+    authenticatedPrincipal: browseArgs.principal ?? config.agentAccessHttp.principal,
+    query: browseArgs.query,
+    category: browseArgs.category,
+    status: browseArgs.status,
+    sort: browseArgs.sort,
+    limit: browseArgs.limit,
+    offset: browseArgs.offset
+  };
+  const result = await service.memoryBrowse(request);
   console.log(JSON.stringify(result, null, 2));
 }
 async function runStore(args, preferredId) {
-  const { config, service } = buildRuntime(preferredId);
   const contentFile = getLastOption(args, "content-file");
   const inlineContent = getLastOption(args, "content");
-  const content = contentFile ? fs.readFileSync(contentFile, "utf8") : inlineContent;
+  const content = contentFile ? fs.readFileSync(expandTildePath(contentFile), "utf8") : inlineContent;
   if (!content || content.trim().length === 0) {
     throw new UsageError("missing-content");
   }
-  const result = await service.memoryStore({
+  const storeArgs = {
     namespace: getLastOption(args, "namespace"),
     sessionKey: getLastOption(args, "session-key"),
-    authenticatedPrincipal: getLastOption(args, "principal") ?? config.agentAccessHttp.principal,
     content,
     category: requireOption(args, "category"),
-    confidence: parseFloatOption(args, "confidence"),
+    confidence: parseFloatOption(args, "confidence", { min: 0, max: 1 }),
     tags: getAllOptions(args, "tag"),
     entityRef: getLastOption(args, "entity-ref"),
     ttl: getLastOption(args, "ttl"),
     sourceReason: getLastOption(args, "source-reason"),
     idempotencyKey: getLastOption(args, "idempotency-key"),
     dryRun: args.flags.has("dry-run")
+  };
+  const { config, service } = buildRuntime(preferredId);
+  const result = await service.memoryStore({
+    namespace: storeArgs.namespace,
+    sessionKey: storeArgs.sessionKey,
+    authenticatedPrincipal: getLastOption(args, "principal") ?? config.agentAccessHttp.principal,
+    content: storeArgs.content,
+    category: storeArgs.category,
+    confidence: storeArgs.confidence,
+    tags: storeArgs.tags,
+    entityRef: storeArgs.entityRef,
+    ttl: storeArgs.ttl,
+    sourceReason: storeArgs.sourceReason,
+    idempotencyKey: storeArgs.idempotencyKey,
+    dryRun: storeArgs.dryRun
   });
   console.log(JSON.stringify(result, null, 2));
 }
+function expandOptionalPath(value) {
+  return value === void 0 ? void 0 : expandTildePath(value);
+}
 async function main(argv = process.argv.slice(2), options = {}) {
   const args = parseArgs(argv);
   if (args.command === "browse") {
@@ -347,6 +529,12 @@ async function main(argv = process.argv.slice(2), options = {}) {
   }
   await runStore(args, options.preferredId);
 }
+function sanitizeAccessCliErrorMessage(message) {
+  return message.replace(
+    /\b(openaiApiKey|localLlmApiKey)\b(\s*[:=]\s*)(?:"[^"]*"|'[^']*'|[^\s,}\]]+)/gi,
+    (_match, name, separator) => `${name}${separator}[redacted]`
+  );
+}
 function printUsage() {
   writeCliOutput(usage());
 }
@@ -360,13 +548,14 @@ async function runCli(argv = process.argv.slice(2), options = {}) {
       printUsage();
       process.exit(1);
     }
-    console.error("access-cli failed");
+    console.error("access-cli failed: runtime error");
     process.exit(1);
   }
 }
 export {
   main,
   printUsage,
-  runCli
+  runCli,
+  sanitizeAccessCliErrorMessage
 };
 //# sourceMappingURL=access-cli.js.map