copilotkit 0.1.86__tar.gz → 0.1.87__tar.gz

{copilotkit-0.1.86 → copilotkit-0.1.87}/PKG-INFO

@@ -1,8 +1,7 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: copilotkit
-Version: 0.1.86
+Version: 0.1.87
 Summary: CopilotKit python SDK
-Home-page: https://copilotkit.ai
 License: MIT
 Keywords: copilot,copilotkit,langgraph,langchain,ai,langsmith,langserve
 Author: Markus Ecker
@@ -22,6 +21,7 @@ Requires-Dist: langchain (>=0.3.0)
 Requires-Dist: langgraph (>=0.3.25,<2)
 Requires-Dist: partialjson (>=0.0.8,<0.0.9)
 Requires-Dist: toml (>=0.10.2,<0.11.0)
+Project-URL: Homepage, https://copilotkit.ai
 Project-URL: Repository, https://github.com/CopilotKit/CopilotKit/tree/main/sdk-python
 Description-Content-Type: text/markdown
 

{copilotkit-0.1.86 → copilotkit-0.1.87}/copilotkit/a2ui.py

@@ -18,6 +18,7 @@ Usage:
 from __future__ import annotations
 
 import json
+from pathlib import Path
 from typing import Any
 
 
@@ -132,45 +133,38 @@ The List's own path ("/items") uses a leading slash (absolute), but all
 components INSIDE the template card use paths WITHOUT leading slash.
 Do NOT use "/items/0/name" or "/items/{@key}/name" — just "name".
 
-DATA MODEL:
-The "data" key in the tool args is a plain JSON object that initializes the surface
-data model. Components bound to paths (e.g. "value": { "path": "/form/name" })
-read from and write to this data model. Examples:
-  For forms:  "data": { "form": { "name": "Alice", "email": "" } }
-  For lists:  "data": { "items": [{"name": "Product A"}, {"name": "Product B"}] }
-  For mixed:  "data": { "form": { "query": "" }, "results": [...] }
-
-FORMS AND TWO-WAY DATA BINDING:
-To create editable forms, bind input components to data model paths using { "path": "..." }.
-The client automatically writes user input back to the data model at the bound path.
-CRITICAL: Using a literal value (e.g. "value": "") makes the field READ-ONLY.
-You MUST use { "path": "..." } to make inputs editable.
-
-All input components use "value" as the binding property:
-- TextField:     "value": { "path": "/form/fieldName" }
-- CheckBox:      "value": { "path": "/form/isChecked" }
-- Slider:        "value": { "path": "/form/sliderVal" }
-- DateTimeInput: "value": { "path": "/form/date" }
-- ChoicePicker:  "value": { "path": "/form/choices" }
-
-To retrieve form values when a button is clicked, include "context" with path references
-in the button's action. Paths are resolved to their current values at click time:
-  "action": { "event": { "name": "submit", "context": { "userName": { "path": "/form/name" } } } }
-
-To pre-fill form values, pass initial data via the "data" tool argument:
-  "data": { "form": { "name": "Markus" } }
-
-FORM EXAMPLE (editable text field with pre-filled value + submit button):
-  "components": [
-    { "id": "root", "component": "Card", "child": "form-col" },
-    { "id": "form-col", "component": "Column", "children": ["name-field", "submit-row"] },
-    { "id": "name-field", "component": "TextField", "label": "Name", "value": { "path": "/form/name" } },
-    { "id": "submit-row", "component": "Row", "justify": "end", "children": ["submit-btn"] },
-    { "id": "submit-btn", "component": "Button", "child": "btn-text", "variant": "primary",
-      "action": { "event": { "name": "submit", "context": { "userName": { "path": "/form/name" } } } } },
-    { "id": "btn-text", "component": "Text", "text": "Submit" }
-  ],
-  "data": { "form": { "name": "Markus" } }"""
+COMPONENT VALUES — DEFAULT RULE:
+Use inline literal values for ALL component properties. Pass strings, numbers,
+arrays, and objects directly on the component. Do NOT use { "path": "..." }
+objects unless the property's schema explicitly allows it (see exception below).
+CRITICAL: USING { "path": "..." } ON A PROPERTY THAT DOES NOT DECLARE PATH
+SUPPORT IN ITS SCHEMA WILL CAUSE A RUNTIME CRASH AND BREAK THE ENTIRE UI.
+ALWAYS CHECK THE COMPONENT SCHEMA FIRST — IF THE PROPERTY ONLY ACCEPTS A
+PLAIN TYPE, YOU MUST USE A LITERAL VALUE.
+VERY IMPORTANT: THE APPLICATION WILL BREAK IF YOU DO NOT FOLLOW THIS RULE!
+
+For example, a chart's "data" must always be an inline array:
+  "data": [{"label": "Jan", "value": 100}, {"label": "Feb", "value": 200}]
+A metric's "value" must always be an inline string:
+  "value": "$1,200"
+
+PATH BINDING EXCEPTION — SCHEMA-DRIVEN:
+A few properties accept { "path": "/some/path" } as an alternative to a literal
+value. You can identify these in the Available Components schema: the property
+will list BOTH a literal type AND an object-with-path option. If a property only
+shows a single type (string, number, array, etc.), it does NOT support path
+binding — use a literal value only.
+
+Path binding is typically used for editable form inputs so the client can write
+user input back to the data model. When building forms:
+- Bind input "value" to a data model path: "value": { "path": "/form/name" }
+- Pre-fill via the "data" tool argument: "data": { "form": { "name": "Alice" } }
+- Capture values on submit via button action context:
+    "action": { "event": { "name": "submit", "context": { "name": { "path": "/form/name" } } } }
+
+REPEATING CONTENT uses a structural children format (not the same as value binding):
+  children: { componentId: "card-id", path: "/items" }
+Components inside templates use RELATIVE paths (no leading slash): { "path": "name" }."""
 
 DEFAULT_DESIGN_GUIDELINES = """\
 Create polished, visually appealing interfaces:
@@ -241,6 +235,3 @@ Use ONLY these components with the specified props.
 
 {component_schema}
 """
-
-
-    return None

{copilotkit-0.1.86 → copilotkit-0.1.87}/copilotkit/langgraph.py

@@ -142,9 +142,19 @@ def langchain_messages_to_copilotkit(
         if hasattr(message, "content"):
             content = message.content
 
-            # Check if content is a list and use the first element
+            # Content can be a list of content blocks (e.g. Anthropic models).
+            # Extract and concatenate all text parts instead of only taking
+            # the first element.
             if isinstance(content, list):
-                content = content[0] if content else ""
+                text_parts = []
+                for part in content:
+                    if isinstance(part, str):
+                        text_parts.append(part)
+                    elif isinstance(part, dict) and part.get("type") == "text":
+                        text_parts.append(part.get("text", ""))
+                    elif isinstance(part, dict) and "text" in part:
+                        text_parts.append(part.get("text", ""))
+                content = "".join(text_parts)
 
             # Anthropic models return a dict with a "text" key
             if isinstance(content, dict):

{copilotkit-0.1.86 → copilotkit-0.1.87}/copilotkit/langgraph_agent.py

@@ -2,6 +2,7 @@
 
 import uuid
 import json
+import math
 from typing import Optional, List, Callable, Any, cast, Union, TypedDict, Literal
 
 from langgraph.graph.state import CompiledStateGraph
@@ -18,6 +19,22 @@ except ImportError:
     from langchain_core.messages import BaseMessage, SystemMessage
     
 from langchain_core.runnables import RunnableConfig, ensure_config
+
+def _serialize_state(state):
+    """Recursively convert Pydantic BaseModel instances to dicts for serialization."""
+    try:
+        from pydantic import BaseModel as PydanticBaseModel
+    except ImportError:
+        return state
+
+    if isinstance(state, PydanticBaseModel):
+        return state.model_dump()
+    elif isinstance(state, dict):
+        return {k: _serialize_state(v) for k, v in state.items()}
+    elif isinstance(state, (list, tuple)):
+        return type(state)(_serialize_state(item) for item in state)
+    return state
+
 from langchain_core.messages import HumanMessage
 
 from partialjson.json_parser import JSONParser
@@ -31,6 +48,20 @@ from .logging import get_logger
 
 logger = get_logger(__name__)
 
+
+def _sanitize_for_json(obj):
+    """Replace NaN and Infinity float values with None for valid JSON serialization."""
+    if isinstance(obj, float):
+        if math.isnan(obj) or math.isinf(obj):
+            return None
+        return obj
+    if isinstance(obj, dict):
+        return {k: _sanitize_for_json(v) for k, v in obj.items()}
+    if isinstance(obj, (list, tuple)):
+        return [_sanitize_for_json(item) for item in obj]
+    return obj
+
+
 class CopilotKitConfig(TypedDict):
     """
     CopilotKit config for LangGraphAgent
@@ -236,7 +267,12 @@ class LangGraphAgent(Agent):
             actions=actions,
             agent_name=self.name
         )
-        current_graph_state.update(state)
+        # Only update graph state with keys that merge_state explicitly produced,
+        # not keys that were simply passed through from state_input unchanged.
+        # This preserves graph-owned state keys that the frontend may have sent stale values for.
+        for key, value in state.items():
+            if key not in state_input or value is not state_input.get(key):
+                current_graph_state[key] = value
         lg_interrupt_meta_event = next((ev for ev in (meta_events or []) if ev.get("name") == "LangGraphInterruptEvent"), None)
         has_active_interrupts = active_interrupts is not None and len(active_interrupts) > 0
 
@@ -435,7 +471,9 @@ class LangGraphAgent(Agent):
                     manually_emitted_state = None
 
                 if manually_emit_intermediate_state:
-                    manually_emitted_state = cast(Any, event["data"])
+                    manually_emitted_state = _merge_emit_state(current_graph_state, cast(Any, event["data"]))
+                    if isinstance(manually_emitted_state, dict):
+                        current_graph_state.update(manually_emitted_state)
                     yield self._emit_state_sync_event(
                         thread_id=thread_id,
                         run_id=run_id,
@@ -489,7 +527,7 @@ class LangGraphAgent(Agent):
                         active=not exiting_node
                     ) + "\n"
 
-                yield langchain_dumps(event) + "\n"
+                yield langchain_dumps(_sanitize_for_json(event)) + "\n"
         except Exception as error:
             # Emit error information through streaming protocol before terminating
             # This preserves the semantic error details that would otherwise be lost
@@ -591,6 +629,9 @@ class LangGraphAgent(Agent):
         # Filter by schema keys if available
         state = self.filter_state_on_schema_keys(state, 'output')
 
+        # Convert Pydantic BaseModel instances to dicts for serialization
+        state = _serialize_state(state)
+
         return langchain_dumps({
             "event": "on_copilotkit_state_sync",
             "thread_id": thread_id,
@@ -598,7 +639,7 @@ class LangGraphAgent(Agent):
             "agent_name": self.name,
             "node_name": node_name,
             "active": active,
-            "state": state,
+            "state": _sanitize_for_json(state),
             "running": running,
             "role": "assistant"
         })
@@ -636,10 +677,13 @@ class LangGraphAgent(Agent):
         state_copy = state.copy()
         state_copy.pop("messages", None)
 
+        # Convert Pydantic BaseModel instances to dicts for serialization
+        state_copy = _serialize_state(state_copy)
+
         return {
             "threadId": thread_id,
             "threadExists": True,
-            "state": state_copy,
+            "state": _sanitize_for_json(state_copy),
             "messages": messages
         }
 
@@ -687,7 +731,8 @@ class LangGraphAgent(Agent):
             if hasattr(self, schema_keys_name) and getattr(self, schema_keys_name):
                 return filter_by_schema_keys(state, getattr(self, schema_keys_name))
         except Exception:
-            return state
+            pass
+        return state
 
     def get_interrupt_event(self, value):
         if not isinstance(value, str) and "__copilotkit_interrupt_value__" in value:
@@ -724,6 +769,13 @@ class LangGraphAgent(Agent):
 
         raise ValueError("Message ID not found in history")
 
+
+def _merge_emit_state(current_state: dict, emitted_state: Any) -> dict:
+    """Merge emitted state on top of current graph state instead of replacing it."""
+    if isinstance(emitted_state, dict):
+        return {**current_state, **emitted_state}
+    return cast(Any, emitted_state)
+
 class _StreamingStateExtractor:
     def __init__(self, emit_intermediate_state: List[dict]):
         self.emit_intermediate_state = emit_intermediate_state

{copilotkit-0.1.86 → copilotkit-0.1.87}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "copilotkit"
-version = "0.1.86"
+version = "0.1.87"
 description = "CopilotKit python SDK"
 authors = ["Markus Ecker <markus.ecker@gmail.com>"]
 license = "MIT"