mindgraph 0.11.0 → 0.13.0

package/dist/index.js

@@ -46,15 +46,21 @@ var MindGraph = class {
     if (config.orgId) {
       this.headers["X-MindGraph-Org"] = config.orgId;
     }
+    this.telemetrySurface = config.telemetrySurface;
     this.maxRetries = config.maxRetries ?? 3;
     this.retryBackoffMs = config.retryBackoffMs ?? 1e3;
   }
   // ---- HTTP helpers ----
   async request(method, path, body) {
     const url = `${this.baseUrl}${path}`;
+    const requestId = createRequestId();
     const init = {
       method,
-      headers: this.headers
+      headers: {
+        ...this.headers,
+        "X-MindGraph-Request-ID": requestId,
+        ...this.telemetrySurface ? { "X-MindGraph-Surface": this.telemetrySurface } : {}
+      }
     };
     if (body !== void 0) {
       init.body = JSON.stringify(body);
@@ -564,6 +570,10 @@ var MindGraph = class {
   async getMergeCandidates() {
     return this.post("/retrieve", { action: "merge_candidates" });
   }
+  /** Load-bearing conclusions awaiting repair after a premise changed. */
+  async getStaleDerivations(limit = 50, offset = 0) {
+    return this.post("/retrieve", { action: "stale_derivations", limit, offset });
+  }
   async getPendingApprovals() {
     return this.get("/approvals/pending");
   }
@@ -745,12 +755,25 @@ var MindGraph = class {
       `/v1/ontology/schemas/${schemaId}/relation-types/${typeId}`
     );
   }
+  /** Generate inert semantic classifications for individual human review. */
+  async analyzeOntologySemanticGuidance(schemaId) {
+    return this.post(
+      `/v1/ontology/schemas/${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`, {});
+  }
   // ---- Proposals ----
   async listOntologyProposals(opts) {
     const q = new URLSearchParams();
     if (opts?.status) q.set("status", opts.status);
     if (opts?.schema_id) q.set("schema_id", opts.schema_id);
     if (opts?.object_type) q.set("object_type", opts.object_type);
+    if (opts?.proposal_type) q.set("proposal_type", opts.proposal_type);
+    if (opts?.extract_job_id) q.set("extract_job_id", opts.extract_job_id);
     if (opts?.limit != null) q.set("limit", String(opts.limit));
     if (opts?.offset != null) q.set("offset", String(opts.offset));
     const qs = q.toString();
@@ -781,21 +804,55 @@ var MindGraph = class {
   async queryOntology(req) {
     return this.post("/ontology/query", req);
   }
+  async queryDomainStructured(req) {
+    return this.post("/ontology/query/structured", req);
+  }
+  async queryRelatedDomainObjects(req) {
+    return this.queryDomainStructured({
+      schema_id: req.schema_id,
+      select: req.far_type,
+      ...req.project_uid ? { project_uid: req.project_uid } : {},
+      anchor: { type: req.entry_type, uid: req.uid },
+      path: [{
+        relation: req.relation,
+        entry_role: req.entry_role
+      }],
+      ...req.where ? { where: req.where } : {},
+      ...req.include_provenance ? { include: { provenance: true } } : {},
+      page: {
+        ...req.limit != null ? { limit: req.limit } : {},
+        ...req.offset != null ? { offset: req.offset } : {}
+      }
+    });
+  }
   /**
-   * Read-only agent tool descriptors generated from the active ontology
-   * schema(s). Each maps to a generic `/ontology` read endpoint with
-   * `object_type` bound. Used by the MCP server to expose typed per-object
-   * tools (`search_customers`, `summarize_customer`, …).
+   * Schema-qualified read-tool descriptors generated from every active
+   * ontology. Includes per-object discovery/point/context tools,
+   * relation-and-role-specific related tools, and one structured composite.
    */
   async listOntologyTools() {
     return this.get("/v1/ontology/tools");
   }
-  async getDomainObject(uid) {
-    return this.get(`/ontology/object/${uid}`);
-  }
-  async getDomainObjectContext(uid, depth) {
-    const qs = depth != null ? `?depth=${depth}` : "";
-    return this.get(`/ontology/object/${uid}/context${qs}`);
+  async getDomainObject(uid, binding) {
+    const query = new URLSearchParams();
+    if (binding) {
+      query.set("schema_id", binding.schema_id);
+      query.set("object_type", binding.object_type);
+      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}`);
+  }
+  async getDomainObjectContext(uid, depth, binding) {
+    const query = new URLSearchParams();
+    if (depth != null) query.set("depth", String(depth));
+    if (binding) {
+      query.set("schema_id", binding.schema_id);
+      query.set("object_type", binding.object_type);
+      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}`);
   }
   async getDomainObjectHistory(uid) {
     return this.get(`/ontology/object/${uid}/history`);
@@ -838,6 +895,12 @@ var MindGraph = class {
     return this.post("/ontology/extract", req);
   }
 };
+function createRequestId() {
+  if (typeof globalThis.crypto?.randomUUID === "function") {
+    return globalThis.crypto.randomUUID();
+  }
+  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   MindGraph,

package/dist/index.mjs

@@ -19,15 +19,21 @@ var MindGraph = class {
     if (config.orgId) {
       this.headers["X-MindGraph-Org"] = config.orgId;
     }
+    this.telemetrySurface = config.telemetrySurface;
     this.maxRetries = config.maxRetries ?? 3;
     this.retryBackoffMs = config.retryBackoffMs ?? 1e3;
   }
   // ---- HTTP helpers ----
   async request(method, path, body) {
     const url = `${this.baseUrl}${path}`;
+    const requestId = createRequestId();
     const init = {
       method,
-      headers: this.headers
+      headers: {
+        ...this.headers,
+        "X-MindGraph-Request-ID": requestId,
+        ...this.telemetrySurface ? { "X-MindGraph-Surface": this.telemetrySurface } : {}
+      }
     };
     if (body !== void 0) {
       init.body = JSON.stringify(body);
@@ -537,6 +543,10 @@ var MindGraph = class {
   async getMergeCandidates() {
     return this.post("/retrieve", { action: "merge_candidates" });
   }
+  /** Load-bearing conclusions awaiting repair after a premise changed. */
+  async getStaleDerivations(limit = 50, offset = 0) {
+    return this.post("/retrieve", { action: "stale_derivations", limit, offset });
+  }
   async getPendingApprovals() {
     return this.get("/approvals/pending");
   }
@@ -718,12 +728,25 @@ var MindGraph = class {
       `/v1/ontology/schemas/${schemaId}/relation-types/${typeId}`
     );
   }
+  /** Generate inert semantic classifications for individual human review. */
+  async analyzeOntologySemanticGuidance(schemaId) {
+    return this.post(
+      `/v1/ontology/schemas/${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`, {});
+  }
   // ---- Proposals ----
   async listOntologyProposals(opts) {
     const q = new URLSearchParams();
     if (opts?.status) q.set("status", opts.status);
     if (opts?.schema_id) q.set("schema_id", opts.schema_id);
     if (opts?.object_type) q.set("object_type", opts.object_type);
+    if (opts?.proposal_type) q.set("proposal_type", opts.proposal_type);
+    if (opts?.extract_job_id) q.set("extract_job_id", opts.extract_job_id);
     if (opts?.limit != null) q.set("limit", String(opts.limit));
     if (opts?.offset != null) q.set("offset", String(opts.offset));
     const qs = q.toString();
@@ -754,21 +777,55 @@ var MindGraph = class {
   async queryOntology(req) {
     return this.post("/ontology/query", req);
   }
+  async queryDomainStructured(req) {
+    return this.post("/ontology/query/structured", req);
+  }
+  async queryRelatedDomainObjects(req) {
+    return this.queryDomainStructured({
+      schema_id: req.schema_id,
+      select: req.far_type,
+      ...req.project_uid ? { project_uid: req.project_uid } : {},
+      anchor: { type: req.entry_type, uid: req.uid },
+      path: [{
+        relation: req.relation,
+        entry_role: req.entry_role
+      }],
+      ...req.where ? { where: req.where } : {},
+      ...req.include_provenance ? { include: { provenance: true } } : {},
+      page: {
+        ...req.limit != null ? { limit: req.limit } : {},
+        ...req.offset != null ? { offset: req.offset } : {}
+      }
+    });
+  }
   /**
-   * Read-only agent tool descriptors generated from the active ontology
-   * schema(s). Each maps to a generic `/ontology` read endpoint with
-   * `object_type` bound. Used by the MCP server to expose typed per-object
-   * tools (`search_customers`, `summarize_customer`, …).
+   * Schema-qualified read-tool descriptors generated from every active
+   * ontology. Includes per-object discovery/point/context tools,
+   * relation-and-role-specific related tools, and one structured composite.
    */
   async listOntologyTools() {
     return this.get("/v1/ontology/tools");
   }
-  async getDomainObject(uid) {
-    return this.get(`/ontology/object/${uid}`);
-  }
-  async getDomainObjectContext(uid, depth) {
-    const qs = depth != null ? `?depth=${depth}` : "";
-    return this.get(`/ontology/object/${uid}/context${qs}`);
+  async getDomainObject(uid, binding) {
+    const query = new URLSearchParams();
+    if (binding) {
+      query.set("schema_id", binding.schema_id);
+      query.set("object_type", binding.object_type);
+      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}`);
+  }
+  async getDomainObjectContext(uid, depth, binding) {
+    const query = new URLSearchParams();
+    if (depth != null) query.set("depth", String(depth));
+    if (binding) {
+      query.set("schema_id", binding.schema_id);
+      query.set("object_type", binding.object_type);
+      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}`);
   }
   async getDomainObjectHistory(uid) {
     return this.get(`/ontology/object/${uid}/history`);
@@ -811,6 +868,12 @@ var MindGraph = class {
     return this.post("/ontology/extract", req);
   }
 };
+function createRequestId() {
+  if (typeof globalThis.crypto?.randomUUID === "function") {
+    return globalThis.crypto.randomUUID();
+  }
+  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+}
 export {
   MindGraph,
   MindGraphError

package/package.json

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