@pyxmate/memory 1.9.0 → 1.11.0

package/dist/agent-contract.mjs

@@ -13,7 +13,7 @@ import {
   buildAgentSnippet,
   buildDesignGuide,
   buildGraphStructuringPrompt
-} from "./chunk-AXH45N7T.mjs";
+} from "./chunk-LJ7OORIM.mjs";
 export {
   AGENT_TARGETS,
   PERSISTENT_MEMORY_SECTION,

package/dist/{chunk-BS6K64SA.mjs → chunk-5BLT7RSY.mjs}

@@ -4,6 +4,7 @@ var DEFAULTS = {
   VECTOR_PROVIDER: "lancedb",
   MEMORY_SERVER_PORT: 7822
 };
+var TAXONOMY_MAX_CATEGORIES = 10;
 
 // ../shared/src/graph/extraction.ts
 function normalizeGraphLabel(value, fallback) {
@@ -973,6 +974,7 @@ var MemoryClient = class {
 
 export {
   DEFAULTS,
+  TAXONOMY_MAX_CATEGORIES,
   normalizeGraphLabel,
   normalizeNameKey,
   mergeExtractedEntities,

package/dist/{chunk-MZF55IUR.mjs → chunk-HOBDPIHO.mjs}

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

package/dist/{chunk-AXH45N7T.mjs → chunk-LJ7OORIM.mjs}

@@ -11,7 +11,7 @@ var PERSISTENT_MEMORY_SECTION = [
   "- Before suggesting an approach, search for prior decisions that might contradict it.",
   "- When the user references prior work, search for it.",
   "- When investigating a bug, search for prior occurrences and fixes.",
-  '- When a question names a time \u2014 explicit or relative ("last year", "\uB450 \uB2EC \uC804") \u2014 resolve it to an absolute ISO-8601 timestamp and pass it as search `anchorTime`: results rank by proximity to that time, without excluding other results.',
+  '- When a question names a time \u2014 explicit or relative ("last year") \u2014 resolve it to an absolute ISO-8601 timestamp and pass it as search `anchorTime`: results rank by proximity to that time, without excluding other results.',
   "- Match search `effort` to risk: use `quick` for routine recall; use `deep` when quick returns nothing, when prior state may be archived/superseded, or when full history matters.",
   '- To trace how a fact changed ("what did X use before Y", how it evolved), call `lineage` with `subject` + `relation` or an `entryId` instead of stitching together searches.',
   "- Recalled memories reflect what was true when written \u2014 if one names a file, function, flag, or version, verify it still exists before acting on it.",
@@ -34,11 +34,12 @@ var PERSISTENT_MEMORY_SECTION = [
   "- Always include `topic` and `project`.",
   "- Store concise facts and decisions, not deliberation.",
   "- Keep one memory per concept; do not bundle unrelated facts.",
-  "- Do not store ephemeral file contents, raw logs, or step-by-step progress as it happens. High-frequency streams (wearable/health samples, sensor readings, metrics) must be aggregated into the dated fact or summary they support (with `eventTime`), never stored as one memory or graph node per sample.",
-  '- Pass `eventTime` (ISO-8601, when the fact happened or took effect) for facts that can change or go stale \u2014 job/status changes, decisions that supersede earlier ones, dated events. Recency ordering, dated ("as of") queries, and stale-vs-current resolution key off it.',
+  "- Do not store ephemeral file contents, raw logs, or step-by-step progress as it happens. High-frequency streams (sensor/wearable samples, metrics) must be aggregated into the dated fact or summary they support (with `eventTime`), never stored as one memory or graph node per sample.",
+  '- Pass `eventTime` (ISO-8601, when the fact happened or took effect) for facts that can change or go stale. Recency ordering, dated ("as of") queries, and stale-vs-current resolution key off it.',
   "- Graph is a retrieval structure. When content names people, organizations, tools, places, events, or key concepts, pass `entities` and `relationships` when you can (caller-wins). On a multi-entity store, include at least one relationship connecting them, or use `triples` so edges are explicit. Relationships matter as much as entities for traversal. Entity-free memories are valid.",
-  '- Use specific durable entities ("sleep apnea", "morning run routine"). Never create a catch-all hub node ("me", "health", "work") linked to everything; mega-hubs degrade traversal. Bounded `IS_A` category nodes are the exception.',
-  '- For countable categories the user may later enumerate ("fitness classes", "streaming services", "pets"), add a canonical category `CONCEPT` node and an `IS_A` edge from each member to it (`"yoga"` IS_A `"fitness classes"`).',
+  '- Use specific durable entities. Never create a catch-all hub node ("me", "health") linked to everything; mega-hubs degrade traversal. Bounded `IS_A` category nodes are the exception.',
+  '- For countable categories the user may later enumerate, add a canonical category `CONCEPT` node and an `IS_A` edge from each member to it (`"yoga"` IS_A `"fitness classes"`).',
+  "- Taxonomy: when a store response reports unnamed clusters, call get_taxonomy_state and name each cluster via name_cluster \u2014 short, domain-true names in the user's language; rename (previousName) only when composition clearly changed.",
   "- Ingest documents/images only when they are worth persisting; images require a short description so they are searchable."
 ].join("\n");
 function buildDesignGuide({ appName }) {

package/dist/cli/pyx-mem.mjs

@@ -2,7 +2,7 @@
 import {
   PERSISTENT_MEMORY_SECTION,
   buildDesignGuide
-} from "../chunk-AXH45N7T.mjs";
+} from "../chunk-LJ7OORIM.mjs";
 
 // src/cli/exit-codes.ts
 var EXIT = {
@@ -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.11.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/dashboard.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-MZF55IUR.mjs";
-import "./chunk-BS6K64SA.mjs";
+} from "./chunk-HOBDPIHO.mjs";
+import "./chunk-5BLT7RSY.mjs";
 export {
   DashboardClient,
   Poller,

package/dist/index.d.ts

@@ -486,6 +486,7 @@ declare const DEFAULTS: {
     readonly VECTOR_PROVIDER: "lancedb";
     readonly MEMORY_SERVER_PORT: 7822;
 };
+declare const TAXONOMY_MAX_CATEGORIES = 10;
 
 /** ISO 8601 timestamp string */
 type Timestamp = string;
@@ -643,6 +644,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 +1027,37 @@ 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;
+    /** Total get_taxonomy_state (Memory.getTaxonomyState) calls observed since boot. */
+    taxonomyStateReadsTotal: number;
+    /** Total name_cluster (Memory.nameCluster) calls observed since boot. */
+    nameClusterCallsTotal: 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 +1073,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 +1518,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, TAXONOMY_MAX_CATEGORIES, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, type Topology, type TopologyExtractionProvider, type TopologyServiceVariant, type UsageHygieneSnapshot, VectorProvider, type VectorStatus, type WikiLintReport, createPyxMemory, mergeExtractedEntities, normalizeGraphLabel, normalizeNameKey };

package/dist/index.mjs

@@ -12,11 +12,12 @@ import {
   SINGLE_TENANT_ID,
   SensitivityLevel,
   StoreTarget,
+  TAXONOMY_MAX_CATEGORIES,
   VectorProvider,
   mergeExtractedEntities,
   normalizeGraphLabel,
   normalizeNameKey
-} from "./chunk-BS6K64SA.mjs";
+} from "./chunk-5BLT7RSY.mjs";
 
 // src/preset.ts
 var DEFAULT_MEMORY_URL = `http://localhost:${DEFAULTS.MEMORY_SERVER_PORT}`;
@@ -45,6 +46,7 @@ export {
   SINGLE_TENANT_ID,
   SensitivityLevel,
   StoreTarget,
+  TAXONOMY_MAX_CATEGORIES,
   VectorProvider,
   createPyxMemory,
   mergeExtractedEntities,

package/dist/react.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-MZF55IUR.mjs";
-import "./chunk-BS6K64SA.mjs";
+} from "./chunk-HOBDPIHO.mjs";
+import "./chunk-5BLT7RSY.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": "1.9.0",
+  "version": "1.11.0",
   "type": "module",
   "description": "SDK for pyx-memory — Memory as a Service for AI agents",
   "license": "MIT",