mindgraph 0.6.0 → 0.7.0

package/README.md

@@ -146,7 +146,8 @@ const job = await graph.getJob(job_id);
 | Method | Description |
 |--------|-------------|
 | `search(query, { node_type?, layer?, limit? })` | Full-text search |
-| `hybridSearch(query, { k?, node_types?, layer? })` | BM25 + vector search with rank fusion |
+| `hybridSearch(query, { k?, node_types?, layer?, explain? })` | BM25 + vector search with rank fusion; `explain: true` attaches per-leg contributions (`legs`: which legs surfaced each result, the within-leg rank the fusion used, and the leg's raw score) |
+| `getMergeCandidates()` | Pending duplicate pairs recorded by the dedup pipeline, awaiting merge/dismiss |
 
 ### Traversal
 

package/dist/index.d.mts

@@ -46,6 +46,21 @@ interface LegContribution {
      */
     score: number;
 }
+/** A suspected duplicate pair awaiting human review (pending PossibleDuplicate edge). */
+interface MergeCandidate {
+    edge_uid: string;
+    node_a_uid: string;
+    node_a_label: string;
+    node_a_summary: string;
+    node_b_uid: string;
+    node_b_label: string;
+    node_b_summary: string;
+    node_type: string;
+    /** Similarity score that triggered the candidate (e.g. cosine), if known. */
+    similarity: number | null;
+    /** How the candidate was found: "exact" | "fuzzy" | "semantic" | "llm". */
+    method: string | null;
+}
 /** A `/retrieve` hybrid result: the full node plus the fused RRF score. */
 interface HybridSearchResult {
     node: GraphNode;
@@ -1144,6 +1159,12 @@ declare class MindGraph {
     getOpenQuestions(): Promise<GraphNode[]>;
     getWeakClaims(): Promise<GraphNode[]>;
     getContradictions(): Promise<unknown[]>;
+    /**
+     * Pending merge candidates: suspected duplicate pairs recorded by the dedup
+     * pipeline's ambiguous zone as PossibleDuplicate edges, awaiting a human
+     * merge/dismiss decision (server >= 1.3).
+     */
+    getMergeCandidates(): Promise<MergeCandidate[]>;
     getPendingApprovals(): Promise<GraphNode[]>;
     ingestChunk(req: IngestChunkRequest): Promise<IngestChunkResponse>;
     ingestDocument(req: IngestDocumentRequest): Promise<IngestDocumentResponse>;

package/dist/index.d.ts

@@ -46,6 +46,21 @@ interface LegContribution {
      */
     score: number;
 }
+/** A suspected duplicate pair awaiting human review (pending PossibleDuplicate edge). */
+interface MergeCandidate {
+    edge_uid: string;
+    node_a_uid: string;
+    node_a_label: string;
+    node_a_summary: string;
+    node_b_uid: string;
+    node_b_label: string;
+    node_b_summary: string;
+    node_type: string;
+    /** Similarity score that triggered the candidate (e.g. cosine), if known. */
+    similarity: number | null;
+    /** How the candidate was found: "exact" | "fuzzy" | "semantic" | "llm". */
+    method: string | null;
+}
 /** A `/retrieve` hybrid result: the full node plus the fused RRF score. */
 interface HybridSearchResult {
     node: GraphNode;
@@ -1144,6 +1159,12 @@ declare class MindGraph {
     getOpenQuestions(): Promise<GraphNode[]>;
     getWeakClaims(): Promise<GraphNode[]>;
     getContradictions(): Promise<unknown[]>;
+    /**
+     * Pending merge candidates: suspected duplicate pairs recorded by the dedup
+     * pipeline's ambiguous zone as PossibleDuplicate edges, awaiting a human
+     * merge/dismiss decision (server >= 1.3).
+     */
+    getMergeCandidates(): Promise<MergeCandidate[]>;
     getPendingApprovals(): Promise<GraphNode[]>;
     ingestChunk(req: IngestChunkRequest): Promise<IngestChunkResponse>;
     ingestDocument(req: IngestDocumentRequest): Promise<IngestDocumentResponse>;

package/dist/index.js

@@ -531,6 +531,14 @@ var MindGraph = class {
   async getContradictions() {
     return this.get("/contradictions");
   }
+  /**
+   * Pending merge candidates: suspected duplicate pairs recorded by the dedup
+   * pipeline's ambiguous zone as PossibleDuplicate edges, awaiting a human
+   * merge/dismiss decision (server >= 1.3).
+   */
+  async getMergeCandidates() {
+    return this.post("/retrieve", { action: "merge_candidates" });
+  }
   async getPendingApprovals() {
     return this.get("/approvals/pending");
   }

package/dist/index.mjs

@@ -504,6 +504,14 @@ var MindGraph = class {
   async getContradictions() {
     return this.get("/contradictions");
   }
+  /**
+   * Pending merge candidates: suspected duplicate pairs recorded by the dedup
+   * pipeline's ambiguous zone as PossibleDuplicate edges, awaiting a human
+   * merge/dismiss decision (server >= 1.3).
+   */
+  async getMergeCandidates() {
+    return this.post("/retrieve", { action: "merge_candidates" });
+  }
   async getPendingApprovals() {
     return this.get("/approvals/pending");
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindgraph",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "TypeScript client for the MindGraph Cloud API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",