@pyxmate/memory 1.16.1 → 1.16.3

package/README.md

@@ -55,10 +55,14 @@ for the full CLI contract and exit codes.
 
 ## Use it programmatically
 
+`MemoryClient` connects directly to a pyx-memory instance server (self-hosted
+or a sidecar you run). Hosted pyx-memory access uses MCP via `pyx-mem mcp` or
+the `/mcp` endpoint — not this HTTP client.
+
 ```ts
 import { MemoryClient } from '@pyxmate/memory';
 
-const memory = new MemoryClient('https://memory.api.pyxmate.com', process.env.MEMORY_API_KEY);
+const memory = new MemoryClient('http://localhost:7822', process.env.MEMORY_API_KEY);
 await memory.initialize();
 
 await memory.store({

package/dist/{chunk-672SGW22.mjs → chunk-3QDXACBV.mjs}

@@ -1006,6 +1006,12 @@ var MemoryClient = class {
       );
     }
     if (!body?.success || body.data == null) {
+      if (res.ok && body?.error === void 0) {
+        throw new MemoryServerError(
+          `Memory server returned HTTP ${res.status} without the expected { success, data } API envelope. Check that the base URL points to a pyx-memory instance server; hosted pyx-memory access uses MCP.`,
+          res.status
+        );
+      }
       throw new MemoryServerError(body?.error ?? `Memory server error: ${res.status}`, res.status);
     }
     return body.data;

package/dist/{chunk-425XJ6JV.mjs → chunk-X3QODOJV.mjs}

@@ -1,6 +1,6 @@
 import {
   MemoryClient
-} from "./chunk-672SGW22.mjs";
+} from "./chunk-3QDXACBV.mjs";
 
 // ../dashboard/src/aggregations/consolidation-analytics.ts
 function analyzeConsolidationLog(entries) {

package/dist/cli/pyx-mem.mjs

@@ -835,7 +835,7 @@ function createProxyServer(client, version, uploadLocalFile) {
   return server;
 }
 async function runMcpProxyServer(opts) {
-  const version = opts.version ?? (true ? "1.16.1" : "0.0.0-dev");
+  const version = opts.version ?? (true ? "1.16.3" : "0.0.0-dev");
   const read = await opts.readCredentials();
   if (!read.ok) {
     const text = read.result.content.map((c) => c.type === "text" ? c.text : "").join(" ").trim();

package/dist/dashboard.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-425XJ6JV.mjs";
-import "./chunk-672SGW22.mjs";
+} from "./chunk-X3QODOJV.mjs";
+import "./chunk-3QDXACBV.mjs";
 import "./chunk-A3L46P2G.mjs";
 export {
   DashboardClient,

package/dist/data-plane-contract.mjs

@@ -19,6 +19,7 @@ var DATA_PLANE_COMPILER_LIMITS = {
   profileContentBytes: 8192
 };
 var MEMORY_TYPES = ["short-term", "long-term", "working", "episodic", "summary"];
+var ENTRY_STATUSES = ["active", "superseded", "archived"];
 var SENSITIVITY_LEVELS = ["public", "internal", "secret"];
 var PRINCIPAL_KINDS = ["api_key", "user"];
 var TENANT_MODES = ["single", "multi"];
@@ -300,6 +301,34 @@ function normalizeEntitySynthesisGet(input, mcp) {
     requireEnum(value.entityType, ENTITY_TYPES, "input.entityType");
   return { name };
 }
+var LIST_CURSOR_MAX_TOKEN_CHARS = 4096;
+var BASE64URL_TOKEN_RE = /^[A-Za-z0-9_-]+$/;
+var ISO_DATE_TIME_PREFIX_RE = /^\d{4}-\d{2}-\d{2}T/;
+function parseListCursorToken(token) {
+  if (token.length === 0 || token.length > LIST_CURSOR_MAX_TOKEN_CHARS) {
+    throw new Error("cursor token is empty or exceeds the size bound");
+  }
+  if (!BASE64URL_TOKEN_RE.test(token)) {
+    throw new Error("cursor token contains non-base64url characters");
+  }
+  let decoded;
+  try {
+    decoded = JSON.parse(Buffer.from(token, "base64url").toString("utf8"));
+  } catch {
+    throw new Error("cursor token is not base64url-encoded JSON");
+  }
+  if (typeof decoded !== "object" || decoded === null || Array.isArray(decoded)) {
+    throw new Error("cursor token payload must be an object");
+  }
+  const { c, i } = decoded;
+  if (typeof c !== "string" || !ISO_DATE_TIME_PREFIX_RE.test(c) || Number.isNaN(Date.parse(c))) {
+    throw new Error("cursor token field `c` must be an ISO-8601 timestamp");
+  }
+  if (typeof i !== "string" || i.length === 0) {
+    throw new Error("cursor token field `i` must be a non-empty entry id");
+  }
+  return { createdAt: c, id: i };
+}
 function normalizeRestList(input) {
   const value = requireObject(input, "input");
   requireExactKeys(value, ["limit", "offset", "type"], "input");
@@ -335,21 +364,42 @@ function normalizeRestGet(input) {
   }
   return normalized;
 }
+function normalizeMcpListEntries(value, normalized) {
+  if (value.since !== void 0) requireString(value.since, "input.since", { nonempty: false });
+  withOptional(normalized, "status", optionalEnum(value.status, ENTRY_STATUSES, "input.status"));
+  if (value.cursor !== void 0) {
+    if (value.page !== void 0) {
+      throw new Error("input.cursor and input.page are mutually exclusive");
+    }
+    if (typeof value.cursor !== "string") throw new Error("input.cursor must be a string");
+    parseListCursorToken(value.cursor);
+    normalized.cursor = value.cursor;
+  } else {
+    normalized.page = optionalInteger(value.page, "input.page", 1, Number.MAX_SAFE_INTEGER) ?? 1;
+  }
+  normalized.limit = optionalClampedPositiveInteger(value.limit, "input.limit", 100) ?? 20;
+  withOptional(
+    normalized,
+    "agentId",
+    normalizeAgentId(value.agentId, "input.agentId", null, false)
+  );
+}
 function normalizeMcpList(input, defaultAgentId) {
   const value = requireObject(input, "input");
-  requireExactKeys(value, ["mode", "page", "limit", "type", "agentId", "since"], "input");
+  requireExactKeys(
+    value,
+    ["mode", "page", "limit", "cursor", "status", "type", "agentId", "since"],
+    "input"
+  );
   const mode = value.mode === void 0 ? "entries" : requireEnum(value.mode, ["entries", "log"], "input.mode");
+  if (mode === "log") {
+    if (value.cursor !== void 0) throw new Error("input.cursor is only valid in entries mode");
+    if (value.status !== void 0) throw new Error("input.status is only valid in entries mode");
+  }
   const normalized = { mode };
   withOptional(normalized, "type", optionalEnum(value.type, MEMORY_TYPES, "input.type"));
   if (mode === "entries") {
-    if (value.since !== void 0) requireString(value.since, "input.since", { nonempty: false });
-    normalized.page = optionalInteger(value.page, "input.page", 1, Number.MAX_SAFE_INTEGER) ?? 1;
-    normalized.limit = optionalClampedPositiveInteger(value.limit, "input.limit", 100) ?? 20;
-    withOptional(
-      normalized,
-      "agentId",
-      normalizeAgentId(value.agentId, "input.agentId", null, false)
-    );
+    normalizeMcpListEntries(value, normalized);
   } else {
     if (value.page !== void 0)
       requireInteger(value.page, "input.page", 1, Number.MAX_SAFE_INTEGER);

package/dist/index.mjs

@@ -15,7 +15,7 @@ import {
   TAXONOMY_MAX_CATEGORIES,
   VectorProvider,
   projectSearchResponseForMcp
-} from "./chunk-672SGW22.mjs";
+} from "./chunk-3QDXACBV.mjs";
 import {
   mergeExtractedEntities,
   normalizeGraphLabel,

package/dist/react.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-425XJ6JV.mjs";
-import "./chunk-672SGW22.mjs";
+} from "./chunk-X3QODOJV.mjs";
+import "./chunk-3QDXACBV.mjs";
 import "./chunk-A3L46P2G.mjs";
 
 // ../dashboard/src/hooks/use-consolidation-log.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyxmate/memory",
-  "version": "1.16.1",
+  "version": "1.16.3",
   "type": "module",
   "description": "SDK for pyx-memory — Memory as a Service for AI agents",
   "license": "MIT",