mindgraph 0.2.1 → 0.3.0

package/dist/index.d.mts

@@ -30,6 +30,18 @@ interface SearchResult {
     node_type: string;
     score: number;
 }
+interface SearchChunk {
+    chunk_uid: string;
+    content: string;
+    document_uid: string | null;
+    document_title: string | null;
+    chunk_index: number | null;
+}
+interface EnrichedSearchResponse {
+    results: SearchResult[];
+    edges: GraphEdge[];
+    chunks: SearchChunk[];
+}
 interface PathStep {
     uid: string;
     label: string;
@@ -397,24 +409,48 @@ interface IngestSessionRequest {
 }
 interface RetrieveContextRequest {
     query: string;
-    k?: number;
-    depth?: number;
+    /** Max graph nodes to return (default 10). */
+    node_limit?: number;
+    /** Max wiki articles to return (default 3). Set to 0 to skip. */
+    article_limit?: number;
+    /** Max raw chunks to return (default 0). Set > 0 to include source text. */
+    chunk_limit?: number;
     node_types?: string[];
     layer?: string;
-    include_chunks?: boolean;
     include_graph?: boolean;
     min_similarity?: number;
 }
+interface ArticleResult {
+    uid: string;
+    label: string;
+    content: string;
+    article_type: string;
+    covers_uid: string | null;
+    questions: string[] | null;
+    score: number;
+}
+interface ListArticlesResponse {
+    articles: GraphNode[];
+    total: number;
+    has_more: boolean;
+}
 interface RetrieveContextResponse {
-    chunks: {
+    articles?: ArticleResult[];
+    chunks?: {
         chunk_uid: string;
         content: string;
         score: number;
         document_uid: string | null;
+        document_title: string | null;
         chunk_index: number | null;
     }[];
     graph: {
-        nodes: Record<string, unknown>[];
+        nodes: (Record<string, unknown> & {
+            source_documents?: {
+                uid: string;
+                title: string;
+            }[];
+        })[];
         edges: Record<string, unknown>[];
     };
 }
@@ -686,7 +722,10 @@ declare class MindGraph {
         node_type?: string;
         layer?: string;
         limit?: number;
-    }): Promise<SearchResult[]>;
+        min_score?: number;
+        include_edges?: boolean;
+        include_chunks?: boolean;
+    }): Promise<SearchResult[] | EnrichedSearchResponse>;
     /** Hybrid BM25 + vector search with reciprocal rank fusion. */
     hybridSearch(query: string, opts?: {
         k?: number;
@@ -764,6 +803,11 @@ declare class MindGraph {
     ingestDocument(req: IngestDocumentRequest): Promise<IngestDocumentResponse>;
     ingestSession(req: IngestSessionRequest): Promise<IngestDocumentResponse>;
     retrieveContext(req: RetrieveContextRequest): Promise<RetrieveContextResponse>;
+    /** Backfill node_source provenance for existing graphs. */
+    backfillNodeSources(): Promise<{
+        documents_processed: number;
+        node_source_pairs_added: number;
+    }>;
     listJobs(): Promise<Job[]>;
     getJob(id: string): Promise<Job>;
     cancelJob(id: string): Promise<unknown>;
@@ -781,6 +825,33 @@ declare class MindGraph {
     cleanupOrphans(): Promise<unknown>;
     embedAll(): Promise<unknown>;
     clearGraph(): Promise<ClearResponse>;
+    /** List wiki articles with optional filters. */
+    listArticles(params?: {
+        article_type?: string;
+        covers_node_type?: string;
+        search?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<ListArticlesResponse>;
+    /** Get a single wiki article by UID. */
+    getArticle(uid: string): Promise<GraphNode>;
+    /** Find the article that covers or summarizes a given entity/document UID. */
+    getArticleBySubject(subjectUid: string): Promise<GraphNode | null>;
+    /** Update an article's markdown content (user editing). */
+    updateArticle(uid: string, content: string): Promise<GraphNode>;
+    /** Trigger wiki compilation for a specific document. */
+    compileDocument(docUid: string): Promise<{
+        job_id?: string;
+        status: string;
+    }>;
+    /** Trigger wiki compilation for a specific entity. */
+    compileEntity(entityUid: string): Promise<{
+        job_id: string;
+    }>;
+    /** Backfill: compile articles for all documents and eligible entities. */
+    compileAll(): Promise<{
+        job_id: string;
+    }>;
 }
 
-export { type ArgumentRequest, type BatchRequest, type CaptureRequest, type ClearResponse, type CommitmentRequest, type DecayRequest, type DeliberationRequest, type DistillRequest, type EntityRequest, type EventProps, type EvolveRequest, type ExecutionRequest, type GovernanceRequest, type GraphEdge, type GraphNode, type IngestChunkRequest, type IngestChunkResponse, type IngestDocumentRequest, type IngestDocumentResponse, type IngestSessionRequest, type InquiryRequest, type Job, type MemoryConfigRequest, MindGraph, type MindGraphConfig, MindGraphError, type NationProps, type OrganizationProps, type PathStep, type PersonProps, type PlaceProps, type PlanRequest, type ProcedureRequest, type PurgeRequest, type RetrieveContextRequest, type RetrieveContextResponse, type RetrieveRequest, type RiskRequest, type SearchResult, type SessionRequest, type StructureRequest, type TraverseRequest };
+export { type ArgumentRequest, type ArticleResult, type BatchRequest, type CaptureRequest, type ClearResponse, type CommitmentRequest, type DecayRequest, type DeliberationRequest, type DistillRequest, type EnrichedSearchResponse, type EntityRequest, type EventProps, type EvolveRequest, type ExecutionRequest, type GovernanceRequest, type GraphEdge, type GraphNode, type IngestChunkRequest, type IngestChunkResponse, type IngestDocumentRequest, type IngestDocumentResponse, type IngestSessionRequest, type InquiryRequest, type Job, type ListArticlesResponse, type MemoryConfigRequest, MindGraph, type MindGraphConfig, MindGraphError, type NationProps, type OrganizationProps, type PathStep, type PersonProps, type PlaceProps, type PlanRequest, type ProcedureRequest, type PurgeRequest, type RetrieveContextRequest, type RetrieveContextResponse, type RetrieveRequest, type RiskRequest, type SearchChunk, type SearchResult, type SessionRequest, type StructureRequest, type TraverseRequest };

package/dist/index.d.ts

@@ -30,6 +30,18 @@ interface SearchResult {
     node_type: string;
     score: number;
 }
+interface SearchChunk {
+    chunk_uid: string;
+    content: string;
+    document_uid: string | null;
+    document_title: string | null;
+    chunk_index: number | null;
+}
+interface EnrichedSearchResponse {
+    results: SearchResult[];
+    edges: GraphEdge[];
+    chunks: SearchChunk[];
+}
 interface PathStep {
     uid: string;
     label: string;
@@ -397,24 +409,48 @@ interface IngestSessionRequest {
 }
 interface RetrieveContextRequest {
     query: string;
-    k?: number;
-    depth?: number;
+    /** Max graph nodes to return (default 10). */
+    node_limit?: number;
+    /** Max wiki articles to return (default 3). Set to 0 to skip. */
+    article_limit?: number;
+    /** Max raw chunks to return (default 0). Set > 0 to include source text. */
+    chunk_limit?: number;
     node_types?: string[];
     layer?: string;
-    include_chunks?: boolean;
     include_graph?: boolean;
     min_similarity?: number;
 }
+interface ArticleResult {
+    uid: string;
+    label: string;
+    content: string;
+    article_type: string;
+    covers_uid: string | null;
+    questions: string[] | null;
+    score: number;
+}
+interface ListArticlesResponse {
+    articles: GraphNode[];
+    total: number;
+    has_more: boolean;
+}
 interface RetrieveContextResponse {
-    chunks: {
+    articles?: ArticleResult[];
+    chunks?: {
         chunk_uid: string;
         content: string;
         score: number;
         document_uid: string | null;
+        document_title: string | null;
         chunk_index: number | null;
     }[];
     graph: {
-        nodes: Record<string, unknown>[];
+        nodes: (Record<string, unknown> & {
+            source_documents?: {
+                uid: string;
+                title: string;
+            }[];
+        })[];
         edges: Record<string, unknown>[];
     };
 }
@@ -686,7 +722,10 @@ declare class MindGraph {
         node_type?: string;
         layer?: string;
         limit?: number;
-    }): Promise<SearchResult[]>;
+        min_score?: number;
+        include_edges?: boolean;
+        include_chunks?: boolean;
+    }): Promise<SearchResult[] | EnrichedSearchResponse>;
     /** Hybrid BM25 + vector search with reciprocal rank fusion. */
     hybridSearch(query: string, opts?: {
         k?: number;
@@ -764,6 +803,11 @@ declare class MindGraph {
     ingestDocument(req: IngestDocumentRequest): Promise<IngestDocumentResponse>;
     ingestSession(req: IngestSessionRequest): Promise<IngestDocumentResponse>;
     retrieveContext(req: RetrieveContextRequest): Promise<RetrieveContextResponse>;
+    /** Backfill node_source provenance for existing graphs. */
+    backfillNodeSources(): Promise<{
+        documents_processed: number;
+        node_source_pairs_added: number;
+    }>;
     listJobs(): Promise<Job[]>;
     getJob(id: string): Promise<Job>;
     cancelJob(id: string): Promise<unknown>;
@@ -781,6 +825,33 @@ declare class MindGraph {
     cleanupOrphans(): Promise<unknown>;
     embedAll(): Promise<unknown>;
     clearGraph(): Promise<ClearResponse>;
+    /** List wiki articles with optional filters. */
+    listArticles(params?: {
+        article_type?: string;
+        covers_node_type?: string;
+        search?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<ListArticlesResponse>;
+    /** Get a single wiki article by UID. */
+    getArticle(uid: string): Promise<GraphNode>;
+    /** Find the article that covers or summarizes a given entity/document UID. */
+    getArticleBySubject(subjectUid: string): Promise<GraphNode | null>;
+    /** Update an article's markdown content (user editing). */
+    updateArticle(uid: string, content: string): Promise<GraphNode>;
+    /** Trigger wiki compilation for a specific document. */
+    compileDocument(docUid: string): Promise<{
+        job_id?: string;
+        status: string;
+    }>;
+    /** Trigger wiki compilation for a specific entity. */
+    compileEntity(entityUid: string): Promise<{
+        job_id: string;
+    }>;
+    /** Backfill: compile articles for all documents and eligible entities. */
+    compileAll(): Promise<{
+        job_id: string;
+    }>;
 }
 
-export { type ArgumentRequest, type BatchRequest, type CaptureRequest, type ClearResponse, type CommitmentRequest, type DecayRequest, type DeliberationRequest, type DistillRequest, type EntityRequest, type EventProps, type EvolveRequest, type ExecutionRequest, type GovernanceRequest, type GraphEdge, type GraphNode, type IngestChunkRequest, type IngestChunkResponse, type IngestDocumentRequest, type IngestDocumentResponse, type IngestSessionRequest, type InquiryRequest, type Job, type MemoryConfigRequest, MindGraph, type MindGraphConfig, MindGraphError, type NationProps, type OrganizationProps, type PathStep, type PersonProps, type PlaceProps, type PlanRequest, type ProcedureRequest, type PurgeRequest, type RetrieveContextRequest, type RetrieveContextResponse, type RetrieveRequest, type RiskRequest, type SearchResult, type SessionRequest, type StructureRequest, type TraverseRequest };
+export { type ArgumentRequest, type ArticleResult, type BatchRequest, type CaptureRequest, type ClearResponse, type CommitmentRequest, type DecayRequest, type DeliberationRequest, type DistillRequest, type EnrichedSearchResponse, type EntityRequest, type EventProps, type EvolveRequest, type ExecutionRequest, type GovernanceRequest, type GraphEdge, type GraphNode, type IngestChunkRequest, type IngestChunkResponse, type IngestDocumentRequest, type IngestDocumentResponse, type IngestSessionRequest, type InquiryRequest, type Job, type ListArticlesResponse, type MemoryConfigRequest, MindGraph, type MindGraphConfig, MindGraphError, type NationProps, type OrganizationProps, type PathStep, type PersonProps, type PlaceProps, type PlanRequest, type ProcedureRequest, type PurgeRequest, type RetrieveContextRequest, type RetrieveContextResponse, type RetrieveRequest, type RiskRequest, type SearchChunk, type SearchResult, type SessionRequest, type StructureRequest, type TraverseRequest };

package/dist/index.js

@@ -540,6 +540,10 @@ var MindGraph = class {
   async retrieveContext(req) {
     return this.post("/retrieve/context", req);
   }
+  /** Backfill node_source provenance for existing graphs. */
+  async backfillNodeSources() {
+    return this.post("/backfill/node-sources", {});
+  }
   async listJobs() {
     return this.get("/jobs");
   }
@@ -566,6 +570,45 @@ var MindGraph = class {
   async clearGraph() {
     return this.post("/clear", {});
   }
+  // ── Wiki ──────────────────────────────────────────────────────────────
+  /** List wiki articles with optional filters. */
+  async listArticles(params) {
+    const q = new URLSearchParams();
+    if (params?.article_type) q.set("article_type", params.article_type);
+    if (params?.covers_node_type) q.set("covers_node_type", params.covers_node_type);
+    if (params?.search) q.set("search", params.search);
+    if (params?.limit) q.set("limit", String(params.limit));
+    if (params?.offset) q.set("offset", String(params.offset));
+    return this.get(`/wiki/articles?${q}`);
+  }
+  /** Get a single wiki article by UID. */
+  async getArticle(uid) {
+    return this.get(`/wiki/article/${uid}`);
+  }
+  /** Find the article that covers or summarizes a given entity/document UID. */
+  async getArticleBySubject(subjectUid) {
+    try {
+      return await this.get(`/wiki/article/by-subject/${subjectUid}`);
+    } catch {
+      return null;
+    }
+  }
+  /** Update an article's markdown content (user editing). */
+  async updateArticle(uid, content) {
+    return this.patch(`/wiki/article/${uid}`, { content });
+  }
+  /** Trigger wiki compilation for a specific document. */
+  async compileDocument(docUid) {
+    return this.post(`/wiki/compile/${docUid}`, {});
+  }
+  /** Trigger wiki compilation for a specific entity. */
+  async compileEntity(entityUid) {
+    return this.post(`/wiki/compile/entity/${entityUid}`, {});
+  }
+  /** Backfill: compile articles for all documents and eligible entities. */
+  async compileAll() {
+    return this.post("/wiki/compile/all", {});
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -513,6 +513,10 @@ var MindGraph = class {
   async retrieveContext(req) {
     return this.post("/retrieve/context", req);
   }
+  /** Backfill node_source provenance for existing graphs. */
+  async backfillNodeSources() {
+    return this.post("/backfill/node-sources", {});
+  }
   async listJobs() {
     return this.get("/jobs");
   }
@@ -539,6 +543,45 @@ var MindGraph = class {
   async clearGraph() {
     return this.post("/clear", {});
   }
+  // ── Wiki ──────────────────────────────────────────────────────────────
+  /** List wiki articles with optional filters. */
+  async listArticles(params) {
+    const q = new URLSearchParams();
+    if (params?.article_type) q.set("article_type", params.article_type);
+    if (params?.covers_node_type) q.set("covers_node_type", params.covers_node_type);
+    if (params?.search) q.set("search", params.search);
+    if (params?.limit) q.set("limit", String(params.limit));
+    if (params?.offset) q.set("offset", String(params.offset));
+    return this.get(`/wiki/articles?${q}`);
+  }
+  /** Get a single wiki article by UID. */
+  async getArticle(uid) {
+    return this.get(`/wiki/article/${uid}`);
+  }
+  /** Find the article that covers or summarizes a given entity/document UID. */
+  async getArticleBySubject(subjectUid) {
+    try {
+      return await this.get(`/wiki/article/by-subject/${subjectUid}`);
+    } catch {
+      return null;
+    }
+  }
+  /** Update an article's markdown content (user editing). */
+  async updateArticle(uid, content) {
+    return this.patch(`/wiki/article/${uid}`, { content });
+  }
+  /** Trigger wiki compilation for a specific document. */
+  async compileDocument(docUid) {
+    return this.post(`/wiki/compile/${docUid}`, {});
+  }
+  /** Trigger wiki compilation for a specific entity. */
+  async compileEntity(entityUid) {
+    return this.post(`/wiki/compile/entity/${entityUid}`, {});
+  }
+  /** Backfill: compile articles for all documents and eligible entities. */
+  async compileAll() {
+    return this.post("/wiki/compile/all", {});
+  }
 };
 export {
   MindGraph,

package/package.json

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