chore: update graphai docs

Author: aurelio-bot

docs.json

@@ -246,4 +246,4 @@
       "youtube": "https://www.youtube.com/@jamesbriggs"
     }
   }
-}
+}

graphai/client-reference/callback.mdx

@@ -3,12 +3,36 @@ sidebarTitle: callback
 title: graphai.callback
 ---
 
+## GraphEvent Objects
+
+```python
+@dataclass
+class GraphEvent()
+```
+
+A graph event emitted for specific graph events such as start node or end node,
+
+and used by the callback to emit user-defined events.
+
+**Arguments**:
+
+- `type` (`GraphEventType`): The type of event, can be start_node, end_node, or callback.
+- `identifier` (`str`): The identifier of the event, this is set typically by a callback
+handler and can be used to distinguish between different events. For example, a
+conversation/session ID could be used.
+- `token` (`str | None`): The token associated with the event, such as LLM streamed output.
+- `params` (`dict[str, Any] | None`): The parameters associated with the event, such as tool call parameters
+or event metadata.
+
 ## Callback Objects
 
 ```python
 class Callback()
 ```
 
+The original callback handler class. Outputs a stream of structured text
+tokens. It is recommended to use the newer `EventCallback` handler instead.
+
 #### aiter
 
 ```python
@@ -44,3 +68,47 @@ async def close()
 Close the stream and prevent further tokens from being added.
 This will send an END token and set the done flag to True.
 
+## EventCallback Objects
+
+```python
+class EventCallback(Callback)
+```
+
+The event callback handler class. Outputs a stream of structured text
+tokens. It is recommended to use the newer `EventCallback` handler instead.
+
+#### aiter
+
+```python
+async def aiter() -> AsyncIterator[GraphEvent]
+```
+
+Used by receiver to get the tokens from the stream queue. Creates
+a generator that yields tokens from the queue until the END token is
+received.
+
+#### start\_node
+
+```python
+async def start_node(node_name: str, active: bool = True)
+```
+
+Starts a new node and emits the start token.
+
+#### end\_node
+
+```python
+async def end_node(node_name: str)
+```
+
+Emits the end token for the current node.
+
+#### close
+
+```python
+async def close()
+```
+
+Close the stream and prevent further tokens from being added.
+This will send an END token and set the done flag to True.
+

graphai/user-guide/release-notes.mdx

@@ -1,5 +1,38 @@
 See below for all notable changes to the GraphAI library.
 
+## [0.0.9] - TBD
+
+### Added
+- Enhanced `FunctionSchema.from_pydantic()` method with full Pydantic v2 support
+  - Correctly extracts field types, descriptions, and default values from Pydantic models
+  - Handles `Optional` types and complex type annotations
+  - Properly identifies required vs optional fields using `PydanticUndefined`
+- New `to_openai()` method on FunctionSchema for OpenAI API format support
+  - Supports both `completions` and `responses` API endpoints
+  - Export schemas for either nested or flat format structures
+- New `EventCallback` class for object-based callback handling
+  - Outputs structured `GraphEvent` objects instead of formatted strings
+  - Provides `GraphEventType` enum for event type identification
+  - Better structured data with `type`, `identifier`, `token`, and `params` fields
+  - Maintains backward compatibility with existing callback interface
+- Comprehensive graph compilation validation
+  - Stricter validation of node connections and dependencies
+  - Better error messages for graph construction issues
+  - Cycle detection with clear `GraphCompileError` reporting
+
+### Changed
+- Graph compilation now validates execution order at compile time
+- Graphs with cycles now raise `GraphCompileError` during compilation to ensure predictable execution order
+
+### Deprecated
+- `Callback` class is deprecated and will be removed in v0.1.0 - use `EventCallback` instead
+- `special_token_format` and `token_format` parameters in `EventCallback` exist for backwards compatibility but are deprecated and will be removed in v0.1.0
+
+### Fixed
+- Added Python 3.10 compatibility for `StrEnum` with fallback implementation
+- Fixed type annotation issues with `default_factory` in Pydantic field definitions
+- Improved type extraction for complex Pydantic field types including `Union` and `Optional`
+
 ## [0.0.8] - 2025-08-16
 
 ### Added