mindgraph 0.1.7 → 0.1.9

package/dist/index.d.mts

@@ -318,6 +318,16 @@ interface IngestDocumentRequest {
     chunk_overlap?: number;
     layers?: string[];
     agent_id?: string;
+    /** Paper metadata */
+    authors?: string[];
+    abstract_text?: string;
+    doi?: string;
+    publication_date?: string;
+    journal?: string;
+    keywords?: string[];
+    citation_count?: number;
+    arxiv_id?: string;
+    language?: string;
 }
 interface IngestDocumentResponse {
     job_id: string;
@@ -403,6 +413,10 @@ interface MindGraphConfig {
     baseUrl: string;
     apiKey?: string;
     jwt?: string;
+    /** Max retries for 503 (server warming up) responses. Default: 3. Set to 0 to disable. */
+    maxRetries?: number;
+    /** Initial backoff in ms before first retry. Doubles each attempt. Default: 1000. */
+    retryBackoffMs?: number;
 }
 
 declare class MindGraphError extends Error {
@@ -413,6 +427,8 @@ declare class MindGraphError extends Error {
 declare class MindGraph {
     private baseUrl;
     private headers;
+    private maxRetries;
+    private retryBackoffMs;
     constructor(config: MindGraphConfig);
     private request;
     private get;
@@ -577,6 +593,10 @@ declare class MindGraph {
     }): Promise<unknown>;
     getAgentNodes(agentId: string): Promise<GraphNode[]>;
     batch(req: BatchRequest): Promise<unknown>;
+    /** Fetch multiple nodes by UID in a single request. */
+    getNodesBatch(uids: string[]): Promise<GraphNode[]>;
+    /** Fetch all edges between a set of node UIDs. */
+    getEdgesBatch(uids: string[]): Promise<GraphEdge[]>;
     configureEmbeddings(body: {
         model: string;
         dimensions: number;
@@ -639,6 +659,17 @@ declare class MindGraph {
     listJobs(): Promise<Job[]>;
     getJob(id: string): Promise<Job>;
     cancelJob(id: string): Promise<unknown>;
+    /** Resume ingestion of a document that has failed chunks. */
+    resumeDocument(docUid: string, opts?: {
+        layers?: string[];
+        agent_id?: string;
+    }): Promise<{
+        job_id: string;
+        document_uid: string;
+        chunks_to_resume: number;
+    }>;
+    /** Delete a document and all its chunks and extracted nodes. */
+    deleteDocument(uid: string): Promise<unknown>;
     cleanupOrphans(): Promise<unknown>;
     embedAll(): Promise<unknown>;
     clearGraph(): Promise<ClearResponse>;

package/dist/index.d.ts

@@ -318,6 +318,16 @@ interface IngestDocumentRequest {
     chunk_overlap?: number;
     layers?: string[];
     agent_id?: string;
+    /** Paper metadata */
+    authors?: string[];
+    abstract_text?: string;
+    doi?: string;
+    publication_date?: string;
+    journal?: string;
+    keywords?: string[];
+    citation_count?: number;
+    arxiv_id?: string;
+    language?: string;
 }
 interface IngestDocumentResponse {
     job_id: string;
@@ -403,6 +413,10 @@ interface MindGraphConfig {
     baseUrl: string;
     apiKey?: string;
     jwt?: string;
+    /** Max retries for 503 (server warming up) responses. Default: 3. Set to 0 to disable. */
+    maxRetries?: number;
+    /** Initial backoff in ms before first retry. Doubles each attempt. Default: 1000. */
+    retryBackoffMs?: number;
 }
 
 declare class MindGraphError extends Error {
@@ -413,6 +427,8 @@ declare class MindGraphError extends Error {
 declare class MindGraph {
     private baseUrl;
     private headers;
+    private maxRetries;
+    private retryBackoffMs;
     constructor(config: MindGraphConfig);
     private request;
     private get;
@@ -577,6 +593,10 @@ declare class MindGraph {
     }): Promise<unknown>;
     getAgentNodes(agentId: string): Promise<GraphNode[]>;
     batch(req: BatchRequest): Promise<unknown>;
+    /** Fetch multiple nodes by UID in a single request. */
+    getNodesBatch(uids: string[]): Promise<GraphNode[]>;
+    /** Fetch all edges between a set of node UIDs. */
+    getEdgesBatch(uids: string[]): Promise<GraphEdge[]>;
     configureEmbeddings(body: {
         model: string;
         dimensions: number;
@@ -639,6 +659,17 @@ declare class MindGraph {
     listJobs(): Promise<Job[]>;
     getJob(id: string): Promise<Job>;
     cancelJob(id: string): Promise<unknown>;
+    /** Resume ingestion of a document that has failed chunks. */
+    resumeDocument(docUid: string, opts?: {
+        layers?: string[];
+        agent_id?: string;
+    }): Promise<{
+        job_id: string;
+        document_uid: string;
+        chunks_to_resume: number;
+    }>;
+    /** Delete a document and all its chunks and extracted nodes. */
+    deleteDocument(uid: string): Promise<unknown>;
     cleanupOrphans(): Promise<unknown>;
     embedAll(): Promise<unknown>;
     clearGraph(): Promise<ClearResponse>;

package/dist/index.js

@@ -43,6 +43,8 @@ var MindGraph = class {
     } else if (config.jwt) {
       this.headers["Authorization"] = `Bearer ${config.jwt}`;
     }
+    this.maxRetries = config.maxRetries ?? 3;
+    this.retryBackoffMs = config.retryBackoffMs ?? 1e3;
   }
   // ---- HTTP helpers ----
   async request(method, path, body) {
@@ -54,24 +56,35 @@ var MindGraph = class {
     if (body !== void 0) {
       init.body = JSON.stringify(body);
     }
-    const res = await fetch(url, init);
-    if (!res.ok) {
-      const text2 = await res.text().catch(() => "");
-      let parsed;
-      try {
-        parsed = JSON.parse(text2);
-      } catch {
-        parsed = text2;
+    let lastError;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      const res = await fetch(url, init);
+      if (!res.ok) {
+        const text2 = await res.text().catch(() => "");
+        let parsed;
+        try {
+          parsed = JSON.parse(text2);
+        } catch {
+          parsed = text2;
+        }
+        const err = new MindGraphError(
+          `${method} ${path} failed: ${res.status}`,
+          res.status,
+          parsed
+        );
+        if (res.status === 503 && attempt < this.maxRetries) {
+          lastError = err;
+          const delay = this.retryBackoffMs * 2 ** attempt;
+          await new Promise((r) => setTimeout(r, delay));
+          continue;
+        }
+        throw err;
       }
-      throw new MindGraphError(
-        `${method} ${path} failed: ${res.status}`,
-        res.status,
-        parsed
-      );
+      const text = await res.text();
+      if (!text) return void 0;
+      return JSON.parse(text);
     }
-    const text = await res.text();
-    if (!text) return void 0;
-    return JSON.parse(text);
+    throw lastError;
   }
   get(path) {
     return this.request("GET", path);
@@ -329,6 +342,14 @@ var MindGraph = class {
   async batch(req) {
     return this.post("/batch", req);
   }
+  /** Fetch multiple nodes by UID in a single request. */
+  async getNodesBatch(uids) {
+    return this.post("/nodes/batch", { uids });
+  }
+  /** Fetch all edges between a set of node UIDs. */
+  async getEdgesBatch(uids) {
+    return this.post("/edges/batch", { uids });
+  }
   // ---- Embeddings ----
   async configureEmbeddings(body) {
     return this.post("/embeddings/configure", body);
@@ -452,6 +473,14 @@ var MindGraph = class {
   async cancelJob(id) {
     return this.post(`/jobs/${id}/cancel`, {});
   }
+  /** Resume ingestion of a document that has failed chunks. */
+  async resumeDocument(docUid, opts) {
+    return this.post(`/ingest/resume/${docUid}`, opts ?? {});
+  }
+  /** Delete a document and all its chunks and extracted nodes. */
+  async deleteDocument(uid) {
+    return this.del(`/ingest/document/${uid}`);
+  }
   async cleanupOrphans() {
     return this.post("/ingest/cleanup", {});
   }

package/dist/index.mjs

@@ -16,6 +16,8 @@ var MindGraph = class {
     } else if (config.jwt) {
       this.headers["Authorization"] = `Bearer ${config.jwt}`;
     }
+    this.maxRetries = config.maxRetries ?? 3;
+    this.retryBackoffMs = config.retryBackoffMs ?? 1e3;
   }
   // ---- HTTP helpers ----
   async request(method, path, body) {
@@ -27,24 +29,35 @@ var MindGraph = class {
     if (body !== void 0) {
       init.body = JSON.stringify(body);
     }
-    const res = await fetch(url, init);
-    if (!res.ok) {
-      const text2 = await res.text().catch(() => "");
-      let parsed;
-      try {
-        parsed = JSON.parse(text2);
-      } catch {
-        parsed = text2;
+    let lastError;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      const res = await fetch(url, init);
+      if (!res.ok) {
+        const text2 = await res.text().catch(() => "");
+        let parsed;
+        try {
+          parsed = JSON.parse(text2);
+        } catch {
+          parsed = text2;
+        }
+        const err = new MindGraphError(
+          `${method} ${path} failed: ${res.status}`,
+          res.status,
+          parsed
+        );
+        if (res.status === 503 && attempt < this.maxRetries) {
+          lastError = err;
+          const delay = this.retryBackoffMs * 2 ** attempt;
+          await new Promise((r) => setTimeout(r, delay));
+          continue;
+        }
+        throw err;
       }
-      throw new MindGraphError(
-        `${method} ${path} failed: ${res.status}`,
-        res.status,
-        parsed
-      );
+      const text = await res.text();
+      if (!text) return void 0;
+      return JSON.parse(text);
     }
-    const text = await res.text();
-    if (!text) return void 0;
-    return JSON.parse(text);
+    throw lastError;
   }
   get(path) {
     return this.request("GET", path);
@@ -302,6 +315,14 @@ var MindGraph = class {
   async batch(req) {
     return this.post("/batch", req);
   }
+  /** Fetch multiple nodes by UID in a single request. */
+  async getNodesBatch(uids) {
+    return this.post("/nodes/batch", { uids });
+  }
+  /** Fetch all edges between a set of node UIDs. */
+  async getEdgesBatch(uids) {
+    return this.post("/edges/batch", { uids });
+  }
   // ---- Embeddings ----
   async configureEmbeddings(body) {
     return this.post("/embeddings/configure", body);
@@ -425,6 +446,14 @@ var MindGraph = class {
   async cancelJob(id) {
     return this.post(`/jobs/${id}/cancel`, {});
   }
+  /** Resume ingestion of a document that has failed chunks. */
+  async resumeDocument(docUid, opts) {
+    return this.post(`/ingest/resume/${docUid}`, opts ?? {});
+  }
+  /** Delete a document and all its chunks and extracted nodes. */
+  async deleteDocument(uid) {
+    return this.del(`/ingest/document/${uid}`);
+  }
   async cleanupOrphans() {
     return this.post("/ingest/cleanup", {});
   }

package/package.json

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