@pyxmate/memory 1.16.0 → 1.16.2

package/dist/cli/pyx-mem.mjs

@@ -168,6 +168,7 @@ function getDefaultKeychain() {
 }
 
 // src/cli/probe.ts
+import { randomUUID } from "crypto";
 var PROBE_PATH = "/api/memory/entries?limit=1";
 var PROBE_TIMEOUT_MS = 8e3;
 async function probeCredentials(args) {
@@ -175,10 +176,15 @@ async function probeCredentials(args) {
   const url = `${args.endpoint}${PROBE_PATH}`;
   const ctl = new AbortController();
   const timer = setTimeout(() => ctl.abort(), PROBE_TIMEOUT_MS);
+  const idempotencyKey = `cli-probe-${randomUUID()}`;
   try {
     const res = await fetcher(url, {
       method: "GET",
-      headers: { Authorization: `Bearer ${args.apiKey}`, Accept: "application/json" },
+      headers: {
+        Authorization: `Bearer ${args.apiKey}`,
+        Accept: "application/json",
+        "Idempotency-Key": idempotencyKey
+      },
       signal: ctl.signal
     });
     if (res.status === 401 || res.status === 403) return { kind: "invalid", status: res.status };
@@ -551,7 +557,7 @@ function createReadCredentials(providerFactory) {
 }
 
 // src/mcp/proxy-server.ts
-import { createHash, randomUUID } from "crypto";
+import { createHash, randomUUID as randomUUID2 } from "crypto";
 import { readFile, stat } from "fs/promises";
 import { basename, isAbsolute, resolve } from "path";
 import { Client as McpClient } from "@modelcontextprotocol/sdk/client/index.js";
@@ -687,7 +693,7 @@ var LOCAL_UPLOAD_META_KEY = "pyx.dev/local-upload";
 
 // src/mcp/proxy-server.ts
 var REMOTE_MCP_PATH = "/mcp";
-function createMcpIdempotentFetch(fetchImpl = fetch, sessionNonce = randomUUID()) {
+function createMcpIdempotentFetch(fetchImpl = fetch, sessionNonce = randomUUID2()) {
   const wrapped = async (input, init) => {
     const upstream = input instanceof Request ? input : new Request(String(input), init);
     const method = init?.method ?? upstream.method;
@@ -829,7 +835,7 @@ function createProxyServer(client, version, uploadLocalFile) {
   return server;
 }
 async function runMcpProxyServer(opts) {
-  const version = opts.version ?? (true ? "1.16.0" : "0.0.0-dev");
+  const version = opts.version ?? (true ? "1.16.2" : "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/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/package.json

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