@pyxmate/memory 1.24.0 → 1.25.1

package/dist/{chunk-LF22PCY6.mjs → chunk-EHFEPWCL.mjs}

@@ -958,10 +958,36 @@ var MemoryClient = class {
     });
   }
   // --- ExtendedMemoryInterface methods ---
-  async consolidate() {
-    return this.fetchApi("/api/memory/consolidate", {
-      method: "POST"
-    });
+  /**
+   * Without `judge` the server's own judge decides (none on a plain server, so
+   * nothing merges). With `judge`, the server only proposes pairs; `judge`
+   * returns the ones to merge and only those merges are posted. If `judge`
+   * throws, nothing is posted and the call rejects. A server without caller
+   * judging answers 404 and changes nothing.
+   */
+  async consolidate(options) {
+    if (!options?.judge) {
+      return this.fetchApi("/api/memory/consolidate", {
+        method: "POST"
+      });
+    }
+    const run = await this.fetchApi(
+      "/api/memory/consolidate/pairs",
+      { method: "POST" }
+    );
+    const merges = run.pairs.length > 0 ? await options.judge(run.pairs) : [];
+    const judgements = merges.length > 0 ? await this.fetchApi("/api/memory/consolidate/judgements", {
+      method: "POST",
+      body: JSON.stringify({
+        merges: merges.map(({ olderId, newerId, olderHash, newerHash }) => ({
+          olderId,
+          newerId,
+          olderHash,
+          newerHash
+        }))
+      })
+    }) : { merged: [], rejected: [], vectorFailures: [] };
+    return { ...run, entriesMerged: judgements.merged.length, judgements };
   }
   async forget(id, reason) {
     try {

package/dist/{chunk-L2RHO7DP.mjs → chunk-GLQGLTMK.mjs}

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

package/dist/cli/pyx-mem.mjs

@@ -2877,7 +2877,7 @@ function createProxyServer(client, version, uploadLocalFile, hostedFileIngest) {
   return server;
 }
 async function runMcpProxyServer(opts) {
-  const version = opts.version ?? (true ? "1.24.0" : "0.0.0-dev");
+  const version = opts.version ?? (true ? "1.25.1" : "0.0.0-dev");
   const read = await opts.readCredentials();
   if (!read.ok) {
     throw new Error(

package/dist/dashboard.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-L2RHO7DP.mjs";
-import "./chunk-LF22PCY6.mjs";
+} from "./chunk-GLQGLTMK.mjs";
+import "./chunk-EHFEPWCL.mjs";
 import "./chunk-KZKGRND2.mjs";
 import "./chunk-VXXRCAKS.mjs";
 export {

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, 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';
+import { MemoryType as MemoryType$1, StoreInput as StoreInput$1, MemoryEntry as MemoryEntry$1, MemorySearchParams as MemorySearchParams$1, MemorySearchResult as MemorySearchResult$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-CGU0qjv4.js';
 
@@ -204,8 +204,8 @@ interface MemoryEntry {
      * UPDATE replaced this one during consolidation. `'archived'` (1b) means decay
      * retired it (no successor) — kept, strength 0, `deep`-tier only. All three
      * are kept (history / lineage / deep recall) but `superseded`/`archived` are
-     * excluded from default/quick/medium search. Only `forget()` and exact-byte-
-     * duplicate collapse hard-delete. See `docs/H8-MEMORY-MODEL-DESIGN.md`.
+     * excluded from default/quick/medium search. Only `forget()` hard-deletes.
+     * See `docs/H8-MEMORY-MODEL-DESIGN.md`.
      */
     status?: 'active' | 'superseded' | 'archived';
     /**
@@ -966,12 +966,70 @@ interface MemoryInterface {
     queryByEventTime(startTime: string, endTime: string, filters?: TemporalQueryFilters): Promise<MemoryEntry$1[]>;
     shutdown(): Promise<void>;
 }
+/** One side of a {@link ConsolidationPair}, as a judge needs to read it. */
+interface ConsolidationPairSide {
+    content: string;
+    source?: string;
+    metadata: Record<string, unknown>;
+    agentId?: string;
+    createdAt: string;
+    eventTime?: string;
+}
+/**
+ * Two active, unpinned, unencrypted rows of the same tenant, namespace and type
+ * that consolidation proposes to merge: equal content hash (`exact`) or cosine
+ * above 0.9. A merge supersedes `olderId` by `newerId` (by eventTime, else createdAt).
+ */
+interface ConsolidationPair {
+    olderId: string;
+    newerId: string;
+    /** null for rows written before content hashing; a caller judge cannot merge those. */
+    olderHash: string | null;
+    newerHash: string | null;
+    exact: boolean;
+    cosine: number;
+    type: MemoryType$1;
+    namespaceId: string | null;
+    older: ConsolidationPairSide;
+    newer: ConsolidationPairSide;
+}
+/** A pair the caller's judge decided to merge; the hashes are the pair's, so a changed row is refused. */
+interface ConsolidationMerge {
+    olderId: string;
+    newerId: string;
+    olderHash: string;
+    newerHash: string;
+}
+/** What `POST /api/memory/consolidate/judgements` applied. */
+interface ConsolidationJudgementsResult {
+    /** Older ids now superseded by their newer partner. */
+    merged: string[];
+    /** Merges refused because the pair no longer holds; nothing changed for them. */
+    rejected: Array<ConsolidationMerge & {
+        reason: string;
+    }>;
+    /** Superseded rows whose vector status sync failed; default search still hides them. */
+    vectorFailures: Array<{
+        entryId: string;
+        error: string;
+    }>;
+}
 /** Consolidation run result. */
 interface ConsolidationRunResult {
     entriesProcessed: number;
+    /** Supersessions this run; consolidation never deletes. */
     entriesMerged: number;
     entriesArchived: number;
     durationMs: number;
+    /** Proposed pairs by kind; only a judge turns a pair into a merge. */
+    pairsExact: number;
+    pairsNear: number;
+    /** Who judged the pairs: the server's LLM, the caller, or nobody (nothing merges). */
+    judge: 'llm' | 'caller' | 'none';
+    /** The proposed pairs, returned only to a caller judge. */
+    pairs?: ConsolidationPair[];
+    /** `MemoryClient.consolidate({ judge })` only: what applying the judge's merges did. */
+    judgements?: ConsolidationJudgementsResult;
 }
 /** Extended interface with lifecycle operations. Non-breaking for existing consumers. */
 interface ExtendedMemoryInterface extends MemoryInterface {
@@ -1345,7 +1403,16 @@ declare class MemoryClient implements ExtendedMemoryInterface {
         nodeId: string;
         depth?: number;
     }): Promise<GraphTraversalResult$1>;
-    consolidate(): Promise<ConsolidationRunResult>;
+    /**
+     * Without `judge` the server's own judge decides (none on a plain server, so
+     * nothing merges). With `judge`, the server only proposes pairs; `judge`
+     * returns the ones to merge and only those merges are posted. If `judge`
+     * throws, nothing is posted and the call rejects. A server without caller
+     * judging answers 404 and changes nothing.
+     */
+    consolidate(options?: {
+        judge?: (pairs: ConsolidationPair[]) => Promise<ConsolidationMerge[]>;
+    }): Promise<ConsolidationRunResult>;
     forget(id: string, reason?: string): Promise<boolean>;
     summarizeSession(sessionId: string): Promise<MemoryEntry$1 | null>;
     lint(options?: {
@@ -1936,4 +2003,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 ExpandAnchorStatus, type ExpandParams, type ExpandResult, 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, SESSION_ORDINAL_MAX, 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, isSessionOrdinal, mergeExtractedEntities, normalizeGraphLabel, normalizeNameKey, projectSearchResponseForMcp, secretElevationAggregate, secretElevationNoticeFor, withSecretElevationNotice };
+export { type AgentId, type ApiResponse, type ConsolidationJudgementsResult, type ConsolidationMerge, type ConsolidationPair, type ConsolidationPairSide, 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 ExpandAnchorStatus, type ExpandParams, type ExpandResult, 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, SESSION_ORDINAL_MAX, 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, isSessionOrdinal, mergeExtractedEntities, normalizeGraphLabel, normalizeNameKey, projectSearchResponseForMcp, secretElevationAggregate, secretElevationNoticeFor, withSecretElevationNotice };

package/dist/index.mjs

@@ -2,7 +2,7 @@ import {
   DisabledMemory,
   MemoryClient,
   MemoryServerError
-} from "./chunk-LF22PCY6.mjs";
+} from "./chunk-EHFEPWCL.mjs";
 import {
   DEFAULTS,
   MEMORY_PROJECT_LABEL_MAX_CHARS,

package/dist/react.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-L2RHO7DP.mjs";
-import "./chunk-LF22PCY6.mjs";
+} from "./chunk-GLQGLTMK.mjs";
+import "./chunk-EHFEPWCL.mjs";
 import "./chunk-KZKGRND2.mjs";
 import "./chunk-VXXRCAKS.mjs";
 

package/package.json

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