@pyxmate/memory 1.17.18 → 1.18.0

package/dist/dashboard.mjs

@@ -11,8 +11,9 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-T35ZOOES.mjs";
-import "./chunk-H6ZLMPZH.mjs";
+} from "./chunk-ACFPMLNO.mjs";
+import "./chunk-SLYCVO4C.mjs";
+import "./chunk-KVYCISUI.mjs";
 import "./chunk-3OLH3HYR.mjs";
 export {
   DashboardClient,

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { StoreInput as StoreInput$1, MemoryEntry as MemoryEntry$1, MemorySearchParams as MemorySearchParams$1, MemorySearchResult as MemorySearchResult$1, MemoryType as MemoryType$1, PrincipalContext as PrincipalContext$1, SensitivityLevel as SensitivityLevel$1, MemoryStats as MemoryStats$1, LineageParams as LineageParams$1, LineageResult as LineageResult$1, ReinforceParams as ReinforceParams$1, ReinforceResult as ReinforceResult$1, WikiLintReport as WikiLintReport$1, GraphRepairResult as GraphRepairResult$1, ExtractedImageMeta as ExtractedImageMeta$1, IngestEntity as IngestEntity$1, IngestRelationship as IngestRelationship$1, EntityExtractionResult as EntityExtractionResult$1, Topology as Topology$1, IngestEvent as IngestEvent$1, GraphEnrichEvent as GraphEnrichEvent$1, GraphNode as GraphNode$1, GraphTraversalResult as GraphTraversalResult$1, CorrectionRecord as CorrectionRecord$1 } from '@pyx-memory/shared';
+import { StoreInput as StoreInput$1, MemoryEntry as MemoryEntry$1, MemorySearchParams as MemorySearchParams$1, MemorySearchResult as MemorySearchResult$1, MemoryType as MemoryType$1, PrincipalContext as PrincipalContext$1, SensitivityLevel as SensitivityLevel$1, MemoryStats as MemoryStats$1, MemoryInsights as MemoryInsights$1, LineageParams as LineageParams$1, LineageResult as LineageResult$1, ReinforceParams as ReinforceParams$1, ReinforceResult as ReinforceResult$1, WikiLintReport as WikiLintReport$1, GraphRepairResult as GraphRepairResult$1, ExtractedImageMeta as ExtractedImageMeta$1, IngestEntity as IngestEntity$1, IngestRelationship as IngestRelationship$1, EntityExtractionResult as EntityExtractionResult$1, Topology as Topology$1, IngestEvent as IngestEvent$1, GraphEnrichEvent as GraphEnrichEvent$1, GraphNode as GraphNode$1, GraphTraversalResult as GraphTraversalResult$1, CorrectionRecord as CorrectionRecord$1 } from '@pyx-memory/shared';
 export { documentContentSource, documentGraphSource, documentImageSource } from '@pyx-memory/shared';
 export { e as encodeListCursorToken, p as parseListCursorToken } from './data-plane-contract-fDvTm9bF.js';
 
@@ -123,6 +123,7 @@ interface MemoryInterface {
     delete(id: string, options?: TenantScopeOptions): Promise<boolean>;
     clearSession(sessionId: string, options?: TenantScopeOptions): Promise<number>;
     stats(options?: TenantScopeOptions): Promise<MemoryStats$1>;
+    insights(options?: TenantScopeOptions): Promise<MemoryInsights$1>;
     /** Query entries as they existed at a point in time (by ingest time). */
     queryAsOf(asOfDate: string, filters?: TemporalQueryFilters, options?: TenantScopeOptions): Promise<MemoryEntry$1[]>;
     /** Read the time-ordered lineage of a graph fact or superseded entry chain. */
@@ -207,6 +208,7 @@ declare class DisabledMemory implements MemoryInterface {
     delete(): Promise<boolean>;
     clearSession(): Promise<number>;
     stats(): Promise<MemoryStats$1>;
+    insights(): Promise<MemoryInsights$1>;
     queryAsOf(): Promise<MemoryEntry$1[]>;
     lineage(): Promise<LineageResult$1>;
     reinforce(): Promise<ReinforceResult$1>;
@@ -395,6 +397,7 @@ declare class MemoryClient implements ExtendedMemoryInterface {
     delete(id: string, authority?: TenantScopeOptions & RequestAuthorityOptions): Promise<boolean>;
     clearSession(sessionId: string): Promise<number>;
     stats(options?: TenantScopeOptions): Promise<MemoryStats$1>;
+    insights(options?: TenantScopeOptions & RequestAuthorityOptions): Promise<MemoryInsights$1>;
     /**
      * Fetch the running server's topology snapshot (build variant, declared
      * role, embedding location, active model profile). Round-trips the
@@ -627,6 +630,10 @@ declare const DEFAULTS: {
     readonly MEMORY_SERVER_PORT: 7822;
 };
 declare const TAXONOMY_MAX_CATEGORIES = 10;
+declare const TAXONOMY_MAX_TOP_ENTITIES = 15;
+declare const TAXONOMY_MAX_SAMPLE_TOPICS = 8;
+declare const TAXONOMY_MAX_PROJECTS = 8;
+declare const MEMORY_PROJECT_LABEL_MAX_CHARS = 80;
 
 /** ISO 8601 timestamp string */
 type Timestamp = string;
@@ -1306,6 +1313,60 @@ interface MemoryStats {
      */
     pendingEmbeddings?: number;
 }
+interface MemoryInsightMetrics {
+    activeEntries: number;
+    retainedAdditions7d: number;
+    appliedRecalls: number;
+    reinforcedEntries: number;
+    retrievedEntries: number;
+    retrievals: number;
+    lastAppliedAt: string | null;
+    lastRetrievedAt: string | null;
+}
+interface MemoryProjectInsight extends MemoryInsightMetrics {
+    label: string;
+}
+/** Body-free, caller-visible aggregate for product status surfaces. */
+interface MemoryInsights {
+    generatedAt: string;
+    scope: 'connected_memory';
+    coverage: {
+        retainedAdditions: {
+            state: 'measured' | 'partial';
+            trackingSince: string | null;
+            trackedEntries: number;
+            totalEntries: number;
+            reason: string | null;
+        };
+        projectLabels: {
+            state: 'measured';
+        };
+        retrievalUsage: {
+            state: 'partial';
+            reason: string;
+        };
+        tokenEfficiency: {
+            state: 'not_instrumented';
+            reason: string;
+        };
+        contextAccuracy: {
+            state: 'not_instrumented';
+            reason: string;
+        };
+    };
+    summary: {
+        activeEntries: number;
+        observedProjectLabels: number;
+        retainedAdditions7d: number | null;
+        trackedEntries: number;
+        appliedRecalls: number;
+        reinforcedEntries: number;
+        retrievedEntries: number;
+        retrievals: number;
+    };
+    projects: MemoryProjectInsight[];
+    other: MemoryInsightMetrics | null;
+}
 interface GraphRepairResult {
     staleEdgesDeleted: number;
     staleNodeRefsRemoved: number;
@@ -1826,4 +1887,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, type DueScanInput, EmbeddingProviderName, type EnrichmentCallbacks, type EnrichmentPurpose, type EntityExtractionResult, type ExtendedMemoryInterface, type FetchCorrectionsInput, type FileDownloadOptions, type GraphEnrichEvent, type GraphEnrichFileOptions, type GraphEnrichPreparedEvent, type GraphEnrichResult, type GraphEnrichResultEvent, type GraphEnrichment, type GraphEnrichmentStatus, type GraphExtractionPayload, 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, type SecretElevationAggregate, type SecretElevationNotice, 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, assertGraphExtractionPayload, createPyxMemory, mergeExtractedEntities, normalizeGraphLabel, normalizeNameKey, projectSearchResponseForMcp, secretElevationAggregate, secretElevationNoticeFor, withSecretElevationNotice };
+export { type AgentId, type ApiResponse, type ConsolidationRunResult, type CorrectionInput, type CorrectionRecord, type CreatePyxMemoryOptions, DEFAULTS, DEPRECATED_RAG_STRATEGIES, DisabledMemory, type DroppedGraphRelationship, type DueScanInput, EmbeddingProviderName, type EnrichmentCallbacks, type EnrichmentPurpose, type EntityExtractionResult, type ExtendedMemoryInterface, type FetchCorrectionsInput, type FileDownloadOptions, type GraphEnrichEvent, type GraphEnrichFileOptions, type GraphEnrichPreparedEvent, type GraphEnrichResult, type GraphEnrichResultEvent, type GraphEnrichment, type GraphEnrichmentStatus, type GraphExtractionPayload, 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, MEMORY_PROJECT_LABEL_MAX_CHARS, MemoryClient, type MemoryClientOptions, type MemoryEntry, type MemoryIngestRequest, type MemoryInsightMetrics, type MemoryInsights, type MemoryInterface, type MemoryListParams, type MemoryListResult, type MemoryLogFilters, type MemoryProjectInsight, 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, type SecretElevationAggregate, type SecretElevationNotice, SensitivityLevel, type SourceEvidence, type StoreInput, StoreTarget, TAXONOMY_MAX_CATEGORIES, TAXONOMY_MAX_PROJECTS, TAXONOMY_MAX_SAMPLE_TOPICS, TAXONOMY_MAX_TOP_ENTITIES, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, type Topology, type TopologyExtractionProvider, type TopologyServiceVariant, type UsageHygieneSnapshot, VectorProvider, type VectorStatus, type WikiLintReport, assertGraphExtractionPayload, createPyxMemory, mergeExtractedEntities, normalizeGraphLabel, normalizeNameKey, projectSearchResponseForMcp, secretElevationAggregate, secretElevationNoticeFor, withSecretElevationNotice };

package/dist/index.mjs

@@ -1,10 +1,13 @@
+import {
+  DisabledMemory,
+  MemoryClient,
+  MemoryServerError
+} from "./chunk-SLYCVO4C.mjs";
 import {
   DEFAULTS,
   DEPRECATED_RAG_STRATEGIES,
-  DisabledMemory,
   EmbeddingProviderName,
-  MemoryClient,
-  MemoryServerError,
+  MEMORY_PROJECT_LABEL_MAX_CHARS,
   MemoryType,
   MoveFailureReason,
   NamespaceIsolation,
@@ -13,6 +16,9 @@ import {
   SensitivityLevel,
   StoreTarget,
   TAXONOMY_MAX_CATEGORIES,
+  TAXONOMY_MAX_PROJECTS,
+  TAXONOMY_MAX_SAMPLE_TOPICS,
+  TAXONOMY_MAX_TOP_ENTITIES,
   VectorProvider,
   documentContentSource,
   documentGraphSource,
@@ -21,7 +27,7 @@ import {
   secretElevationAggregate,
   secretElevationNoticeFor,
   withSecretElevationNotice
-} from "./chunk-H6ZLMPZH.mjs";
+} from "./chunk-KVYCISUI.mjs";
 import {
   assertGraphExtractionPayload,
   encodeListCursorToken,
@@ -49,6 +55,7 @@ export {
   DEPRECATED_RAG_STRATEGIES,
   DisabledMemory,
   EmbeddingProviderName,
+  MEMORY_PROJECT_LABEL_MAX_CHARS,
   MemoryClient,
   MemoryServerError,
   MemoryType,
@@ -59,6 +66,9 @@ export {
   SensitivityLevel,
   StoreTarget,
   TAXONOMY_MAX_CATEGORIES,
+  TAXONOMY_MAX_PROJECTS,
+  TAXONOMY_MAX_SAMPLE_TOPICS,
+  TAXONOMY_MAX_TOP_ENTITIES,
   VectorProvider,
   assertGraphExtractionPayload,
   createPyxMemory,

package/dist/react.mjs

@@ -11,8 +11,9 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-T35ZOOES.mjs";
-import "./chunk-H6ZLMPZH.mjs";
+} from "./chunk-ACFPMLNO.mjs";
+import "./chunk-SLYCVO4C.mjs";
+import "./chunk-KVYCISUI.mjs";
 import "./chunk-3OLH3HYR.mjs";
 
 // ../dashboard/src/hooks/use-consolidation-log.ts

package/package.json

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