mindgraph 0.13.0 → 0.15.0

package/dist/index.mjs

@@ -1,4 +1,7 @@
 // src/client.ts
+function seg(value) {
+  return encodeURIComponent(String(value));
+}
 var MindGraphError = class extends Error {
   constructor(message, status, body) {
     super(message);
@@ -56,7 +59,8 @@ var MindGraph = class {
         );
         if (res.status === 503 && attempt < this.maxRetries) {
           lastError = err;
-          const delay = this.retryBackoffMs * 2 ** attempt;
+          const retryAfterSecs = Number(res.headers.get("retry-after"));
+          const delay = Number.isFinite(retryAfterSecs) && retryAfterSecs > 0 ? Math.min(retryAfterSecs * 1e3, 1e4) : this.retryBackoffMs * 2 ** attempt;
           await new Promise((r) => setTimeout(r, delay));
           continue;
         }
@@ -107,6 +111,52 @@ var MindGraph = class {
   async entity(req) {
     return this.post("/reality/entity", req);
   }
+  async series(req) {
+    return this.post("/reality/series", req);
+  }
+  async createSeries(req) {
+    return this.post("/reality/series", { action: "create", ...req });
+  }
+  async appendSeries(req) {
+    return this.post("/reality/series", { action: "append", ...req });
+  }
+  async seriesWindow(req) {
+    return this.post("/reality/series", { action: "window", ...req });
+  }
+  async aggregateSeries(req) {
+    return this.post("/reality/series", { action: "aggregate", ...req });
+  }
+  async latestSeries(seriesUid, options) {
+    return this.post("/reality/series", {
+      action: "latest",
+      series_uid: seriesUid,
+      ...options
+    });
+  }
+  async listSeriesForEntity(entityUid, options) {
+    return this.post("/reality/series", {
+      action: "list_for_entity",
+      entity_uid: entityUid,
+      ...options
+    });
+  }
+  async batchLatestSeries(entityUids, options) {
+    return this.post("/reality/series", {
+      action: "batch_latest",
+      entity_uids: entityUids,
+      ...options
+    });
+  }
+  async batchAggregateSeries(req) {
+    return this.post("/reality/series", { action: "batch_aggregate", ...req });
+  }
+  async deleteSeries(seriesUid, options) {
+    return this.post("/reality/series", {
+      action: "delete_series",
+      series_uid: seriesUid,
+      ...options
+    });
+  }
   /** Convenience: create or find an entity by label. */
   async findOrCreateEntity(label, props, agentId) {
     return this.post("/reality/entity", {
@@ -268,6 +318,9 @@ var MindGraph = class {
   async memoryConfig(req) {
     return this.post("/memory/config", req);
   }
+  async memorySync(req) {
+    return this.post("/memory/sync", req);
+  }
   // ---- Agent Layer ----
   async plan(req) {
     return this.post("/agent/plan", req);
@@ -291,7 +344,7 @@ var MindGraph = class {
   }
   // ---- Node CRUD ----
   async getNode(uid) {
-    return this.get(`/node/${uid}`);
+    return this.get(`/node/${seg(uid)}`);
   }
   /**
    * Create a node via the low-level CRUD endpoint.
@@ -308,10 +361,10 @@ var MindGraph = class {
     return this.post("/node", { ...body, props });
   }
   async updateNode(uid, body) {
-    return this.patch(`/node/${uid}`, body);
+    return this.patch(`/node/${seg(uid)}`, body);
   }
   async deleteNode(uid) {
-    await this.del(`/node/${uid}`);
+    await this.del(`/node/${seg(uid)}`);
   }
   async batchDeleteNodes(params) {
     const body = {};
@@ -332,10 +385,10 @@ var MindGraph = class {
     return this.post("/nodes/delete", body);
   }
   async getNodeHistory(uid) {
-    return this.get(`/node/${uid}/history`);
+    return this.get(`/node/${seg(uid)}/history`);
   }
   async getNodeAtVersion(uid, version) {
-    return this.get(`/node/${uid}/history/${version}`);
+    return this.get(`/node/${seg(uid)}/history/${seg(version)}`);
   }
   // ---- Edge CRUD ----
   async addLink(body) {
@@ -356,13 +409,13 @@ var MindGraph = class {
     return this.post("/edge", { ...body, props });
   }
   async updateEdge(uid, body) {
-    return this.patch(`/edge/${uid}`, body);
+    return this.patch(`/edge/${seg(uid)}`, body);
   }
   async deleteEdge(uid) {
-    await this.del(`/edge/${uid}`);
+    await this.del(`/edge/${seg(uid)}`);
   }
   async getEdgeHistory(uid) {
-    return this.get(`/edge/${uid}/history`);
+    return this.get(`/edge/${seg(uid)}/history`);
   }
   /**
    * List edges filtered by source and/or target node.
@@ -411,7 +464,7 @@ var MindGraph = class {
     return this.get(`/nodes?${qs}`);
   }
   async getAgentNodes(agentId) {
-    return this.get(`/agent/${agentId}/nodes`);
+    return this.get(`/agent/${seg(agentId)}/nodes`);
   }
   // ---- Batch ----
   async batch(req) {
@@ -436,13 +489,13 @@ var MindGraph = class {
     return this.post("/embeddings/search-text", body);
   }
   async getEmbedding(uid) {
-    return this.get(`/node/${uid}/embedding`);
+    return this.get(`/node/${seg(uid)}/embedding`);
   }
   async setEmbedding(uid, vector) {
-    await this.request("PUT", `/node/${uid}/embedding`, { vector });
+    await this.request("PUT", `/node/${seg(uid)}/embedding`, { vector });
   }
   async deleteEmbedding(uid) {
-    await this.del(`/node/${uid}/embedding`);
+    await this.del(`/node/${seg(uid)}/embedding`);
   }
   // ---- Entity resolution ----
   async mergeEntities(body) {
@@ -452,7 +505,7 @@ var MindGraph = class {
     return this.post("/alias", body);
   }
   async getAliases(uid) {
-    return this.get(`/aliases/${uid}`);
+    return this.get(`/aliases/${seg(uid)}`);
   }
   async resolveAlias(text) {
     return this.get(`/resolve?text=${encodeURIComponent(text)}`);
@@ -575,18 +628,18 @@ var MindGraph = class {
     return this.get("/jobs");
   }
   async getJob(id) {
-    return this.get(`/jobs/${id}`);
+    return this.get(`/jobs/${seg(id)}`);
   }
   async cancelJob(id) {
-    return this.post(`/jobs/${id}/cancel`, {});
+    return this.post(`/jobs/${seg(id)}/cancel`, {});
   }
   /** Resume ingestion of a document that has failed chunks. */
   async resumeDocument(docUid, opts) {
-    return this.post(`/ingest/resume/${docUid}`, opts ?? {});
+    return this.post(`/ingest/resume/${seg(docUid)}`, opts ?? {});
   }
   /** Delete a document and all its chunks and extracted nodes. */
   async deleteDocument(uid) {
-    return this.del(`/ingest/document/${uid}`);
+    return this.del(`/ingest/document/${seg(uid)}`);
   }
   async cleanupOrphans() {
     return this.post("/ingest/cleanup", {});
@@ -610,27 +663,27 @@ var MindGraph = class {
   }
   /** Get a single wiki article by UID. */
   async getArticle(uid) {
-    return this.get(`/wiki/article/${uid}`);
+    return this.get(`/wiki/article/${seg(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}`);
+      return await this.get(`/wiki/article/by-subject/${seg(subjectUid)}`);
     } catch {
       return null;
     }
   }
   /** Update an article's markdown content (user editing). */
   async updateArticle(uid, content) {
-    return this.patch(`/wiki/article/${uid}`, { content });
+    return this.patch(`/wiki/article/${seg(uid)}`, { content });
   }
   /** Trigger wiki compilation for a specific document. */
   async compileDocument(docUid) {
-    return this.post(`/wiki/compile/${docUid}`, {});
+    return this.post(`/wiki/compile/${seg(docUid)}`, {});
   }
   /** Trigger wiki compilation for a specific entity. */
   async compileEntity(entityUid) {
-    return this.post(`/wiki/compile/entity/${entityUid}`, {});
+    return this.post(`/wiki/compile/entity/${seg(entityUid)}`, {});
   }
   /** Backfill: compile articles for all documents and eligible entities. */
   async compileAll() {
@@ -651,7 +704,7 @@ var MindGraph = class {
     if (opts?.signals) q.set("signals", opts.signals);
     if (opts?.target_types) q.set("target_types", opts.target_types);
     const qs = q.toString();
-    return this.get(`/synthesis/signals/${projectUid}${qs ? `?${qs}` : ""}`);
+    return this.get(`/synthesis/signals/${seg(projectUid)}${qs ? `?${qs}` : ""}`);
   }
   /**
    * Spawn a background synthesis job for a project: mines signals,
@@ -661,7 +714,7 @@ var MindGraph = class {
    * Returns a `job_id` immediately; poll `getJob(id)` for progress.
    */
   async runSynthesis(projectUid) {
-    return this.post(`/synthesis/run/${projectUid}`, {});
+    return this.post(`/synthesis/run/${seg(projectUid)}`, {});
   }
   // ============================================================================
   // Operational Ontology Layer (Layer 7)
@@ -671,22 +724,36 @@ var MindGraph = class {
     return this.get("/v1/ontology/schemas");
   }
   async getOntologySchema(id) {
-    return this.get(`/v1/ontology/schemas/${id}`);
+    return this.get(`/v1/ontology/schemas/${seg(id)}`);
+  }
+  async createOntologySeriesBinding(schemaId, request) {
+    return this.post(`/v1/ontology/schemas/${seg(schemaId)}/series-bindings`, request);
+  }
+  async syncOntologySeriesBinding(bindingId, mode) {
+    return this.post(
+      `/v1/ontology/series-bindings/${seg(bindingId)}/sync`,
+      mode ? { mode } : {}
+    );
+  }
+  async archiveOntologySeriesBinding(schemaId, bindingId) {
+    return this.del(
+      `/v1/ontology/schemas/${seg(schemaId)}/series-bindings/${seg(bindingId)}`
+    );
   }
   async createOntologySchema(req) {
     return this.post("/v1/ontology/schemas", req);
   }
   async updateOntologySchema(id, req) {
-    return this.patch(`/v1/ontology/schemas/${id}`, req);
+    return this.patch(`/v1/ontology/schemas/${seg(id)}`, req);
   }
   async activateOntologySchema(id) {
-    return this.post(`/v1/ontology/schemas/${id}/activate`, {});
+    return this.post(`/v1/ontology/schemas/${seg(id)}/activate`, {});
   }
   async deprecateOntologySchema(id) {
-    return this.post(`/v1/ontology/schemas/${id}/deprecate`, {});
+    return this.post(`/v1/ontology/schemas/${seg(id)}/deprecate`, {});
   }
   async archiveOntologySchema(id) {
-    return this.del(`/v1/ontology/schemas/${id}`);
+    return this.del(`/v1/ontology/schemas/${seg(id)}`);
   }
   /**
    * Kick off an LLM-driven schema proposal job.
@@ -697,47 +764,47 @@ var MindGraph = class {
     return this.post("/v1/ontology/propose-schema", req);
   }
   async testOntologySchema(id, opts) {
-    return this.post(`/v1/ontology/schemas/${id}/test`, opts ?? {});
+    return this.post(`/v1/ontology/schemas/${seg(id)}/test`, opts ?? {});
   }
   // ---- Schema sub-resources ----
   async addOntologyObjectType(schemaId, req) {
-    return this.post(`/v1/ontology/schemas/${schemaId}/object-types`, req);
+    return this.post(`/v1/ontology/schemas/${seg(schemaId)}/object-types`, req);
   }
   async updateOntologyObjectType(schemaId, typeId, req) {
     return this.patch(
-      `/v1/ontology/schemas/${schemaId}/object-types/${typeId}`,
+      `/v1/ontology/schemas/${seg(schemaId)}/object-types/${seg(typeId)}`,
       req
     );
   }
   async deleteOntologyObjectType(schemaId, typeId) {
     return this.del(
-      `/v1/ontology/schemas/${schemaId}/object-types/${typeId}`
+      `/v1/ontology/schemas/${seg(schemaId)}/object-types/${seg(typeId)}`
     );
   }
   async addOntologyRelationType(schemaId, req) {
-    return this.post(`/v1/ontology/schemas/${schemaId}/relation-types`, req);
+    return this.post(`/v1/ontology/schemas/${seg(schemaId)}/relation-types`, req);
   }
   async updateOntologyRelationType(schemaId, typeId, req) {
     return this.patch(
-      `/v1/ontology/schemas/${schemaId}/relation-types/${typeId}`,
+      `/v1/ontology/schemas/${seg(schemaId)}/relation-types/${seg(typeId)}`,
       req
     );
   }
   async deleteOntologyRelationType(schemaId, typeId) {
     return this.del(
-      `/v1/ontology/schemas/${schemaId}/relation-types/${typeId}`
+      `/v1/ontology/schemas/${seg(schemaId)}/relation-types/${seg(typeId)}`
     );
   }
   /** Generate inert semantic classifications for individual human review. */
   async analyzeOntologySemanticGuidance(schemaId) {
     return this.post(
-      `/v1/ontology/schemas/${schemaId}/semantic-guidance/analyze`,
+      `/v1/ontology/schemas/${seg(schemaId)}/semantic-guidance/analyze`,
       {}
     );
   }
   /** Read-only exact-identity collision audit; never merges graph data. */
   async auditOntologyDuplicates(schemaId) {
-    return this.post(`/v1/ontology/schemas/${schemaId}/duplicates/audit`, {});
+    return this.post(`/v1/ontology/schemas/${seg(schemaId)}/duplicates/audit`, {});
   }
   // ---- Proposals ----
   async listOntologyProposals(opts) {
@@ -753,19 +820,19 @@ var MindGraph = class {
     return this.get(`/v1/ontology/proposals${qs ? `?${qs}` : ""}`);
   }
   async getOntologyProposal(id) {
-    return this.get(`/v1/ontology/proposals/${id}`);
+    return this.get(`/v1/ontology/proposals/${seg(id)}`);
   }
   async patchOntologyProposal(id, req) {
-    return this.patch(`/v1/ontology/proposals/${id}`, req);
+    return this.patch(`/v1/ontology/proposals/${seg(id)}`, req);
   }
   async approveOntologyProposal(id, opts) {
-    return this.post(`/v1/ontology/proposals/${id}/approve`, opts ?? {});
+    return this.post(`/v1/ontology/proposals/${seg(id)}/approve`, opts ?? {});
   }
   async rejectOntologyProposal(id, reason) {
-    return this.post(`/v1/ontology/proposals/${id}/reject`, { reason });
+    return this.post(`/v1/ontology/proposals/${seg(id)}/reject`, { reason });
   }
   async applyOntologyProposal(id) {
-    return this.post(`/v1/ontology/proposals/${id}/apply`, {});
+    return this.post(`/v1/ontology/proposals/${seg(id)}/apply`, {});
   }
   async batchApproveOntologyProposals(ids, feedback) {
     return this.post("/v1/ontology/proposals/batch-approve", { ids, feedback });
@@ -814,7 +881,7 @@ var MindGraph = class {
       if (binding.project_uid) query.set("project_uid", binding.project_uid);
     }
     const suffix = query.size > 0 ? `?${query.toString()}` : "";
-    return this.get(`/ontology/object/${uid}${suffix}`);
+    return this.get(`/ontology/object/${seg(uid)}${suffix}`);
   }
   async getDomainObjectContext(uid, depth, binding) {
     const query = new URLSearchParams();
@@ -825,10 +892,10 @@ var MindGraph = class {
       if (binding.project_uid) query.set("project_uid", binding.project_uid);
     }
     const suffix = query.size > 0 ? `?${query.toString()}` : "";
-    return this.get(`/ontology/object/${uid}/context${suffix}`);
+    return this.get(`/ontology/object/${seg(uid)}/context${suffix}`);
   }
   async getDomainObjectHistory(uid) {
-    return this.get(`/ontology/object/${uid}/history`);
+    return this.get(`/ontology/object/${seg(uid)}/history`);
   }
   async listDomainObjects(opts) {
     const q = new URLSearchParams();

package/package.json

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