@pyxmate/memory 1.15.1 → 1.16.0

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

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

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

@@ -10,6 +10,58 @@ var DEFAULTS = {
 };
 var TAXONOMY_MAX_CATEGORIES = 10;
 
+// ../shared/src/mcp/search-response.ts
+var STRIPPED_ENTRY_FIELDS = /* @__PURE__ */ new Set(["contentHash", "embedding", "tenantId", "userId", "teamId"]);
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function compactEntryForMcp(entry, vectorSimilarity) {
+  if (!isRecord(entry)) return entry;
+  const projected = {};
+  for (const [key, value] of Object.entries(entry)) {
+    if (!STRIPPED_ENTRY_FIELDS.has(key)) projected[key] = value;
+  }
+  if (vectorSimilarity !== void 0) projected.vectorSimilarity = vectorSimilarity;
+  return projected;
+}
+function vectorSimilarityByEntryId(payload) {
+  const similarities = /* @__PURE__ */ new Map();
+  const scoredEntries = Array.isArray(payload.scoredEntries) ? payload.scoredEntries : [];
+  for (const scored of scoredEntries) {
+    if (!isRecord(scored) || !isRecord(scored.entry)) continue;
+    const id = scored.entry.id;
+    if (typeof id === "string" && typeof scored.vectorSimilarity === "number") {
+      similarities.set(id, scored.vectorSimilarity);
+    }
+  }
+  return similarities;
+}
+function projectSearchResultRecord(payload) {
+  const similarities = vectorSimilarityByEntryId(payload);
+  const projected = {};
+  for (const [key, value] of Object.entries(payload)) {
+    if (key === "scoredEntries") continue;
+    if (key === "entries" && Array.isArray(value)) {
+      projected.entries = value.map(
+        (entry) => compactEntryForMcp(
+          entry,
+          isRecord(entry) && typeof entry.id === "string" ? similarities.get(entry.id) : void 0
+        )
+      );
+    } else {
+      projected[key] = value;
+    }
+  }
+  return projected;
+}
+function projectSearchResponseForMcp(payload) {
+  if (!isRecord(payload)) return payload;
+  if (isRecord(payload.data) && ("entries" in payload.data || "scoredEntries" in payload.data)) {
+    return { ...payload, data: projectSearchResultRecord(payload.data) };
+  }
+  return projectSearchResultRecord(payload);
+}
+
 // ../shared/src/types/isolation.ts
 var NamespaceIsolation = {
   SHARED: "shared",
@@ -100,8 +152,10 @@ var DisabledMemory = class {
     return {
       entries: [],
       totalCount: 0,
-      page: params.page ?? 1,
-      limit: params.limit ?? DEFAULT_PAGE_LIMIT
+      // Mirror the real contract's shape: a keyset walk has no page number.
+      ...params.cursor == null ? { page: params.page ?? 1 } : {},
+      limit: params.limit ?? DEFAULT_PAGE_LIMIT,
+      nextCursor: null
     };
   }
   async get() {
@@ -305,6 +359,8 @@ var MemoryClient = class {
     const searchParams = new URLSearchParams();
     if (params.page != null) searchParams.set("page", String(params.page));
     if (params.limit != null) searchParams.set("limit", String(params.limit));
+    if (params.cursor != null) searchParams.set("cursor", params.cursor);
+    if (params.status != null) searchParams.set("status", params.status);
     if (params.type) searchParams.set("type", params.type);
     if (params.agentId) searchParams.set("agentId", params.agentId);
     if (params.includeKinds && params.includeKinds.length > 0) {
@@ -959,6 +1015,7 @@ var MemoryClient = class {
 export {
   DEFAULTS,
   TAXONOMY_MAX_CATEGORIES,
+  projectSearchResponseForMcp,
   NamespaceIsolation,
   MemoryType,
   SensitivityLevel,

package/dist/cli/pyx-mem.mjs

@@ -829,7 +829,7 @@ function createProxyServer(client, version, uploadLocalFile) {
   return server;
 }
 async function runMcpProxyServer(opts) {
-  const version = opts.version ?? (true ? "1.15.1" : "0.0.0-dev");
+  const version = opts.version ?? (true ? "1.16.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/dashboard.mjs

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

package/dist/data-plane-contract.mjs

@@ -317,6 +317,16 @@ function normalizeGet(input) {
     id: requireString(value.id, "input.id", { maxBytes: DATA_PLANE_COMPILER_LIMITS.identityBytes })
   };
 }
+function normalizeMcpDelete(input) {
+  const value = requireObject(input, "input");
+  requireExactKeys(value, ["id", "reason"], "input");
+  return {
+    id: requireString(value.id, "input.id", {
+      maxBytes: DATA_PLANE_COMPILER_LIMITS.identityBytes
+    }),
+    reason: requireString(value.reason, "input.reason")
+  };
+}
 function normalizeRestGet(input) {
   const normalized = normalizeGet(input);
   const id = normalized.id;
@@ -373,15 +383,12 @@ function normalizeProfile(input, write, defaultAgentId) {
   }
   return normalized;
 }
-function normalizeDue(input) {
+function normalizeDue(input, context) {
   const value = requireObject(input, "input");
-  requireExactKeys(value, ["from", "to", "limit"], "input");
-  const from = requireCanonicalIso(value.from, "input.from");
-  const to = requireCanonicalIso(value.to, "input.to");
-  const duration = Date.parse(to) - Date.parse(from);
-  if (duration < 864e5 || duration > 370 * 864e5 || duration % 864e5 !== 0) {
-    throw new Error("input.to must be 1-370 fixed 24-hour periods after input.from");
-  }
+  requireExactKeys(value, ["windowDays", "from", "limit"], "input");
+  const windowDays = requireInteger(value.windowDays, "input.windowDays", 1, 370);
+  const from = value.from === void 0 ? context.resolvedAt : normalizeIso(value.from, "input.from");
+  const to = new Date(Date.parse(from) + windowDays * 864e5).toISOString();
   const normalized = {
     from,
     to,
@@ -416,7 +423,10 @@ function normalizeGraphEntities(value) {
     requireExactKeys(entity, ["name", "type", "properties"], `input.entities[${index}]`);
     const normalized = {
       name: requireString(entity.name, `input.entities[${index}].name`),
-      type: requireEnum(entity.type, ENTITY_TYPES, `input.entities[${index}].type`)
+      type: normalizeGraphLabel(
+        requireString(entity.type, `input.entities[${index}].type`, { maxBytes: 100 }),
+        "CONCEPT"
+      )
     };
     if (entity.properties !== void 0) {
       normalized.properties = canonicalValue(
@@ -472,7 +482,7 @@ function normalizeStore(input, context, mcp) {
   ];
   requireExactKeys(
     value,
-    mcp ? [...common, "topic", "project", "triples", "entitiesOnly"] : [...common, "metadata", "id"],
+    mcp ? [...common, "topic", "project", "triples", "entitiesOnly"] : [...common, "metadata"],
     "input"
   );
   if (value.namespaceId !== void 0 && value.namespaceId !== context.scope.namespaceId) {
@@ -494,7 +504,6 @@ function normalizeStore(input, context, mcp) {
     ingestTime: context.resolvedAt,
     extractEntities: false
   };
-  if (!mcp && value.id !== void 0) normalized.id = requireString(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"));
@@ -535,7 +544,7 @@ function normalizeStore(input, context, mcp) {
   }
   const uniqueEntities = /* @__PURE__ */ new Map();
   for (const entity of entities) {
-    const key = normalizeNameKey(entity.name);
+    const key = `${normalizeNameKey(entity.name)}\0${entity.type}`;
     if (!uniqueEntities.has(key)) uniqueEntities.set(key, entity);
   }
   const uniqueRelationships = /* @__PURE__ */ new Map();
@@ -547,6 +556,26 @@ function normalizeStore(input, context, mcp) {
     ].join("\0");
     if (!uniqueRelationships.has(key)) uniqueRelationships.set(key, relationship);
   }
+  const graphTargeted = normalized.targets.includes(
+    "graph"
+  );
+  const entityNames = new Set(
+    [...uniqueEntities.values()].map(
+      (entity) => normalizeNameKey(entity.name)
+    )
+  );
+  const hasResolvableRelationship = [...uniqueRelationships.values()].some((relationship) => {
+    const value2 = relationship;
+    const source = normalizeNameKey(value2.source);
+    const target = normalizeNameKey(value2.target);
+    return source !== target && entityNames.has(source) && entityNames.has(target);
+  });
+  const entitiesOnly = mcp && value.entitiesOnly !== void 0 ? requireBoolean(value.entitiesOnly, "input.entitiesOnly") : false;
+  if (mcp && graphTargeted && uniqueEntities.size >= 2 && !hasResolvableRelationship && !entitiesOnly) {
+    throw new Error(
+      "GRAPH_RELATIONSHIPS_REQUIRED: graph stores with two or more entities require a relationship that connects declared entity names, or entitiesOnly=true"
+    );
+  }
   if (uniqueEntities.size > 0) normalized.entities = [...uniqueEntities.values()];
   if (uniqueRelationships.size > 0) {
     normalized.relationships = [...uniqueRelationships.values()];
@@ -556,14 +585,14 @@ function normalizeStore(input, context, mcp) {
 function normalizeBatchStore(input, context) {
   const value = requireObject(input, "input");
   requireExactKeys(value, ["entries"], "input");
-  if (!Array.isArray(value.entries) || value.entries.length < 1 || value.entries.length > 32) {
-    throw new Error("input.entries must contain 1-32 entries");
+  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, index) => {
-      const normalized = normalizeStore(entry, context, false);
-      return { ...normalized, batchIndex: index };
-    })
+    entries: value.entries.map((entry, batchIndex) => ({
+      ...normalizeStore(entry, context, false),
+      batchIndex
+    }))
   };
 }
 function normalizeSearch(input, mcp) {
@@ -624,7 +653,7 @@ function normalizeSearch(input, mcp) {
   }
   return normalized;
 }
-function normalizeLineage(input) {
+function normalizeLineage(input, mcp) {
   const value = requireObject(input, "input");
   requireExactKeys(
     value,
@@ -657,11 +686,7 @@ function normalizeLineage(input) {
       normalizeIso(value.eventTimeEnd, "input.eventTimeEnd")
     ];
   }
-  withOptional(
-    normalized,
-    "limit",
-    optionalClampedPositiveInteger(value.limit, "input.limit", 100)
-  );
+  normalized.limit = mcp ? optionalInteger(value.limit, "input.limit", 1, 200) ?? 50 : normalizeRestLimit(value.limit, "input.limit", 200);
   return normalized;
 }
 function normalizeReinforce(input) {
@@ -692,7 +717,7 @@ function normalizeGraphRead(input, operation) {
   if (operation === "rest:graph_nodes") {
     requireExactKeys(value, ["name", "type", "limit"], "input");
     const normalized = {
-      limit: optionalClampedPositiveInteger(value.limit, "input.limit", 1e5) ?? 50
+      limit: optionalClampedPositiveInteger(value.limit, "input.limit", 1e3) ?? 100
     };
     withOptional(normalized, "name", optionalNonemptyString(value.name, "input.name"));
     withOptional(normalized, "type", optionalNonemptyString(value.type, "input.type"));
@@ -704,7 +729,7 @@ function normalizeGraphRead(input, operation) {
     [field]: optionalClampedPositiveInteger(
       value[field],
       `input.${field}`,
-      operation === "rest:graph_subgraph" ? 1e4 : 5e5
+      operation === "rest:graph_subgraph" ? 1e4 : 1e3
     ) ?? (operation === "rest:graph_subgraph" ? 2e3 : 200)
   };
 }
@@ -745,14 +770,16 @@ function normalizeSupportedInput(operation, input, context) {
     case "mcp:search_memories":
       return normalizeSearch(input, true);
     case "rest:lineage":
+      return normalizeLineage(input, false);
     case "mcp:lineage":
-      return normalizeLineage(input);
+      return normalizeLineage(input, true);
     case "rest:reinforce":
     case "mcp:reinforce":
       return normalizeReinforce(input);
     case "rest:delete":
-    case "mcp:delete_memory":
       return normalizeGet(input);
+    case "mcp:delete_memory":
+      return normalizeMcpDelete(input);
     case "rest:graph_nodes":
     case "rest:graph_relationships":
     case "rest:graph_subgraph":
@@ -793,7 +820,7 @@ function normalizeSupportedInput(operation, input, context) {
     case "mcp:fetch_applicable_corrections":
       return normalizeCorrectionFetch(input, false);
     case "mcp:fetch_due_facts":
-      return normalizeDue(input);
+      return normalizeDue(input, context);
     case "mcp:summarize_memory_entity":
       return normalizeEntitySynthesisGet(input, true);
   }

package/dist/index.d.ts

@@ -6,6 +6,20 @@ interface MemoryListParams {
     page?: number;
     /** Entries per page (1–100). Default: 20 */
     limit?: number;
+    /**
+     * Opaque keyset-pagination token from a previous result's `nextCursor`.
+     * Guarantees exactly-once traversal even while strictly-newer entries
+     * are being written (offset/page pagination can repeat or skip there).
+     * A cursor is only valid for the same filter set that produced it.
+     * Mutually exclusive with `page` — supplying both is an error. Not a
+     * snapshot: rows backdated behind the cursor position can still appear.
+     */
+    cursor?: string;
+    /**
+     * Opt-in lifecycle-status filter. Omitted preserves today's behavior:
+     * active, superseded, and archived entries are all returned.
+     */
+    status?: 'active' | 'superseded' | 'archived';
     /** Filter by memory type. */
     type?: MemoryType$1;
     /** Filter by agent ID. */
@@ -35,8 +49,11 @@ interface MemoryListParams {
 interface MemoryListResult {
     entries: MemoryEntry$1[];
     totalCount: number;
-    page: number;
+    /** Present in page/offset mode only — a keyset traversal has no page number. */
+    page?: number;
     limit: number;
+    /** Keyset token for the next page; null when this page is the last. */
+    nextCursor: string | null;
 }
 /** Filters for temporal queries (queryAsOf, queryByEventTime). */
 interface TemporalQueryFilters {
@@ -1163,6 +1180,11 @@ interface MemoryStats {
     usageHygiene?: UsageHygieneSnapshot;
     /** Whether the memory service is connected. False when using DisabledMemory. */
     connected?: boolean;
+    /**
+     * Deferred-embed queue depth. The in-process core always reports it (0 when
+     * idle); absent means unknown (older server or disabled client), never 0.
+     */
+    pendingEmbeddings?: number;
 }
 interface GraphRepairResult {
     staleEdgesDeleted: number;
@@ -1271,6 +1293,8 @@ declare function mergeExtractedEntities(callerEntities: IngestEntity[] | undefin
     relationships: IngestRelationship[];
 };
 
+declare function projectSearchResponseForMcp(payload: unknown): unknown;
+
 interface ApiResponse<T> {
     success: boolean;
     data?: T;
@@ -1557,4 +1581,4 @@ interface CreatePyxMemoryOptions {
 }
 declare function createPyxMemory(opts?: CreatePyxMemoryOptions): MemoryClient;
 
-export { type AgentId, type ApiResponse, type ConsolidationRunResult, type CorrectionInput, type CorrectionRecord, type CreatePyxMemoryOptions, DEFAULTS, DEPRECATED_RAG_STRATEGIES, DisabledMemory, type DroppedGraphRelationship, type DueScanInput, EmbeddingProviderName, type EnrichmentCallbacks, type EntityExtractionResult, type ExtendedMemoryInterface, type FetchCorrectionsInput, type GraphEnrichment, type GraphEnrichmentStatus, type GraphFailureMode, type GraphNode, type GraphRelationship, type GraphRepairResult, type GraphTelemetrySnapshot, type GraphTraversalResult, type IngestEntity, type IngestErrorEvent, type IngestEvent, type IngestFileOptions, type IngestHeartbeatEvent, type IngestProgressEvent, type IngestRelationship, type IngestResultEvent, type IngestStage, type IngestionResult, type LineageParams, type LineageResult, type LineageVersion, MemoryClient, type MemoryClientOptions, type MemoryEntry, type MemoryIngestRequest, type MemoryInterface, type MemoryListParams, type MemoryListResult, type MemoryLogFilters, type MemorySearchParams, type MemorySearchResult, MemoryServerError, type MemoryStats, MemoryType, type MoveEntriesFilter, MoveFailureReason, type MoveResult, type MoveTarget, NamespaceIsolation, type PrincipalContext, RAGStrategy, type ReinforceParams, type ReinforceResult, type ReinforceSignal, SINGLE_TENANT_ID, SensitivityLevel, type SourceEvidence, type StoreInput, StoreTarget, TAXONOMY_MAX_CATEGORIES, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, type Topology, type TopologyExtractionProvider, type TopologyServiceVariant, type UsageHygieneSnapshot, VectorProvider, type VectorStatus, type WikiLintReport, createPyxMemory, mergeExtractedEntities, normalizeGraphLabel, normalizeNameKey };
+export { type AgentId, type ApiResponse, type ConsolidationRunResult, type CorrectionInput, type CorrectionRecord, type CreatePyxMemoryOptions, DEFAULTS, DEPRECATED_RAG_STRATEGIES, DisabledMemory, type DroppedGraphRelationship, type DueScanInput, EmbeddingProviderName, type EnrichmentCallbacks, type EntityExtractionResult, type ExtendedMemoryInterface, type FetchCorrectionsInput, type GraphEnrichment, type GraphEnrichmentStatus, type GraphFailureMode, type GraphNode, type GraphRelationship, type GraphRepairResult, type GraphTelemetrySnapshot, type GraphTraversalResult, type IngestEntity, type IngestErrorEvent, type IngestEvent, type IngestFileOptions, type IngestHeartbeatEvent, type IngestProgressEvent, type IngestRelationship, type IngestResultEvent, type IngestStage, type IngestionResult, type LineageParams, type LineageResult, type LineageVersion, MemoryClient, type MemoryClientOptions, type MemoryEntry, type MemoryIngestRequest, type MemoryInterface, type MemoryListParams, type MemoryListResult, type MemoryLogFilters, type MemorySearchParams, type MemorySearchResult, MemoryServerError, type MemoryStats, MemoryType, type MoveEntriesFilter, MoveFailureReason, type MoveResult, type MoveTarget, NamespaceIsolation, type PrincipalContext, RAGStrategy, type ReinforceParams, type ReinforceResult, type ReinforceSignal, SINGLE_TENANT_ID, SensitivityLevel, type SourceEvidence, type StoreInput, StoreTarget, TAXONOMY_MAX_CATEGORIES, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, type Topology, type TopologyExtractionProvider, type TopologyServiceVariant, type UsageHygieneSnapshot, VectorProvider, type VectorStatus, type WikiLintReport, createPyxMemory, mergeExtractedEntities, normalizeGraphLabel, normalizeNameKey, projectSearchResponseForMcp };

package/dist/index.mjs

@@ -13,8 +13,9 @@ import {
   SensitivityLevel,
   StoreTarget,
   TAXONOMY_MAX_CATEGORIES,
-  VectorProvider
-} from "./chunk-IEBF7BQF.mjs";
+  VectorProvider,
+  projectSearchResponseForMcp
+} from "./chunk-672SGW22.mjs";
 import {
   mergeExtractedEntities,
   normalizeGraphLabel,
@@ -53,5 +54,6 @@ export {
   createPyxMemory,
   mergeExtractedEntities,
   normalizeGraphLabel,
-  normalizeNameKey
+  normalizeNameKey,
+  projectSearchResponseForMcp
 };

package/dist/react.mjs

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

package/package.json

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