@pyxmate/memory 0.31.3 → 0.32.0

package/README.md

@@ -14,7 +14,7 @@ This package ships:
 ## Install
 
 ```bash
-npm install -g @pyxmate/memory
+npm install -g @pyxmate/memory@latest
 # or, in a project:
 npm install @pyxmate/memory
 ```
@@ -32,9 +32,11 @@ pyx-mem login
 pyx-mem mcp install claude-code --scope user
 ```
 
-Restart Claude Code. The 7 memory tools (`search_memories`, `store_memory`,
-`get_memory`, `list_memories`, `delete_memory`, `ingest_memory_file`,
-`summarize_memory_entity`) are auto-discovered via MCP Tool Search.
+Restart Claude Code. The MCP tools are auto-discovered via MCP Tool Search:
+`search_memories`, `store_memory`, `get_memory`, `list_memories`,
+`delete_memory`, `ingest_memory_file`, `summarize_memory_entity`, `status`,
+`get_user_profile`, `upsert_user_profile`, `record_correction`, and
+`fetch_applicable_corrections`.
 
 **That's the whole setup** — no extra server-side LLM API keys. Graph is a
 relational retrieval dimension, not a search-score boost. When content names

package/dist/{chunk-27RJJTZH.mjs → chunk-6DZN7FYM.mjs}

@@ -1,6 +1,6 @@
 import {
   mergeExtractedEntities
-} from "./chunk-I45LGUJR.mjs";
+} from "./chunk-KSTI4M52.mjs";
 
 // ../client/src/memory-client.ts
 var MemoryServerError = class extends Error {

package/dist/{chunk-I45LGUJR.mjs → chunk-KSTI4M52.mjs}

@@ -6,6 +6,10 @@ var DEFAULTS = {
 };
 
 // ../shared/src/graph/extraction.ts
+function normalizeGraphLabel(value, fallback) {
+  const normalized = value.trim().toUpperCase().replace(/[^A-Z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+  return normalized.length > 0 ? normalized : fallback;
+}
 function mergeExtractedEntities(callerEntities, callerRelationships, extracted) {
   const entities = [...callerEntities ?? []];
   const relationships = [...callerRelationships ?? []];
@@ -17,14 +21,19 @@ function mergeExtractedEntities(callerEntities, callerRelationships, extracted)
   for (const entity of extracted.entities) {
     const key = entity.name.toLowerCase();
     if (nameByLowercase.has(key)) continue;
-    entities.push(entity);
+    entities.push({ ...entity, type: normalizeGraphLabel(entity.type, "CONCEPT") });
     nameByLowercase.set(key, entity.name);
   }
   for (const relationship of extracted.relations) {
     const source = nameByLowercase.get(relationship.source.toLowerCase());
     const target = nameByLowercase.get(relationship.target.toLowerCase());
     if (source && target) {
-      relationships.push({ ...relationship, source, target });
+      relationships.push({
+        ...relationship,
+        source,
+        target,
+        type: normalizeGraphLabel(relationship.type, "RELATED_TO")
+      });
     }
   }
   return { entities, relationships };
@@ -100,6 +109,7 @@ var SINGLE_TENANT_ID = "_single";
 
 export {
   DEFAULTS,
+  normalizeGraphLabel,
   mergeExtractedEntities,
   NamespaceIsolation,
   MemoryType,

package/dist/{chunk-HXF7EXXP.mjs → chunk-W5FHHTBQ.mjs}

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

package/dist/cli/pyx-mem.mjs

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 import {
-  mergeExtractedEntities
-} from "../chunk-I45LGUJR.mjs";
+  mergeExtractedEntities,
+  normalizeGraphLabel
+} from "../chunk-KSTI4M52.mjs";
 
 // src/cli/exit-codes.ts
 var EXIT = {
@@ -1108,14 +1109,14 @@ var ExtractionSchema = z9.object({
   entities: z9.array(
     z9.object({
       name: z9.string().min(1),
-      type: z9.enum(ENTITY_TYPES)
+      type: z9.string().min(1).transform((value) => normalizeGraphLabel(value, "CONCEPT"))
     })
   ),
   relations: z9.array(
     z9.object({
       source: z9.string().min(1),
       target: z9.string().min(1),
-      type: z9.enum(RELATION_TYPES)
+      type: z9.string().min(1).transform((value) => normalizeGraphLabel(value, "RELATED_TO"))
     })
   )
 });
@@ -1123,8 +1124,9 @@ function buildExtractionPrompt(content) {
   return [
     "Extract graph facts as JSON only. No prose, no fences, no commentary.",
     `Schema: {"entities":[{"name":string,"type":EntityType}],"relations":[{"source":string,"target":string,"type":RelationType}]}.`,
-    `EntityType values: ${ENTITY_TYPES.join(", ")}.`,
-    `RelationType values: ${RELATION_TYPES.join(", ")}.`,
+    `Prefer EntityType values when applicable: ${ENTITY_TYPES.join(", ")}.`,
+    `Prefer RelationType values when applicable: ${RELATION_TYPES.join(", ")}.`,
+    "Emergent domain-specific labels are allowed; use uppercase words separated by underscores.",
     "Include only entities/relations explicitly named or strongly implied in the content. Empty arrays are valid.",
     `Content: ${content}`
   ].join("\n");
@@ -1324,7 +1326,7 @@ var ALL_TOOL_NAMES = ALL_TOOLS.map((t) => t.name);
 // src/mcp/server.ts
 async function runMcpServer(opts) {
   const fetchImpl = opts.fetchImpl ?? fetch;
-  const version = opts.version ?? (true ? "0.31.3" : "0.0.0-dev");
+  const version = opts.version ?? (true ? "0.32.0" : "0.0.0-dev");
   const server = new McpServer(
     { name: "pyx-memory", version },
     { instructions: PYX_MEMORY_INSTRUCTIONS, capabilities: { tools: {} } }

package/dist/dashboard.mjs

@@ -11,9 +11,9 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-HXF7EXXP.mjs";
-import "./chunk-27RJJTZH.mjs";
-import "./chunk-I45LGUJR.mjs";
+} from "./chunk-W5FHHTBQ.mjs";
+import "./chunk-6DZN7FYM.mjs";
+import "./chunk-KSTI4M52.mjs";
 export {
   DashboardClient,
   Poller,

package/dist/index.d.ts

@@ -594,6 +594,8 @@ interface MemorySearchResult {
     entries: MemoryEntry[];
     totalCount: number;
     strategy: RAGStrategy;
+    /** Visible graph slice that supported the returned entries, when graph traversal contributed. */
+    graph?: GraphTraversalResult;
     /** Optional scored entries with relevance scores for ranked results. */
     scoredEntries?: Array<{
         entry: MemoryEntry;
@@ -616,6 +618,20 @@ interface MemorySearchResult {
         };
     };
 }
+interface SourceEvidence {
+    /** Memory entry that produced this graph fact. */
+    memoryEntryId: string;
+    /** Namespace of the source memory entry. `null` = legacy / tenant-root. */
+    namespaceId?: string | null;
+    /** Optional source identifier copied from the memory entry or caller. */
+    source?: string;
+    /** Optional content hash copied from the memory entry or caller. */
+    contentHash?: string;
+    /** Optional short text evidence for the graph fact. */
+    snippet?: string;
+    /** When this evidence was recorded. */
+    createdAt?: Timestamp;
+}
 declare const StoreTarget: {
     readonly SQLITE: "sqlite";
     readonly VECTOR: "vector";
@@ -628,6 +644,10 @@ interface IngestEntity {
     name: string;
     /** Entity type — freeform, agent decides (e.g., "PERSON", "TOOL"). */
     type: string;
+    /** Stable canonical identifier. Defaults to a deterministic name+type id. */
+    canonicalId?: string;
+    /** Source evidence for this graph node. Defaults to the containing memory entry. */
+    sourceEvidence?: SourceEvidence[];
     /** Optional properties to attach to the graph node. */
     properties?: Record<string, unknown>;
 }
@@ -639,6 +659,8 @@ interface IngestRelationship {
     target: string;
     /** Relationship type — freeform, agent decides (e.g., "WORKS_AT", "USES"). */
     type: string;
+    /** Source evidence for this graph edge. Defaults to the containing memory entry. */
+    sourceEvidence?: SourceEvidence[];
     /** Optional properties to attach to the graph edge. */
     properties?: Record<string, unknown>;
 }
@@ -780,6 +802,8 @@ interface GraphNode {
     id: string;
     name: string;
     type: string;
+    canonicalId?: string;
+    sourceEvidence?: SourceEvidence[];
     properties: Record<string, unknown>;
     memoryEntryIds: string[];
 }
@@ -788,6 +812,7 @@ interface GraphRelationship {
     sourceId: string;
     targetId: string;
     type: string;
+    sourceEvidence?: SourceEvidence[];
     properties: Record<string, unknown>;
     memoryEntryId?: string;
     /**
@@ -845,6 +870,7 @@ interface EntityExtractionResult {
         type: string;
     }>;
 }
+declare function normalizeGraphLabel(value: string, fallback: string): string;
 /**
  * Merge caller-provided entities/relationships with LLM-extracted ones.
  *
@@ -1183,4 +1209,4 @@ interface PrincipalContext {
 /** Sentinel tenant ID used in single-tenant deployments. */
 declare const SINGLE_TENANT_ID = "_single";
 
-export { type AgentId, type ApiResponse, type ConsolidationRunResult, type CorrectionInput, type CorrectionRecord, DEFAULTS, DEPRECATED_RAG_STRATEGIES, EmbeddingProviderName, type EnrichmentCallbacks, type EntityExtractionResult, type ExtendedMemoryInterface, type FetchCorrectionsInput, type GraphFailureMode, type GraphNode, type GraphRelationship, type GraphRepairResult, type GraphTraversalResult, type IngestEntity, type IngestErrorEvent, type IngestEvent, type IngestFileOptions, type IngestHeartbeatEvent, type IngestProgressEvent, type IngestRelationship, type IngestResultEvent, type IngestStage, type IngestionResult, 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, SINGLE_TENANT_ID, SensitivityLevel, type StoreInput, StoreTarget, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, type Topology, type TopologyServiceVariant, VectorProvider, type WikiLintReport, mergeExtractedEntities };
+export { type AgentId, type ApiResponse, type ConsolidationRunResult, type CorrectionInput, type CorrectionRecord, DEFAULTS, DEPRECATED_RAG_STRATEGIES, EmbeddingProviderName, type EnrichmentCallbacks, type EntityExtractionResult, type ExtendedMemoryInterface, type FetchCorrectionsInput, type GraphFailureMode, type GraphNode, type GraphRelationship, type GraphRepairResult, type GraphTraversalResult, type IngestEntity, type IngestErrorEvent, type IngestEvent, type IngestFileOptions, type IngestHeartbeatEvent, type IngestProgressEvent, type IngestRelationship, type IngestResultEvent, type IngestStage, type IngestionResult, 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, SINGLE_TENANT_ID, SensitivityLevel, type SourceEvidence, type StoreInput, StoreTarget, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, type Topology, type TopologyServiceVariant, VectorProvider, type WikiLintReport, mergeExtractedEntities, normalizeGraphLabel };

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import {
   MemoryClient,
   MemoryServerError
-} from "./chunk-27RJJTZH.mjs";
+} from "./chunk-6DZN7FYM.mjs";
 import {
   DEFAULTS,
   DEPRECATED_RAG_STRATEGIES,
@@ -14,8 +14,9 @@ import {
   SensitivityLevel,
   StoreTarget,
   VectorProvider,
-  mergeExtractedEntities
-} from "./chunk-I45LGUJR.mjs";
+  mergeExtractedEntities,
+  normalizeGraphLabel
+} from "./chunk-KSTI4M52.mjs";
 export {
   DEFAULTS,
   DEPRECATED_RAG_STRATEGIES,
@@ -30,5 +31,6 @@ export {
   SensitivityLevel,
   StoreTarget,
   VectorProvider,
-  mergeExtractedEntities
+  mergeExtractedEntities,
+  normalizeGraphLabel
 };

package/dist/react.mjs

@@ -11,9 +11,9 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-HXF7EXXP.mjs";
-import "./chunk-27RJJTZH.mjs";
-import "./chunk-I45LGUJR.mjs";
+} from "./chunk-W5FHHTBQ.mjs";
+import "./chunk-6DZN7FYM.mjs";
+import "./chunk-KSTI4M52.mjs";
 
 // ../dashboard/src/hooks/use-consolidation-log.ts
 import { useCallback as useCallback2, useMemo } from "react";

package/package.json

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