@pyxmate/memory 1.0.0 → 1.0.1

package/dist/{chunk-PXQLVQAA.mjs → chunk-U3U4MHWS.mjs}

@@ -1,7 +1,68 @@
 import {
+  RAGStrategy,
   mergeExtractedEntities
 } from "./chunk-X6AYWXW7.mjs";
 
+// ../client/src/disabled-memory.ts
+var DEFAULT_PAGE_LIMIT = 20;
+var DisabledMemory = class {
+  async initialize() {
+    console.warn("[pyx-memory] No memory backend configured \u2014 running without memory.");
+  }
+  async store(entry) {
+    return {
+      id: "disabled",
+      content: entry.content,
+      type: entry.type,
+      metadata: {},
+      createdAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  }
+  async search() {
+    return { entries: [], totalCount: 0, strategy: RAGStrategy.NAIVE };
+  }
+  async list(params = {}) {
+    return {
+      entries: [],
+      totalCount: 0,
+      page: params.page ?? 1,
+      limit: params.limit ?? DEFAULT_PAGE_LIMIT
+    };
+  }
+  async get() {
+    return null;
+  }
+  async delete() {
+    return false;
+  }
+  async clearSession() {
+    return 0;
+  }
+  async stats() {
+    return {
+      totalEntries: 0,
+      storageUsedBytes: 0,
+      vectorCount: 0,
+      recentAccessCount: 0,
+      connected: false
+    };
+  }
+  async queryAsOf() {
+    return [];
+  }
+  async lineage() {
+    return { versions: [], source: "chain" };
+  }
+  async reinforce() {
+    return { updated: [] };
+  }
+  async queryByEventTime() {
+    return [];
+  }
+  async shutdown() {
+  }
+};
+
 // ../client/src/memory-client.ts
 var MemoryServerError = class extends Error {
   status;
@@ -789,6 +850,7 @@ var MemoryClient = class {
 };
 
 export {
+  DisabledMemory,
   MemoryServerError,
   MemoryClient
 };

package/dist/{chunk-ZCGJGI2O.mjs → chunk-ZILXBWWH.mjs}

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

package/dist/cli/pyx-mem.mjs

@@ -1377,7 +1377,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 ? "1.0.0" : "0.0.0-dev");
+  const version = opts.version ?? (true ? "1.0.1" : "0.0.0-dev");
   const server = new McpServer(
     { name: "pyx-memory", version },
     { instructions: PYX_MEMORY_INSTRUCTIONS, capabilities: { tools: {}, prompts: {} } }

package/dist/dashboard.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-ZCGJGI2O.mjs";
-import "./chunk-PXQLVQAA.mjs";
+} from "./chunk-ZILXBWWH.mjs";
+import "./chunk-U3U4MHWS.mjs";
 import "./chunk-X6AYWXW7.mjs";
 export {
   DashboardClient,

package/dist/index.d.ts

@@ -149,6 +149,37 @@ interface ExtendedMemoryInterface extends MemoryInterface {
     getEntitySynthesis(name: string): Promise<MemoryEntry$1 | null>;
 }
 
+/**
+ * No-op {@link MemoryInterface} for hosts that run without a memory backend
+ * (e.g. `MEMORY_URL` is unset). Every method returns a safe default, so the
+ * rest of the system functions without branching on `memory == null`.
+ *
+ * Canonical single source: this lives in the SAME package as `MemoryInterface`,
+ * so any method added to the interface fails THIS class's compile in the same
+ * build. The null-object can never silently drift behind the contract — the
+ * failure mode that left hand-rolled copies in downstream repos missing
+ * `lineage`/`reinforce` after the interface grew them.
+ *
+ * `initialize()` emits a single `console.warn`; pass nothing else — it is a
+ * pure null-object. Hosts wanting structured logging should log at the wiring
+ * site where they choose `DisabledMemory` over a real client.
+ */
+declare class DisabledMemory implements MemoryInterface {
+    initialize(): Promise<void>;
+    store(entry: StoreInput$1): Promise<MemoryEntry$1>;
+    search(): Promise<MemorySearchResult$1>;
+    list(params?: MemoryListParams): Promise<MemoryListResult>;
+    get(): Promise<MemoryEntry$1 | null>;
+    delete(): Promise<boolean>;
+    clearSession(): Promise<number>;
+    stats(): Promise<MemoryStats$1>;
+    queryAsOf(): Promise<MemoryEntry$1[]>;
+    lineage(): Promise<LineageResult$1>;
+    reinforce(): Promise<ReinforceResult$1>;
+    queryByEventTime(): Promise<MemoryEntry$1[]>;
+    shutdown(): Promise<void>;
+}
+
 /**
  * Callbacks for two-phase file enrichment. All callbacks are optional:
  *   - Image-rich PDF + describeImage only → describes images, no entity extraction
@@ -1431,4 +1462,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, type DroppedGraphRelationship, EmbeddingProviderName, type EnrichmentCallbacks, type EntityExtractionResult, type ExtendedMemoryInterface, type FetchCorrectionsInput, type GraphEnrichment, type GraphEnrichmentStatus, 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, 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, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, type Topology, type TopologyExtractionProvider, type TopologyServiceVariant, VectorProvider, 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, EmbeddingProviderName, type EnrichmentCallbacks, type EntityExtractionResult, type ExtendedMemoryInterface, type FetchCorrectionsInput, type GraphEnrichment, type GraphEnrichmentStatus, 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, 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, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, type Topology, type TopologyExtractionProvider, type TopologyServiceVariant, VectorProvider, type WikiLintReport, createPyxMemory, mergeExtractedEntities, normalizeGraphLabel, normalizeNameKey };

package/dist/index.mjs

@@ -1,7 +1,8 @@
 import {
+  DisabledMemory,
   MemoryClient,
   MemoryServerError
-} from "./chunk-PXQLVQAA.mjs";
+} from "./chunk-U3U4MHWS.mjs";
 import {
   DEFAULTS,
   DEPRECATED_RAG_STRATEGIES,
@@ -35,6 +36,7 @@ function createPyxMemory(opts = {}) {
 export {
   DEFAULTS,
   DEPRECATED_RAG_STRATEGIES,
+  DisabledMemory,
   EmbeddingProviderName,
   MemoryClient,
   MemoryServerError,

package/dist/react.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-ZCGJGI2O.mjs";
-import "./chunk-PXQLVQAA.mjs";
+} from "./chunk-ZILXBWWH.mjs";
+import "./chunk-U3U4MHWS.mjs";
 import "./chunk-X6AYWXW7.mjs";
 
 // ../dashboard/src/hooks/use-consolidation-log.ts

package/package.json

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