@pyxmate/memory 1.9.0 → 1.10.0

package/dist/cli/pyx-mem.mjs

@@ -798,7 +798,7 @@ function createProxyServer(client, version, uploadLocalFile) {
   return server;
 }
 async function runMcpProxyServer(opts) {
-  const version = opts.version ?? (true ? "1.9.0" : "0.0.0-dev");
+  const version = opts.version ?? (true ? "1.10.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/index.d.ts

@@ -643,6 +643,8 @@ interface MemorySearchParams {
     query: string;
     type?: MemoryType;
     agentId?: AgentId;
+    /** Optional caller session identifier used for in-process hygiene telemetry. */
+    sessionId?: string;
     limit?: number;
     strategy?: RAGStrategy;
     /** Filter results to entries whose eventTime falls within [start, end] (ISO 8601). */
@@ -1024,6 +1026,33 @@ interface GraphTelemetrySnapshot {
     /** Duration (ms) of the most recent getAllEdges call; null until one ran. */
     allEdgesLastMs: number | null;
 }
+/**
+ * Since-boot usage-hygiene telemetry (in-process, serializable). Tracks whether
+ * callers provide event-time/graph context on store, whether searches miss, how
+ * reinforce is used, and whether sessions search before their first store.
+ */
+interface UsageHygieneSnapshot {
+    /** Total Memory.store calls observed since boot. */
+    storesTotal: number;
+    /** Store calls whose input carried eventTime. */
+    storesWithEventTime: number;
+    /** Store calls whose input carried caller-supplied entities or relationships. */
+    storesWithGraph: number;
+    /** Store calls by input type; missing type is counted as "long-term". */
+    storesByType: Record<string, number>;
+    /** Total Memory.search calls observed since boot. */
+    searchesTotal: number;
+    /** Completed searches that returned zero entries. */
+    searchesZeroResults: number;
+    /** Total Memory.reinforce calls observed since boot. */
+    reinforceTotal: number;
+    /** Reinforce calls by signal value. */
+    reinforceBySignal: Record<string, number>;
+    /** Sessions where at least one search happened before the first store. */
+    searchBeforeFirstStoreSessions: number;
+    /** Sessions whose first observed hygiene event was a store. */
+    storeFirstSessions: number;
+}
 interface MemoryStats {
     totalEntries: number;
     storageUsedBytes: number;
@@ -1039,6 +1068,8 @@ interface MemoryStats {
     graphStore?: string;
     /** Graph traversal telemetry; undefined when no graph store is active. */
     graphTelemetry?: GraphTelemetrySnapshot;
+    /** Usage-hygiene telemetry since process boot. */
+    usageHygiene?: UsageHygieneSnapshot;
     /** Whether the memory service is connected. False when using DisabledMemory. */
     connected?: boolean;
 }
@@ -1482,4 +1513,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, 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, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, type Topology, type TopologyExtractionProvider, type TopologyServiceVariant, 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, 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, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, type Topology, type TopologyExtractionProvider, type TopologyServiceVariant, type UsageHygieneSnapshot, VectorProvider, type VectorStatus, type WikiLintReport, createPyxMemory, mergeExtractedEntities, normalizeGraphLabel, normalizeNameKey };

package/package.json

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