feat: support multiple extra LangSmith trace projects in SDK

libs/sdk-py/langgraph_sdk/schema.py

@@ -1,3 +1,3 @@
 """Data models for interacting with the LangGraph API."""
 
 from __future__ import annotations
@@ -112,7 +112,13 @@
     """Configuration for LangSmith tracing."""
 
     project_name: str
-    """The LangSmith project name to trace to."""
+    """A single extra LangSmith project name to trace to."""
+    project_names: list[str]
+    """Multiple extra LangSmith project names to trace to.
+
+    Combined with `project_name` (if both are provided) to form the full set of
+    extra projects. The server also traces to its primary tracing project.
+    """
     example_id: str
     """The LangSmith example/dataset ID to associate with the trace."""
 

libs/sdk-py/tests/test_langsmith_tracing.py

@@ -144,3 +144,57 @@ def mock_post(_path, *, json=None, **_kwargs):
         assert captured["json"]["langsmith_tracer"] == {
             "project_name": "my-project",
         }
+
+    def test_langsmith_tracing_project_names_only(self):
+        """Test that langsmith_tracing works with multiple project_names."""
+        from langgraph_sdk._sync.runs import SyncRunsClient
+
+        captured: dict[str, Any] = {}
+
+        def mock_post(_path, *, json=None, **_kwargs):
+            captured["json"] = json
+            return {"run_id": "r1", "status": "pending"}
+
+        http = MagicMock()
+        http.post = MagicMock(side_effect=mock_post)
+        client = SyncRunsClient(http)
+
+        client.create(
+            thread_id="t1",
+            assistant_id="a1",
+            langsmith_tracing={"project_names": ["first", "second"]},
+        )
+
+        assert captured["json"]["langsmith_tracer"] == {
+            "project_names": ["first", "second"],
+        }
+
+    def test_langsmith_tracing_project_name_and_project_names(self):
+        """Test that langsmith_tracing passes both project_name and project_names."""
+        from langgraph_sdk._sync.runs import SyncRunsClient
+
+        captured: dict[str, Any] = {}
+
+        def mock_post(_path, *, json=None, **_kwargs):
+            captured["json"] = json
+            return {"run_id": "r1", "status": "pending"}
+
+        http = MagicMock()
+        http.post = MagicMock(side_effect=mock_post)
+        client = SyncRunsClient(http)
+
+        client.create(
+            thread_id="t1",
+            assistant_id="a1",
+            langsmith_tracing={
+                "project_name": "first",
+                "project_names": ["second", "third"],
+                "example_id": "example-123",
+            },
+        )
+
+        assert captured["json"]["langsmith_tracer"] == {
+            "project_name": "first",
+            "project_names": ["second", "third"],
+            "example_id": "example-123",
+        }