mindgraph-sdk 0.3.0__tar.gz → 0.4.0__tar.gz

{mindgraph_sdk-0.3.0 → mindgraph_sdk-0.4.0}/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.4.0 (2026-04-16)
+
+### Synthesis (Projects)
+
+Scoped-corpus synthesis: mine cross-document signals for a `Project` and turn top idea clusters into Article nodes via a background job.
+
+- `signals(project_uid, *, signals=None, target_types=None)` — `GET /synthesis/signals/{project_uid}`. Returns entity bridges, claim hubs, ranked/clustered claim hubs, theory support gaps, concept clusters, analogy candidates, and dialectical pairs.
+- `run_synthesis(project_uid)` — `POST /synthesis/run/{project_uid}`. Spawns a background synthesis job and returns `{"job_id": ...}`; poll with `get_job()`.
+
 ## 0.2.0 (2026-03-30)
 
 ### New Entity Types

{mindgraph_sdk-0.3.0 → mindgraph_sdk-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mindgraph-sdk
-Version: 0.3.0
+Version: 0.4.0
 Summary: Python client for the MindGraph Cloud API
 License-Expression: MIT
 Keywords: agent,ai,cognitive,knowledge-graph,mindgraph
@@ -125,6 +125,23 @@ entity = graph.find_or_create_entity("Some Entity")
 | `governance(**kwargs)` | Create policies, set safety budgets, request/resolve approvals |
 | `execution(**kwargs)` | Track execution lifecycle and register agents |
 
+### Synthesis (Projects)
+
+Scope a corpus to a `Project` (via `commit(action="project", ...)` then link documents with `PartOfProject`), then mine cross-document signals and generate synthesis articles.
+
+| Method | Description |
+|--------|-------------|
+| `signals(project_uid, *, signals?, target_types?)` | Mine cross-document structural signals for a project |
+| `run_synthesis(project_uid)` | Spawn async synthesis job that turns top clusters into Article nodes; returns `{"job_id": ...}` |
+
+```python
+project = graph.commit(action="project", label="Q2 China strategy")
+# ...link documents to the project via PartOfProject edges...
+signals = graph.signals(project["uid"], signals="clustered_claim_hubs,dialectical_pairs")
+job = graph.run_synthesis(project["uid"])
+status = graph.get_job(job["job_id"])
+```
+
 ### CRUD
 
 | Method | Description |

{mindgraph_sdk-0.3.0 → mindgraph_sdk-0.4.0}/README.md

@@ -111,6 +111,23 @@ entity = graph.find_or_create_entity("Some Entity")
 | `governance(**kwargs)` | Create policies, set safety budgets, request/resolve approvals |
 | `execution(**kwargs)` | Track execution lifecycle and register agents |
 
+### Synthesis (Projects)
+
+Scope a corpus to a `Project` (via `commit(action="project", ...)` then link documents with `PartOfProject`), then mine cross-document signals and generate synthesis articles.
+
+| Method | Description |
+|--------|-------------|
+| `signals(project_uid, *, signals?, target_types?)` | Mine cross-document structural signals for a project |
+| `run_synthesis(project_uid)` | Spawn async synthesis job that turns top clusters into Article nodes; returns `{"job_id": ...}` |
+
+```python
+project = graph.commit(action="project", label="Q2 China strategy")
+# ...link documents to the project via PartOfProject edges...
+signals = graph.signals(project["uid"], signals="clustered_claim_hubs,dialectical_pairs")
+job = graph.run_synthesis(project["uid"])
+status = graph.get_job(job["job_id"])
+```
+
 ### CRUD
 
 | Method | Description |

{mindgraph_sdk-0.3.0 → mindgraph_sdk-0.4.0}/mindgraph/client.py

@@ -24,6 +24,7 @@ class MindGraph:
         *,
         api_key: str | None = None,
         jwt: str | None = None,
+        org_id: str | None = None,
         timeout: float = 30.0,
         max_retries: int = 3,
         retry_backoff: float = 1.0,
@@ -36,6 +37,8 @@ class MindGraph:
             headers["Authorization"] = f"Bearer {api_key}"
         elif jwt:
             headers["Authorization"] = f"Bearer {jwt}"
+        if org_id:
+            headers["X-MindGraph-Org"] = org_id
         self._client = httpx.Client(
             base_url=self.base_url, headers=headers, timeout=timeout
         )
@@ -1065,3 +1068,46 @@ class MindGraph:
         """Backfill: compile articles for all documents and eligible entities."""
         return self._request("POST", "/wiki/compile/all")
 
+    # ---- Synthesis (Projects) ----
+
+    def signals(
+        self,
+        project_uid: str,
+        *,
+        signals: str | None = None,
+        target_types: str | None = None,
+    ) -> dict[str, Any]:
+        """Mine cross-document structural signals for a project's corpus.
+
+        Returns entity bridges, claim hubs, ranked/clustered claim hubs,
+        theory support gaps, concept clusters, analogy candidates, and
+        dialectical pairs. Blocking; no LLM calls.
+
+        Args:
+            project_uid: UID of the Project node.
+            signals: Comma-separated subset of signal names to compute
+                (e.g. ``"clustered_claim_hubs,dialectical_pairs"``). If
+                omitted, all signals run.
+            target_types: Comma-separated node types filter for
+                ``entity_bridges`` and ``claim_hubs``.
+        """
+        params: dict[str, str] = {}
+        if signals is not None:
+            params["signals"] = signals
+        if target_types is not None:
+            params["target_types"] = target_types
+        qs = "&".join(f"{k}={v}" for k, v in params.items())
+        path = f"/synthesis/signals/{project_uid}"
+        if qs:
+            path = f"{path}?{qs}"
+        return self._request("GET", path)
+
+    def run_synthesis(self, project_uid: str) -> dict[str, Any]:
+        """Spawn a background synthesis job for a project.
+
+        Mines signals, selects top idea clusters, runs LLM synthesis,
+        and persists candidate Article nodes linked via ``Covers`` edges.
+
+        Returns ``{"job_id": str}``; poll with :meth:`get_job`.
+        """
+        return self._request("POST", f"/synthesis/run/{project_uid}")

{mindgraph_sdk-0.3.0 → mindgraph_sdk-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "mindgraph-sdk"
-version = "0.3.0"
+version = "0.4.0"
 description = "Python client for the MindGraph Cloud API"
 readme = "README.md"
 license = "MIT"