@pyxmate/memory 0.12.2 → 0.13.0

package/dist/index.d.ts

@@ -394,6 +394,17 @@ interface IngestRelationship {
     /** Optional properties to attach to the graph edge. */
     properties?: Record<string, unknown>;
 }
+/**
+ * How `Memory.store()` should react when the graph write fails.
+ * - `throw` (default, since v0.13.0): propagate the failure so the caller
+ *   knows the graph is incomplete. Honest contract: a graph write either
+ *   commits or fails loudly. Silent partial-loss was the v0.12.2 bug that
+ *   masked 91/92 dropped entities.
+ * - `best-effort`: swallow the error and log a warning; the entry is still
+ *   considered ingested in SQLite/vector. Use only when you genuinely don't
+ *   need the graph slice and a transient neo4j blip shouldn't fail ingest.
+ */
+type GraphFailureMode = 'throw' | 'best-effort';
 /** Store input: what the agent sends to Memory.store(). */
 type StoreInput = Omit<MemoryEntry, 'id' | 'createdAt'> & {
     id?: string;
@@ -404,6 +415,8 @@ type StoreInput = Omit<MemoryEntry, 'id' | 'createdAt'> & {
     entities?: IngestEntity[];
     /** Agent-provided relationships for graph storage. */
     relationships?: IngestRelationship[];
+    /** Graph-failure handling. Default: "throw" (loud) — see GraphFailureMode. */
+    graphFailureMode?: GraphFailureMode;
 };
 interface MemoryIngestRequest {
     content?: string;
@@ -417,6 +430,8 @@ interface MemoryIngestRequest {
     entities?: IngestEntity[];
     /** Agent-provided relationships for graph storage. */
     relationships?: IngestRelationship[];
+    /** Graph-failure handling. Default: "throw" (loud) — see GraphFailureMode. */
+    graphFailureMode?: GraphFailureMode;
     /** Importance score (1-10). */
     importance?: number;
     /** Source identifier (e.g., filename, URL). */
@@ -477,4 +492,4 @@ interface GraphTraversalResult {
     }>;
 }
 
-export { type AgentId, type ApiResponse, type ConsolidationRunResult, DEFAULTS, EmbeddingProviderName, type EnrichmentCallbacks, type ExtendedMemoryInterface, type GraphNode, type GraphRelationship, type GraphTraversalResult, type IngestEntity, type IngestRelationship, type IngestionResult, MemoryClient, type MemoryClientOptions, type MemoryEntry, type MemoryIngestRequest, type MemoryInterface, type MemoryListParams, type MemoryListResult, type MemorySearchParams, type MemorySearchResult, MemoryServerError, type MemoryStats, MemoryType, RAGStrategy, SensitivityLevel, type StoreInput, StoreTarget, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, VectorProvider };
+export { type AgentId, type ApiResponse, type ConsolidationRunResult, DEFAULTS, EmbeddingProviderName, type EnrichmentCallbacks, type ExtendedMemoryInterface, type GraphFailureMode, type GraphNode, type GraphRelationship, type GraphTraversalResult, type IngestEntity, type IngestRelationship, type IngestionResult, MemoryClient, type MemoryClientOptions, type MemoryEntry, type MemoryIngestRequest, type MemoryInterface, type MemoryListParams, type MemoryListResult, type MemorySearchParams, type MemorySearchResult, MemoryServerError, type MemoryStats, MemoryType, RAGStrategy, SensitivityLevel, type StoreInput, StoreTarget, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, VectorProvider };

package/package.json

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