@pyxmate/memory 1.16.3 → 1.17.0

package/README.md

@@ -56,8 +56,9 @@ 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.
+or a sidecar you run, e.g. `docker run -p 7822:7822 -v memory-data:/data
+ghcr.io/pyx-corp/pyx-memory-v1:latest`). Hosted pyx-memory access uses MCP via
+`pyx-mem mcp` or the `/mcp` endpoint — not this HTTP client.
 
 ```ts
 import { MemoryClient } from '@pyxmate/memory';

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.3" : "0.0.0-dev");
+  const version = opts.version ?? (true ? "1.17.0" : "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

@@ -346,6 +346,18 @@ function normalizeGet(input) {
     id: requireString(value.id, "input.id", { maxBytes: DATA_PLANE_COMPILER_LIMITS.identityBytes })
   };
 }
+var CALLER_ENTRY_ID_RESERVED_PREFIXES = ["synthesis:", "user-profile:", "correction:"];
+function optionalCallerEntryId(value, field) {
+  if (value === void 0) return void 0;
+  const id = requireString(value, field, { maxBytes: DATA_PLANE_COMPILER_LIMITS.identityBytes });
+  if (/\p{Cc}/u.test(id)) throw new Error(`${field} must not contain control characters`);
+  for (const prefix of CALLER_ENTRY_ID_RESERVED_PREFIXES) {
+    if (id.startsWith(prefix)) {
+      throw new Error(`${field} must not use the platform-reserved '${prefix}' id prefix`);
+    }
+  }
+  return id;
+}
 function normalizeMcpDelete(input) {
   const value = requireObject(input, "input");
   requireExactKeys(value, ["id", "reason"], "input");
@@ -356,14 +368,6 @@ function normalizeMcpDelete(input) {
     reason: requireString(value.reason, "input.reason")
   };
 }
-function normalizeRestGet(input) {
-  const normalized = normalizeGet(input);
-  const id = normalized.id;
-  if (typeof id !== "string" || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id)) {
-    throw new Error("input.id must be a valid UUID");
-  }
-  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"));
@@ -513,9 +517,29 @@ function normalizeGraphRelationships(value) {
     return normalized;
   });
 }
+var MCP_SERVER_OWNED_METADATA_KEYS = ["source", "topic", "project", "_kind"];
+function normalizeMcpStoreMetadata(value) {
+  const serverOwned = {
+    source: "agent",
+    topic: requireString(value.topic, "input.topic"),
+    project: requireString(value.project, "input.project")
+  };
+  if (value.metadata === void 0) return serverOwned;
+  const caller = canonicalValue(
+    requireObject(value.metadata, "input.metadata"),
+    "input.metadata"
+  );
+  for (const key of MCP_SERVER_OWNED_METADATA_KEYS) {
+    if (key in caller) {
+      throw new Error(`input.metadata.${key} is server-owned and cannot be caller-supplied`);
+    }
+  }
+  return { ...caller, ...serverOwned };
+}
 function normalizeStore(input, context, mcp) {
   const value = requireObject(input, "input");
   const common = [
+    "id",
     "content",
     "type",
     "targets",
@@ -532,7 +556,7 @@ function normalizeStore(input, context, mcp) {
   ];
   requireExactKeys(
     value,
-    mcp ? [...common, "topic", "project", "triples", "entitiesOnly"] : [...common, "metadata"],
+    mcp ? [...common, "topic", "project", "metadata", "triples", "entitiesOnly"] : [...common, "metadata"],
     "input"
   );
   if (value.namespaceId !== void 0 && value.namespaceId !== context.scope.namespaceId) {
@@ -545,15 +569,12 @@ function normalizeStore(input, context, mcp) {
     content: requireString(value.content, "input.content"),
     type: optionalEnum(value.type, MEMORY_TYPES, "input.type") ?? "long-term",
     targets: normalizeStoreTargets(value.targets),
-    metadata: mcp ? {
-      source: "agent",
-      topic: requireString(value.topic, "input.topic"),
-      project: requireString(value.project, "input.project")
-    } : canonicalValue(value.metadata ?? {}, "input.metadata"),
+    metadata: mcp ? normalizeMcpStoreMetadata(value) : canonicalValue(value.metadata ?? {}, "input.metadata"),
     createdAt: context.resolvedAt,
     ingestTime: context.resolvedAt,
     extractEntities: false
   };
+  withOptional(normalized, "id", optionalCallerEntryId(value.id, "input.id"));
   withOptional(normalized, "source", optionalNonemptyString(value.source, "input.source"));
   withOptional(normalized, "agentId", optionalNonemptyString(value.agentId, "input.agentId"));
   withOptional(normalized, "sessionId", optionalNonemptyString(value.sessionId, "input.sessionId"));
@@ -638,12 +659,19 @@ function normalizeBatchStore(input, context) {
   if (!Array.isArray(value.entries) || value.entries.length < 1 || value.entries.length > 100) {
     throw new Error("input.entries must contain 1-100 entries");
   }
-  return {
-    entries: value.entries.map((entry, batchIndex) => ({
-      ...normalizeStore(entry, context, false),
-      batchIndex
-    }))
-  };
+  const entries = value.entries.map((entry, batchIndex) => ({
+    ...normalizeStore(entry, context, false),
+    batchIndex
+  }));
+  const callerIds = /* @__PURE__ */ new Set();
+  for (const entry of entries) {
+    if (typeof entry.id !== "string") continue;
+    if (callerIds.has(entry.id)) {
+      throw new Error(`input.entries contains duplicate entry id: ${entry.id}`);
+    }
+    callerIds.add(entry.id);
+  }
+  return { entries };
 }
 function normalizeSearch(input, mcp) {
   const value = requireObject(input, "input");
@@ -856,7 +884,7 @@ function normalizeSupportedInput(operation, input, context) {
     case "rest:list":
       return normalizeRestList(input);
     case "rest:get":
-      return normalizeRestGet(input);
+      return normalizeGet(input);
     case "mcp:get_memory":
       return normalizeGet(input);
     case "mcp:list_memories":

package/dist/index.d.ts

@@ -722,6 +722,16 @@ interface MemoryEntry {
      * to NULL (never resurrected to active) if the successor is later forgotten.
      */
     supersededByEntryId?: string;
+    /**
+     * @internal Hosted data-plane only. SHA-256 of the canonical caller store
+     * payload (server-stamped timestamps excluded), persisted for caller-id
+     * stores so a re-send of the same `metadata.dbRef.revision` can be
+     * classified as an idempotent no-op (digest match) or a
+     * `revision_reuse_conflict` (digest mismatch). Graph entities/relationships
+     * are part of the payload but not of the row, so the digest cannot be
+     * recomputed from stored state.
+     */
+    payloadDigest?: string;
 }
 interface MemorySearchParams {
     query: string;

package/package.json

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