@pyxmate/memory 1.17.19 → 1.18.0

package/dist/{chunk-T35ZOOES.mjs → chunk-ACFPMLNO.mjs}

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

package/dist/chunk-KVYCISUI.mjs

@@ -0,0 +1,206 @@
+// ../shared/src/constants/defaults.ts
+var DEFAULTS = {
+  DATA_DIR: "./data",
+  VECTOR_PROVIDER: "lancedb",
+  MEMORY_SERVER_PORT: 7822
+};
+var TAXONOMY_MAX_CATEGORIES = 10;
+var TAXONOMY_MAX_TOP_ENTITIES = 15;
+var TAXONOMY_MAX_SAMPLE_TOPICS = 8;
+var TAXONOMY_MAX_PROJECTS = 8;
+var MEMORY_PROJECT_LABEL_MAX_CHARS = 80;
+
+// ../shared/src/document-source.ts
+import { createHash } from "crypto";
+function documentSource(prefix, documentKey) {
+  return `${prefix}:${createHash("sha256").update(documentKey).digest("hex")}`;
+}
+function documentGraphSource(documentKey) {
+  return documentSource("document-graph", documentKey);
+}
+function documentContentSource(documentKey) {
+  return documentSource("document-content", documentKey);
+}
+function documentImageSource(documentKey) {
+  return documentSource("document-image", documentKey);
+}
+
+// ../shared/src/mcp/search-response.ts
+var STRIPPED_ENTRY_FIELDS = /* @__PURE__ */ new Set(["contentHash", "embedding", "tenantId", "userId", "teamId"]);
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function compactEntryForMcp(entry, vectorSimilarity) {
+  if (!isRecord(entry)) return entry;
+  const projected = {};
+  for (const [key, value] of Object.entries(entry)) {
+    if (!STRIPPED_ENTRY_FIELDS.has(key)) projected[key] = value;
+  }
+  if (vectorSimilarity !== void 0) projected.vectorSimilarity = vectorSimilarity;
+  return projected;
+}
+function vectorSimilarityByEntryId(payload) {
+  const similarities = /* @__PURE__ */ new Map();
+  const scoredEntries = Array.isArray(payload.scoredEntries) ? payload.scoredEntries : [];
+  for (const scored of scoredEntries) {
+    if (!isRecord(scored) || !isRecord(scored.entry)) continue;
+    const id = scored.entry.id;
+    if (typeof id === "string" && typeof scored.vectorSimilarity === "number") {
+      similarities.set(id, scored.vectorSimilarity);
+    }
+  }
+  return similarities;
+}
+function projectSearchResultRecord(payload) {
+  const similarities = vectorSimilarityByEntryId(payload);
+  const projected = {};
+  for (const [key, value] of Object.entries(payload)) {
+    if (key === "scoredEntries") continue;
+    if (key === "entries" && Array.isArray(value)) {
+      projected.entries = value.map(
+        (entry) => compactEntryForMcp(
+          entry,
+          isRecord(entry) && typeof entry.id === "string" ? similarities.get(entry.id) : void 0
+        )
+      );
+    } else {
+      projected[key] = value;
+    }
+  }
+  return projected;
+}
+function projectSearchResponseForMcp(payload) {
+  if (!isRecord(payload)) return payload;
+  if (isRecord(payload.data) && ("entries" in payload.data || "scoredEntries" in payload.data)) {
+    return { ...payload, data: projectSearchResultRecord(payload.data) };
+  }
+  return projectSearchResultRecord(payload);
+}
+
+// ../shared/src/mcp/secret-elevation-notice.ts
+function isRecord2(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function elevationMessage(credentialTypes) {
+  const types = credentialTypes.length > 0 ? credentialTypes.join(", ") : "unspecified";
+  return `Auto-classified sensitivity=secret because credential patterns were detected (credentialTypes: ${types}). Secret entries are invisible to hosted MCP reads \u2014 search, get and list all cap MCP callers at internal. When an encryption key is configured the content is also encrypted at rest and embedded as a placeholder, so REST callers lose semantic search recall for it too (REST list/get still return the row). If this is a false positive: delete the entry by id, or store it again under the same id with the credential-shaped notation rephrased \u2014 a same-id re-store re-classifies the content. A canonical entry carrying metadata.dbRef.revision must advance that revision on the re-store, or it fails with revision_reuse_conflict.`;
+}
+function secretElevationNoticeFor(entry) {
+  if (!isRecord2(entry) || entry.sensitivity !== "secret") return void 0;
+  const metadata = entry.metadata;
+  if (!isRecord2(metadata) || metadata.credentialsDetected !== true) return void 0;
+  const credentialTypes = Array.isArray(metadata.credentialTypes) ? metadata.credentialTypes.filter((type) => typeof type === "string") : [];
+  return { sensitivity: "secret", credentialTypes, message: elevationMessage(credentialTypes) };
+}
+function withSecretElevationNotice(payload) {
+  if (!isRecord2(payload)) return payload;
+  const entry = isRecord2(payload.data) ? payload.data : payload;
+  const notice = secretElevationNoticeFor(entry);
+  if (!notice) return payload;
+  const elevated = { ...entry, secretElevation: notice };
+  return entry === payload ? elevated : { ...payload, data: elevated };
+}
+function secretElevationAggregate(elevated) {
+  if (elevated.length === 0) return void 0;
+  const credentialTypes = [...new Set(elevated.flatMap((item) => item.notice.credentialTypes))];
+  return {
+    count: elevated.length,
+    entryIds: elevated.map((item) => item.entryId),
+    credentialTypes,
+    message: `${elevated.length} stored chunk(s) were auto-elevated. ${elevationMessage(credentialTypes)}`
+  };
+}
+
+// ../shared/src/types/isolation.ts
+var NamespaceIsolation = {
+  SHARED: "shared",
+  STRICT: "strict"
+};
+
+// ../shared/src/types/memory.ts
+var MemoryType = {
+  SHORT_TERM: "short-term",
+  LONG_TERM: "long-term",
+  WORKING: "working",
+  EPISODIC: "episodic",
+  SUMMARY: "summary"
+};
+var SensitivityLevel = {
+  PUBLIC: "public",
+  INTERNAL: "internal",
+  SECRET: "secret"
+};
+var RAGStrategy = {
+  NAIVE: "naive",
+  GRAPH: "graph",
+  HYBRID: "hybrid"
+};
+var DEPRECATED_RAG_STRATEGIES = /* @__PURE__ */ new Map([
+  ["agentic", "strategy.deprecated:agentic \u2014 removed in v0.26, use hybrid"]
+]);
+var VectorProvider = {
+  LANCEDB: "lancedb"
+};
+var EmbeddingProviderName = {
+  STUB: "stub",
+  /** @deprecated Vestigial — pyx-memory uses internal EmbeddingGemma embeddings. */
+  ANTHROPIC: "anthropic",
+  /** @deprecated Vestigial — pyx-memory uses internal EmbeddingGemma embeddings. */
+  OPENAI: "openai",
+  /** In-process ONNX model (default: EmbeddingGemma-300M). */
+  LOCAL: "local",
+  /** Remote OpenAI-compatible embedding service (pyx-cloud shared, custom, etc.). */
+  HTTP: "http"
+};
+var StoreTarget = {
+  SQLITE: "sqlite",
+  VECTOR: "vector",
+  GRAPH: "graph"
+};
+
+// ../shared/src/types/move.ts
+var MoveFailureReason = {
+  /** Entry not found in the caller's tenant. */
+  NOT_FOUND: "not_found",
+  /** Move would cross tenant boundary (always forbidden). */
+  CROSS_TENANT_FORBIDDEN: "cross_tenant_forbidden",
+  /** Target namespace ID does not exist in the caller's tenant. */
+  TARGET_NAMESPACE_NOT_FOUND: "target_namespace_not_found",
+  /** SQLite metadata update failed; no compensation needed. */
+  SQLITE_UPDATE_FAILED: "sqlite_update_failed",
+  /** Vector store metadata update failed; SQLite reverted. */
+  VECTOR_UPDATE_FAILED: "vector_update_failed",
+  /** Graph edge namespace update failed; SQLite + vector reverted. */
+  GRAPH_UPDATE_FAILED: "graph_update_failed",
+  /** Compensation itself failed — manual intervention required. */
+  COMPENSATION_FAILED: "compensation_failed"
+};
+
+// ../shared/src/types/principal.ts
+var SINGLE_TENANT_ID = "_single";
+
+export {
+  DEFAULTS,
+  TAXONOMY_MAX_CATEGORIES,
+  TAXONOMY_MAX_TOP_ENTITIES,
+  TAXONOMY_MAX_SAMPLE_TOPICS,
+  TAXONOMY_MAX_PROJECTS,
+  MEMORY_PROJECT_LABEL_MAX_CHARS,
+  documentGraphSource,
+  documentContentSource,
+  documentImageSource,
+  projectSearchResponseForMcp,
+  secretElevationNoticeFor,
+  withSecretElevationNotice,
+  secretElevationAggregate,
+  NamespaceIsolation,
+  MemoryType,
+  SensitivityLevel,
+  RAGStrategy,
+  DEPRECATED_RAG_STRATEGIES,
+  VectorProvider,
+  EmbeddingProviderName,
+  StoreTarget,
+  MoveFailureReason,
+  SINGLE_TENANT_ID
+};

package/dist/{chunk-H6ZLMPZH.mjs → chunk-SLYCVO4C.mjs}

@@ -1,185 +1,11 @@
+import {
+  RAGStrategy
+} from "./chunk-KVYCISUI.mjs";
 import {
   assertGraphExtractionPayload,
   mergeExtractedEntities
 } from "./chunk-3OLH3HYR.mjs";
 
-// ../shared/src/constants/defaults.ts
-var DEFAULTS = {
-  DATA_DIR: "./data",
-  VECTOR_PROVIDER: "lancedb",
-  MEMORY_SERVER_PORT: 7822
-};
-var TAXONOMY_MAX_CATEGORIES = 10;
-
-// ../shared/src/document-source.ts
-import { createHash } from "crypto";
-function documentSource(prefix, documentKey) {
-  return `${prefix}:${createHash("sha256").update(documentKey).digest("hex")}`;
-}
-function documentGraphSource(documentKey) {
-  return documentSource("document-graph", documentKey);
-}
-function documentContentSource(documentKey) {
-  return documentSource("document-content", documentKey);
-}
-function documentImageSource(documentKey) {
-  return documentSource("document-image", documentKey);
-}
-
-// ../shared/src/mcp/search-response.ts
-var STRIPPED_ENTRY_FIELDS = /* @__PURE__ */ new Set(["contentHash", "embedding", "tenantId", "userId", "teamId"]);
-function isRecord(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function compactEntryForMcp(entry, vectorSimilarity) {
-  if (!isRecord(entry)) return entry;
-  const projected = {};
-  for (const [key, value] of Object.entries(entry)) {
-    if (!STRIPPED_ENTRY_FIELDS.has(key)) projected[key] = value;
-  }
-  if (vectorSimilarity !== void 0) projected.vectorSimilarity = vectorSimilarity;
-  return projected;
-}
-function vectorSimilarityByEntryId(payload) {
-  const similarities = /* @__PURE__ */ new Map();
-  const scoredEntries = Array.isArray(payload.scoredEntries) ? payload.scoredEntries : [];
-  for (const scored of scoredEntries) {
-    if (!isRecord(scored) || !isRecord(scored.entry)) continue;
-    const id = scored.entry.id;
-    if (typeof id === "string" && typeof scored.vectorSimilarity === "number") {
-      similarities.set(id, scored.vectorSimilarity);
-    }
-  }
-  return similarities;
-}
-function projectSearchResultRecord(payload) {
-  const similarities = vectorSimilarityByEntryId(payload);
-  const projected = {};
-  for (const [key, value] of Object.entries(payload)) {
-    if (key === "scoredEntries") continue;
-    if (key === "entries" && Array.isArray(value)) {
-      projected.entries = value.map(
-        (entry) => compactEntryForMcp(
-          entry,
-          isRecord(entry) && typeof entry.id === "string" ? similarities.get(entry.id) : void 0
-        )
-      );
-    } else {
-      projected[key] = value;
-    }
-  }
-  return projected;
-}
-function projectSearchResponseForMcp(payload) {
-  if (!isRecord(payload)) return payload;
-  if (isRecord(payload.data) && ("entries" in payload.data || "scoredEntries" in payload.data)) {
-    return { ...payload, data: projectSearchResultRecord(payload.data) };
-  }
-  return projectSearchResultRecord(payload);
-}
-
-// ../shared/src/mcp/secret-elevation-notice.ts
-function isRecord2(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function elevationMessage(credentialTypes) {
-  const types = credentialTypes.length > 0 ? credentialTypes.join(", ") : "unspecified";
-  return `Auto-classified sensitivity=secret because credential patterns were detected (credentialTypes: ${types}). Secret entries are invisible to hosted MCP reads \u2014 search, get and list all cap MCP callers at internal. When an encryption key is configured the content is also encrypted at rest and embedded as a placeholder, so REST callers lose semantic search recall for it too (REST list/get still return the row). If this is a false positive: delete the entry by id, or store it again under the same id with the credential-shaped notation rephrased \u2014 a same-id re-store re-classifies the content. A canonical entry carrying metadata.dbRef.revision must advance that revision on the re-store, or it fails with revision_reuse_conflict.`;
-}
-function secretElevationNoticeFor(entry) {
-  if (!isRecord2(entry) || entry.sensitivity !== "secret") return void 0;
-  const metadata = entry.metadata;
-  if (!isRecord2(metadata) || metadata.credentialsDetected !== true) return void 0;
-  const credentialTypes = Array.isArray(metadata.credentialTypes) ? metadata.credentialTypes.filter((type) => typeof type === "string") : [];
-  return { sensitivity: "secret", credentialTypes, message: elevationMessage(credentialTypes) };
-}
-function withSecretElevationNotice(payload) {
-  if (!isRecord2(payload)) return payload;
-  const entry = isRecord2(payload.data) ? payload.data : payload;
-  const notice = secretElevationNoticeFor(entry);
-  if (!notice) return payload;
-  const elevated = { ...entry, secretElevation: notice };
-  return entry === payload ? elevated : { ...payload, data: elevated };
-}
-function secretElevationAggregate(elevated) {
-  if (elevated.length === 0) return void 0;
-  const credentialTypes = [...new Set(elevated.flatMap((item) => item.notice.credentialTypes))];
-  return {
-    count: elevated.length,
-    entryIds: elevated.map((item) => item.entryId),
-    credentialTypes,
-    message: `${elevated.length} stored chunk(s) were auto-elevated. ${elevationMessage(credentialTypes)}`
-  };
-}
-
-// ../shared/src/types/isolation.ts
-var NamespaceIsolation = {
-  SHARED: "shared",
-  STRICT: "strict"
-};
-
-// ../shared/src/types/memory.ts
-var MemoryType = {
-  SHORT_TERM: "short-term",
-  LONG_TERM: "long-term",
-  WORKING: "working",
-  EPISODIC: "episodic",
-  SUMMARY: "summary"
-};
-var SensitivityLevel = {
-  PUBLIC: "public",
-  INTERNAL: "internal",
-  SECRET: "secret"
-};
-var RAGStrategy = {
-  NAIVE: "naive",
-  GRAPH: "graph",
-  HYBRID: "hybrid"
-};
-var DEPRECATED_RAG_STRATEGIES = /* @__PURE__ */ new Map([
-  ["agentic", "strategy.deprecated:agentic \u2014 removed in v0.26, use hybrid"]
-]);
-var VectorProvider = {
-  LANCEDB: "lancedb"
-};
-var EmbeddingProviderName = {
-  STUB: "stub",
-  /** @deprecated Vestigial — pyx-memory uses internal EmbeddingGemma embeddings. */
-  ANTHROPIC: "anthropic",
-  /** @deprecated Vestigial — pyx-memory uses internal EmbeddingGemma embeddings. */
-  OPENAI: "openai",
-  /** In-process ONNX model (default: EmbeddingGemma-300M). */
-  LOCAL: "local",
-  /** Remote OpenAI-compatible embedding service (pyx-cloud shared, custom, etc.). */
-  HTTP: "http"
-};
-var StoreTarget = {
-  SQLITE: "sqlite",
-  VECTOR: "vector",
-  GRAPH: "graph"
-};
-
-// ../shared/src/types/move.ts
-var MoveFailureReason = {
-  /** Entry not found in the caller's tenant. */
-  NOT_FOUND: "not_found",
-  /** Move would cross tenant boundary (always forbidden). */
-  CROSS_TENANT_FORBIDDEN: "cross_tenant_forbidden",
-  /** Target namespace ID does not exist in the caller's tenant. */
-  TARGET_NAMESPACE_NOT_FOUND: "target_namespace_not_found",
-  /** SQLite metadata update failed; no compensation needed. */
-  SQLITE_UPDATE_FAILED: "sqlite_update_failed",
-  /** Vector store metadata update failed; SQLite reverted. */
-  VECTOR_UPDATE_FAILED: "vector_update_failed",
-  /** Graph edge namespace update failed; SQLite + vector reverted. */
-  GRAPH_UPDATE_FAILED: "graph_update_failed",
-  /** Compensation itself failed — manual intervention required. */
-  COMPENSATION_FAILED: "compensation_failed"
-};
-
-// ../shared/src/types/principal.ts
-var SINGLE_TENANT_ID = "_single";
-
 // ../client/src/disabled-memory.ts
 var DEFAULT_PAGE_LIMIT = 20;
 var DisabledMemory = class {
@@ -226,6 +52,46 @@ var DisabledMemory = class {
       connected: false
     };
   }
+  async insights() {
+    return {
+      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      scope: "connected_memory",
+      coverage: {
+        retainedAdditions: {
+          state: "measured",
+          trackingSince: null,
+          trackedEntries: 0,
+          totalEntries: 0,
+          reason: null
+        },
+        projectLabels: { state: "measured" },
+        retrievalUsage: {
+          state: "partial",
+          reason: "Retrievals count entries returned by search; applied recalls count explicit reinforcement, not successful use."
+        },
+        tokenEfficiency: {
+          state: "not_instrumented",
+          reason: "Token savings are not instrumented by the memory store."
+        },
+        contextAccuracy: {
+          state: "not_instrumented",
+          reason: "Context accuracy requires outcome evaluation that is not instrumented."
+        }
+      },
+      summary: {
+        activeEntries: 0,
+        observedProjectLabels: 0,
+        retainedAdditions7d: 0,
+        trackedEntries: 0,
+        appliedRecalls: 0,
+        reinforcedEntries: 0,
+        retrievedEntries: 0,
+        retrievals: 0
+      },
+      projects: [],
+      other: null
+    };
+  }
   async queryAsOf() {
     return [];
   }
@@ -243,7 +109,7 @@ var DisabledMemory = class {
 };
 
 // ../client/src/memory-client.ts
-function isRecord3(value) {
+function isRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function normalizeRetryAfter(retryAfter, retryAfterSeconds) {
@@ -258,18 +124,18 @@ function normalizeRetryAfter(retryAfter, retryAfterSeconds) {
   return Number.isSafeInteger(retryAfterSeconds) && retryAfterSeconds >= 0 ? { retryAfterSeconds } : {};
 }
 function structuralHttpStatus(error) {
-  if (!isRecord3(error) || typeof error.status !== "number") return void 0;
+  if (!isRecord(error) || typeof error.status !== "number") return void 0;
   return Number.isSafeInteger(error.status) && error.status >= 400 && error.status < 600 ? error.status : void 0;
 }
 function isFileIngestResult(value) {
-  if (!isRecord3(value)) return false;
+  if (!isRecord(value)) return false;
   if (typeof value.filename !== "string" || typeof value.fileType !== "string" || typeof value.chunks !== "number" || !Number.isSafeInteger(value.chunks) || value.chunks < 0 || !Array.isArray(value.entryIds) || !value.entryIds.every((id) => typeof id === "string") || typeof value.totalCharacters !== "number" || !Number.isSafeInteger(value.totalCharacters) || value.totalCharacters < 0) {
     return false;
   }
   if (value.graphAnchorEntryId !== void 0 && typeof value.graphAnchorEntryId !== "string") {
     return false;
   }
-  if (value.enrichment !== void 0 && !isRecord3(value.enrichment)) return false;
+  if (value.enrichment !== void 0 && !isRecord(value.enrichment)) return false;
   return true;
 }
 function hasEnrichmentCallback(callbacks) {
@@ -463,6 +329,11 @@ var MemoryClient = class {
     const stats = await this.fetchApi(`/api/memory/stats${qs ? `?${qs}` : ""}`);
     return { ...stats, connected: true };
   }
+  async insights(options = {}) {
+    return this.fetchApi("/api/memory/insights", {
+      headers: this.authorityHeaders(options)
+    });
+  }
   /**
    * Fetch the running server's topology snapshot (build variant, declared
    * role, embedding location, active model profile). Round-trips the
@@ -1023,7 +894,7 @@ var MemoryClient = class {
     return result;
   }
   ingestErrorEvent(error, stage, partialResult) {
-    const structuralError = isRecord3(error) ? error : void 0;
+    const structuralError = isRecord(error) ? error : void 0;
     const status = error instanceof MemoryServerError ? error.status : error instanceof Error && error.name === "AbortError" ? 499 : structuralHttpStatus(error);
     const message = error instanceof Error ? error.message : String(error);
     const code = error instanceof MemoryServerError ? error.code : void 0;
@@ -1375,25 +1246,6 @@ var MemoryClient = class {
 };
 
 export {
-  DEFAULTS,
-  TAXONOMY_MAX_CATEGORIES,
-  documentGraphSource,
-  documentContentSource,
-  documentImageSource,
-  projectSearchResponseForMcp,
-  secretElevationNoticeFor,
-  withSecretElevationNotice,
-  secretElevationAggregate,
-  NamespaceIsolation,
-  MemoryType,
-  SensitivityLevel,
-  RAGStrategy,
-  DEPRECATED_RAG_STRATEGIES,
-  VectorProvider,
-  EmbeddingProviderName,
-  StoreTarget,
-  MoveFailureReason,
-  SINGLE_TENANT_ID,
   DisabledMemory,
   MemoryServerError,
   MemoryClient