@pyxmate/memory 0.31.4 → 0.32.1

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 = {
@@ -810,7 +811,7 @@ var deleteMemoryTool = {
       query: { reason: args.reason },
       scope: args
     });
-    return res.ok ? mcpJson(res.data) : res.result;
+    return res.ok ? mcpJson({ deleted: args.id }) : res.result;
   }
 };
 
@@ -1013,9 +1014,9 @@ var upsertUserProfileTool = {
 import { z as z8 } from "zod";
 var inputShape5 = {
   query: z8.string().min(1).describe("Required natural-language search text."),
-  limit: z8.number().int().min(1).max(100).optional().describe("Maximum results; server clamps to 1\u2013100. Default 5."),
+  limit: z8.number().int().min(1).max(100).optional().describe("Maximum results; server clamps to 1\u2013100. Default 10."),
   strategy: z8.enum(["naive", "graph", "hybrid"]).optional().describe(
-    "RAG strategy. Server default is `naive`; use `hybrid` for cross-encoder reranking, multi-entity decomposition, and confidence scoring."
+    "RAG strategy. Defaults to `hybrid` (cross-encoder reranking, multi-entity decomposition, confidence scoring) and is sent explicitly when omitted; pass `naive` for a lighter vector-only search or `graph` for graph-augmented retrieval."
   ),
   type: z8.enum(["short-term", "long-term", "working", "episodic", "summary"]).optional().describe("Filter by memory type."),
   agentId: z8.string().optional().describe("Filter to memories stored for this agentId."),
@@ -1042,9 +1043,13 @@ var searchMemoriesTool = {
       method: "GET",
       path: "/api/memory/search",
       query: {
-        q: args.query,
+        query: args.query,
         limit: args.limit,
-        strategy: args.strategy,
+        // Force `hybrid` unless the caller explicitly overrides. The server's
+        // own default is hybrid too, but older tenant instances default to
+        // `naive` (1–2 results vs hybrid's 15–20) — sending it explicitly makes
+        // recall deterministic regardless of the instance version.
+        strategy: args.strategy ?? "hybrid",
         type: args.type,
         agentId: args.agentId,
         abstentionThreshold: args.abstentionThreshold,
@@ -1108,14 +1113,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 +1128,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 +1330,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.4" : "0.0.0-dev");
+  const version = opts.version ?? (true ? "0.32.1" : "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.4",
+  "version": "0.32.1",
   "type": "module",
   "description": "SDK for pyx-memory — Memory as a Service for AI agents",
   "license": "MIT",