[pull] main from microsoft:main

.semversioner/3.1.0.json

@@ -0,0 +1,14 @@
+{
+  "changes": [
+    {
+      "description": "Native CosmosTableProvider with namespace partitioning, transactional batch writes, and simplified AzureCosmosStorage.",
+      "type": "minor"
+    },
+    {
+      "description": "Update litellm dependency.",
+      "type": "patch"
+    }
+  ],
+  "created_at": "2026-05-28T15:17:20+00:00",
+  "version": "3.1.0"
+}

CHANGELOG.md

@@ -1,6 +1,11 @@
 # Changelog
 Note: version releases in the 0.x.y range may introduce breaking changes.
 
+## 3.1.0
+
+- minor: Native CosmosTableProvider with namespace partitioning, transactional batch writes, and simplified AzureCosmosStorage.
+- patch: Update litellm dependency.
+
 ## 3.0.9
 
 - patch: Support client side json validation.

docs/get_started.md

@@ -21,6 +21,7 @@ mkdir graphrag_quickstart
 cd graphrag_quickstart
 python -m venv .venv
 ```
+
 ### Activate Python Virtual Environment - Unix/MacOS
 
 ```bash
@@ -78,17 +79,17 @@ In addition to setting your API key, Azure OpenAI users should set the variables
 type: chat
 model_provider: azure
 model: gpt-4.1
-deployment_name: <AZURE_DEPLOYMENT_NAME>
+azure_deployment_name: <AZURE_DEPLOYMENT_NAME>
 api_base: https://<instance>.openai.azure.com
 api_version: 2024-02-15-preview # You can customize this for other versions
 ```
 
 #### Using Managed Auth on Azure
 
-To use managed auth, edit the auth_type in your model config and *remove* the api_key line:
+To use managed auth, edit the auth_method in your model config and remove the api_key line:
 
 ```yaml
-auth_type: azure_managed_identity # Default auth_type is is api_key
+auth_method: azure_managed_identity # Default auth_method is is api_key
 ```
 
 You will also need to login with [az login](https://learn.microsoft.com/en-us/cli/azure/authenticate-azure-cli) and select the subscription with your endpoint.

packages/graphrag-cache/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "graphrag-cache"
-version = "3.0.9"
+version = "3.1.0"
 description = "GraphRAG cache package."
 authors = [
     {name = "Alonso Guevara Fernández", email = "alonsog@microsoft.com"},
@@ -31,8 +31,8 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "graphrag-common==3.0.9",
-    "graphrag-storage==3.0.9",
+    "graphrag-common==3.1.0",
+    "graphrag-storage==3.1.0",
 ]
 
 [project.urls]

packages/graphrag-chunking/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "graphrag-chunking"
-version = "3.0.9"
+version = "3.1.0"
 description = "Chunking utilities for GraphRAG"
 authors = [
     {name = "Alonso Guevara Fernández", email = "alonsog@microsoft.com"},
@@ -30,7 +30,7 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "graphrag-common==3.0.9",
+    "graphrag-common==3.1.0",
     "pydantic~=2.10",
 ]
 

packages/graphrag-common/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "graphrag-common"
-version = "3.0.9"
+version = "3.1.0"
 description = "Common utilities and types for GraphRAG"
 authors = [
     {name = "Alonso Guevara Fernández", email = "alonsog@microsoft.com"},

packages/graphrag-input/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "graphrag-input"
-version = "3.0.9"
+version = "3.1.0"
 description = "Input document loading utilities for GraphRAG"
 authors = [
     {name = "Alonso Guevara Fernández", email = "alonsog@microsoft.com"},
@@ -30,8 +30,8 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "graphrag-common==3.0.9",
-    "graphrag-storage==3.0.9    ",
+    "graphrag-common==3.1.0",
+    "graphrag-storage==3.1.0    ",
     "pydantic~=2.10",
     "markitdown~=0.1.0",
     "markitdown[pdf]",

packages/graphrag-llm/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "graphrag-llm"
-version = "3.0.9"
+version = "3.1.0"
 description = "GraphRAG LLM package."
 authors = [
     {name = "Alonso Guevara Fernández", email = "alonsog@microsoft.com"},
@@ -33,10 +33,10 @@ classifiers = [
 ]
 dependencies = [
     "azure-identity~=1.25",
-    "graphrag-cache==3.0.9",
-    "graphrag-common==3.0.9",
+    "graphrag-cache==3.1.0",
+    "graphrag-common==3.1.0",
     "jinja2~=3.1",
-    "litellm==1.82.6",
+    "litellm==1.86.2",
     "nest-asyncio2~=1.7",
     "pydantic~=2.10",
     "typing-extensions~=4.12"

packages/graphrag-storage/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "graphrag-storage"
-version = "3.0.9"
+version = "3.1.0"
 description = "GraphRAG storage package."
 authors = [
     {name = "Alonso Guevara Fernández", email = "alonsog@microsoft.com"},
@@ -34,7 +34,7 @@ dependencies = [
     "azure-cosmos~=4.9",
     "azure-identity~=1.25",
     "azure-storage-blob~=12.24",
-    "graphrag-common==3.0.9",
+    "graphrag-common==3.1.0",
     "pandas~=2.3",
     "pydantic~=2.10",
 ]

packages/graphrag-vectors/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "graphrag-vectors"
-version = "3.0.9"
+version = "3.1.0"
 description = "GraphRAG vector store package."
 authors = [
     {name = "Alonso Guevara Fernández", email = "alonsog@microsoft.com"},
@@ -34,7 +34,7 @@ dependencies = [
     "azure-cosmos~=4.9",
     "azure-identity~=1.25",
     "azure-search-documents~=11.6",
-    "graphrag-common==3.0.9",
+    "graphrag-common==3.1.0",
     "lancedb~=0.24.1",
     "numpy~=2.1",
     "pyarrow~=22.0",

packages/graphrag/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "graphrag"
 # Maintainers: do not change the version here manually
-version = "3.0.9"
+version = "3.1.0"
 description = "GraphRAG: A graph-based retrieval-augmented generation (RAG) system."
 authors = [
     {name = "Alonso Guevara Fernández", email = "alonsog@microsoft.com"},
@@ -36,13 +36,13 @@ dependencies = [
     "azure-search-documents~=11.5",
     "azure-storage-blob~=12.24",
     "devtools~=0.12",
-    "graphrag-cache==3.0.9",
-    "graphrag-chunking==3.0.9",
-    "graphrag-common==3.0.9",
-    "graphrag-input==3.0.9",
-    "graphrag-llm==3.0.9",
-    "graphrag-storage==3.0.9",
-    "graphrag-vectors==3.0.9",
+    "graphrag-cache==3.1.0",
+    "graphrag-chunking==3.1.0",
+    "graphrag-common==3.1.0",
+    "graphrag-input==3.1.0",
+    "graphrag-llm==3.1.0",
+    "graphrag-storage==3.1.0",
+    "graphrag-vectors==3.1.0",
     "graspologic-native~=1.2",
     "json-repair~=0.30",
     "networkx~=3.4",