langgraph-stream-parser 0.1.7__tar.gz → 0.2.1__tar.gz

langgraph_stream_parser-0.2.1/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        include:
+          # One Windows job for cross-platform coverage (primary dev env).
+          - os: windows-latest
+            python-version: "3.12"
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Install
+        run: uv pip install --system -e ".[dev]"
+
+      - name: Test
+        run: pytest -ra --cov=langgraph_stream_parser --cov-report=term-missing

langgraph_stream_parser-0.2.1/.github/workflows/release.yml

@@ -0,0 +1,32 @@
+name: Release
+
+# Mirrors the deepagent-hermes release.yml: tag-driven publish to PyPI.
+# Tag any commit with `v*` (e.g. `v0.2.1`) and this builds + uploads.
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - name: Install build
+        run: pip install build
+      - name: Build wheel + sdist
+        # `python -m build` (no flag) runs sdist → wheel-from-sdist,
+        # matching the publish path local pre-flight checks should
+        # exercise. See deepagent-hermes v0.1.2 incident for why this
+        # matters: a wheel built directly with --wheel can ship fine
+        # while the wheel-from-sdist drops every Python file because
+        # of a restrictive [tool.hatch.build.targets.sdist] include.
+        run: python -m build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

{langgraph_stream_parser-0.1.7 → langgraph_stream_parser-0.2.1}/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## [0.1.9] - 2026-05-19
+
+Compatibility refresh for **langgraph 1.2**, **langchain-core 1.4**, and **deepagents 0.6**.
+
+### Added
+- `UsageEvent.cache_read_tokens` and `UsageEvent.cache_creation_tokens` — populated from `usage_metadata.input_token_details` (`cache_read`, `cache_creation`). Default 0; omitted from `to_dict()` when zero.
+- `ContentEvent.is_subagent` and `ReasoningEvent.is_subagent` — set to `True` when stream metadata carries `ls_agent_type == "subagent"` (deepagents >= 0.6). Lets consumers distinguish subagent output even when `lc_agent_name` is absent.
+- `"respond"` decision support in `InterruptEvent.build_decisions()` / `create_resume()`: pass `response="..."` to send a text reply in place of the tool call. Matches the deepagents 0.6 decision verb set.
+- `InterruptEvent.build_decisions(..., use_edited_action=False)` escape hatch for runtimes that still expect the legacy `{"type": "edit", "args": ...}` resume shape.
+
+### Changed
+- `extract_message_content()` now skips the full set of non-text content blocks defined by langchain-core 1.4 standard content blocks: `tool_call`, `tool_use`, `tool_call_chunk`, `server_tool_call`, `server_tool_call_chunk`, `server_tool_result`, `invalid_tool_call`, `image`, `audio`, `video`, `file` (plus the existing `reasoning` / `thinking`). Previously these could leak as stringified dicts into `ContentEvent.content`. Tool lifecycle and reasoning events are unchanged.
+- `InterruptEvent.build_decisions("edit", ...)` now emits the modern `{"type": "edit", "edited_action": {"name", "args"}}` shape by default, matching LangGraph 1.1+ / deepagents 0.5+. Set `use_edited_action=False` for the legacy shape.
+- `InterruptEvent.allowed_decisions` defaults to `{"approve", "reject", "edit", "respond"}` when no review configs are present (was `{"approve", "reject"}`).
+- Dev dependency bumped: `langgraph>=1.1.0`, `langchain-core>=1.4.0`.
+
+### Notes
+- **No breaking change for default tool extractors**: deepagents 0.6 ships new built-in tools (`glob_search`, `grep_search`, `execute`, `start_async_task` / `check_async_task` / `update_async_task` / `cancel_async_task` / `list_async_tasks`, plus QuickJS `CodeInterpreterMiddleware`). These flow through the regular `ToolCallStartEvent` / `ToolCallEndEvent` lifecycle — no parser change required.
+- **v3 `stream_events` typed projections** (LangGraph 1.2 beta) are not yet supported. v2 `StreamPart` parsing remains the recommended path for `stream()` / `astream()`.
+
+## [0.1.8] - 2026-04-18
+
+### Added
+- `ReasoningEvent` dataclass for reasoning / thinking content; emitted from langchain-core `reasoning` and `thinking` content blocks, and from `think_tool` reflections. Carries a `source` field (`"content_block"` or `"think_tool"`) so UIs can distinguish provenance.
+- `DisplayEvent` dataclass for rich inline content (dataframes, images, plotly, html, json) from `display_inline`-style tools. Carries `display_type`, `data`, `title`, `status`, `error`, `tool_name`, `tool_call_id`, `node`, `namespace`.
+- `extract_reasoning_content()` helper in `extractors.messages` for parsing reasoning blocks from `AIMessageChunk.content`.
+- `UpdatesHandler._event_from_extraction()` routes extractor output to typed events; unknown `extracted_type` values still flow through `ToolExtractedEvent` for custom extractors.
+- README sections: "Reasoning & Thinking" and "Rich Inline Display" with typed matching examples.
+
+### Changed
+- `think_tool` output is now a `ReasoningEvent(source="think_tool")` instead of `ToolExtractedEvent(extracted_type="reflection")`. Legacy dict API (`stream_graph_updates`) still produces `{"chunk": text}` for backward compatibility.
+- `display_inline` tool output is now a `DisplayEvent` instead of `ToolExtractedEvent(extracted_type="display_inline")`.
+- `extract_message_content()` now skips reasoning blocks so they can be surfaced as `ReasoningEvent` separately.
+
+### Fixed
+- Removed dead `has_messages` variable in `_parse_v2`.
+
 ## [0.1.7] - 2026-04-18
 
 ### Added

{langgraph_stream_parser-0.1.7 → langgraph_stream_parser-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langgraph-stream-parser
-Version: 0.1.7
+Version: 0.2.1
 Summary: Universal parser for LangGraph streaming outputs
 Project-URL: Homepage, https://github.com/dkedar7/langgraph-stream-parser
 Project-URL: Documentation, https://github.com/dkedar7/langgraph-stream-parser#readme
@@ -20,11 +20,13 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
+Provides-Extra: demo
+Requires-Dist: deepagents>=0.3; extra == 'demo'
 Provides-Extra: dev
 Requires-Dist: fastapi>=0.100; extra == 'dev'
 Requires-Dist: httpx>=0.25; extra == 'dev'
-Requires-Dist: langchain-core>=0.2.0; extra == 'dev'
-Requires-Dist: langgraph>=0.2.0; extra == 'dev'
+Requires-Dist: langchain-core>=1.4.0; extra == 'dev'
+Requires-Dist: langgraph>=1.1.0; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
 Requires-Dist: pytest-cov>=4.0; extra == 'dev'
 Requires-Dist: pytest>=7.0; extra == 'dev'
@@ -34,8 +36,15 @@ Requires-Dist: fastapi>=0.100; extra == 'fastapi'
 Provides-Extra: jupyter
 Requires-Dist: ipython>=8.0; extra == 'jupyter'
 Requires-Dist: rich>=13.0; extra == 'jupyter'
+Provides-Extra: real
+Requires-Dist: langchain-openai>=0.2; extra == 'real'
+Requires-Dist: langgraph>=1.1.0; extra == 'real'
 Description-Content-Type: text/markdown
 
+<p align="center">
+  <img src="assets/header.svg" alt="langgraph-stream-parser" width="100%">
+</p>
+
 # langgraph-stream-parser
 
 Universal parser for LangGraph streaming outputs. Normalizes complex, variable output shapes from `graph.stream()` and `graph.astream()` into consistent, typed event objects.
@@ -81,13 +90,17 @@ for event in parser.parse(graph.stream(input_data, stream_mode="updates")):
 | Event | Description |
 |-------|-------------|
 | `ContentEvent` | Text content from AI messages. Includes `agent_name` when from a deep agent subagent. |
+| `ReasoningEvent` | Reasoning / thinking text — from langchain-core `reasoning` content blocks or `think_tool` reflections |
 | `ToolCallStartEvent` | Tool call initiated by AI |
 | `ToolCallEndEvent` | Tool call completed with result |
-| `ToolExtractedEvent` | Special content extracted from tool (e.g., reflections, todos) |
+| `ToolExtractedEvent` | Special content extracted from tool (e.g., todos, custom extractors) |
+| `DisplayEvent` | Rich inline content (dataframe, image, plotly, html, json) from `display_inline`-style tools |
 | `InterruptEvent` | Human-in-the-loop interrupt requiring decision |
 | `StateUpdateEvent` | Non-message state updates (opt-in) |
-| `UsageEvent` | Token usage metadata (input/output/total tokens) |
+| `UsageEvent` | Token usage metadata (input/output/total/cache_read/cache_creation tokens) |
 | `CustomEvent` | Custom data emitted via `get_stream_writer()` |
+| `ValuesEvent` | Full state snapshot from `stream_mode="values"` (v2) |
+| `DebugEvent` | Debug, checkpoint, or task trace from v2 streaming |
 | `CompleteEvent` | Stream finished successfully |
 | `ErrorEvent` | Error during streaming |
 
@@ -169,6 +182,22 @@ for event in parser.parse(graph.stream(input_data, config=config)):
         break
 ```
 
+Supported decision types (deepagents 0.6+ / LangGraph 1.1+): `"approve"`, `"reject"`, `"edit"`, `"respond"`.
+
+```python
+# Edit args before approval — emits the modern ``edited_action`` shape
+resume = event.create_resume(
+    "edit",
+    args_modifier=lambda args: {**args, "safe": True},
+)
+
+# Reply with text in place of running the tool
+resume = event.create_resume("respond", response="Please rephrase that.")
+
+# For older LangGraph runtimes that expect ``{"type": "edit", "args": ...}``:
+resume = event.create_resume("edit", args_modifier=fn, use_edited_action=False)
+```
+
 ### Custom Tool Extractors
 
 ```python
@@ -251,12 +280,14 @@ for event in parser.parse(stream):
             print(event.content, end="")
 ```
 
-For [LangChain deep agents](https://docs.langchain.com/oss/python/deepagents/subagents), `ContentEvent.agent_name` is extracted from `lc_agent_name` metadata:
+For [LangChain deep agents](https://docs.langchain.com/oss/python/deepagents/subagents), `ContentEvent.agent_name` is extracted from `lc_agent_name` metadata, and `ContentEvent.is_subagent` is set to `True` when deepagents (>= 0.6) tags the run with `ls_agent_type="subagent"`. Match on either signal:
 
 ```python
-case ContentEvent(content=text, agent_name=name):
-    label = f"[{name}] " if name else ""
+case ContentEvent(content=text, agent_name=name, is_subagent=True):
+    label = f"[{name or 'subagent'}] "
     print(f"{label}{text}", end="")
+case ContentEvent(content=text):
+    print(text, end="")
 ```
 
 ### Custom Stream Mode
@@ -272,6 +303,60 @@ for event in parser.parse(stream):
             print(f"Progress: {data}")
 ```
 
+### Reasoning & Thinking
+
+Reasoning content arrives as a distinct `ReasoningEvent` so UIs can render it differently from the final answer (greyed out, collapsed, etc.). Two sources, same event type:
+
+```python
+for event in parser.parse(stream):
+    match event:
+        case ReasoningEvent(content=text, source="content_block"):
+            # From langchain-core reasoning blocks (Anthropic thinking,
+            # OpenAI reasoning summaries). Streamed token-by-token.
+            print(f"\033[90m{text}\033[0m", end="")  # grey
+        case ReasoningEvent(content=text, source="think_tool"):
+            # From the built-in think_tool ThinkToolExtractor.
+            print(f"💭 {text}")
+        case ContentEvent(content=text):
+            print(text, end="")
+```
+
+### Rich Inline Display
+
+For agents that need to show DataFrames, charts, images, or HTML in the transcript, use a `display_inline`-style tool. The parser recognizes the convention and emits a typed `DisplayEvent` — no stringified dict hacks.
+
+**Tool side** — return a JSON string with `display_type`, `data`, `title`, `status`:
+
+```python
+def show_dataframe(df_name: str) -> str:
+    import json
+    df = load(df_name)
+    return json.dumps({
+        "type": "display_inline",
+        "display_type": "dataframe",
+        "title": df_name,
+        "data": df.to_html(),       # or fig.to_json() for plotly,
+        "status": "success",         # base64 PNG for matplotlib, etc.
+    })
+```
+
+Configure your LangGraph tool registration with `name="display_inline"` (or register a custom `DisplayInlineExtractor` for a different name).
+
+**Consumer side** — match on `DisplayEvent`:
+
+```python
+for event in parser.parse(stream):
+    match event:
+        case DisplayEvent(display_type="dataframe", data=html, title=title):
+            ui.show_html(f"<h3>{title}</h3>{html}")
+        case DisplayEvent(display_type="plotly", data=plotly_json):
+            ui.show_plotly(json.loads(plotly_json))
+        case DisplayEvent(display_type=kind, data=data):
+            ui.show_generic(kind, data)
+```
+
+The `display_type` field is consumer-defined — any string the tool and UI agree on. Common values: `"dataframe"`, `"image"`, `"plotly"`, `"html"`, `"json"`.
+
 ### Configuration Options
 
 ```python
@@ -453,16 +538,17 @@ The package includes extractors for common LangGraph tools:
 
 - **ThinkToolExtractor**: Extracts reflections from `think_tool`
 - **TodoExtractor**: Extracts todo lists from `write_todos`
+- **DisplayInlineExtractor**: Extracts inline display artifacts from `display_inline`
 
 ## Examples
 
 ### FastAPI WebSocket Streaming
 
-See [examples/fastapi_websocket.py](examples/fastapi_websocket.py) for a complete example of streaming LangGraph events to a web client via WebSockets.
+See [examples/fastapi_websocket.py](examples/fastapi_websocket.py) for a complete example using `FastAPIAdapter` to stream LangGraph events to a web client.
 
 ```bash
 # Install dependencies
-pip install fastapi uvicorn websockets
+pip install 'langgraph-stream-parser[fastapi]' uvicorn
 
 # Run the example
 uvicorn examples.fastapi_websocket:app --reload

{langgraph_stream_parser-0.1.7 → langgraph_stream_parser-0.2.1}/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="assets/header.svg" alt="langgraph-stream-parser" width="100%">
+</p>
+
 # langgraph-stream-parser
 
 Universal parser for LangGraph streaming outputs. Normalizes complex, variable output shapes from `graph.stream()` and `graph.astream()` into consistent, typed event objects.
@@ -43,13 +47,17 @@ for event in parser.parse(graph.stream(input_data, stream_mode="updates")):
 | Event | Description |
 |-------|-------------|
 | `ContentEvent` | Text content from AI messages. Includes `agent_name` when from a deep agent subagent. |
+| `ReasoningEvent` | Reasoning / thinking text — from langchain-core `reasoning` content blocks or `think_tool` reflections |
 | `ToolCallStartEvent` | Tool call initiated by AI |
 | `ToolCallEndEvent` | Tool call completed with result |
-| `ToolExtractedEvent` | Special content extracted from tool (e.g., reflections, todos) |
+| `ToolExtractedEvent` | Special content extracted from tool (e.g., todos, custom extractors) |
+| `DisplayEvent` | Rich inline content (dataframe, image, plotly, html, json) from `display_inline`-style tools |
 | `InterruptEvent` | Human-in-the-loop interrupt requiring decision |
 | `StateUpdateEvent` | Non-message state updates (opt-in) |
-| `UsageEvent` | Token usage metadata (input/output/total tokens) |
+| `UsageEvent` | Token usage metadata (input/output/total/cache_read/cache_creation tokens) |
 | `CustomEvent` | Custom data emitted via `get_stream_writer()` |
+| `ValuesEvent` | Full state snapshot from `stream_mode="values"` (v2) |
+| `DebugEvent` | Debug, checkpoint, or task trace from v2 streaming |
 | `CompleteEvent` | Stream finished successfully |
 | `ErrorEvent` | Error during streaming |
 
@@ -131,6 +139,22 @@ for event in parser.parse(graph.stream(input_data, config=config)):
         break
 ```
 
+Supported decision types (deepagents 0.6+ / LangGraph 1.1+): `"approve"`, `"reject"`, `"edit"`, `"respond"`.
+
+```python
+# Edit args before approval — emits the modern ``edited_action`` shape
+resume = event.create_resume(
+    "edit",
+    args_modifier=lambda args: {**args, "safe": True},
+)
+
+# Reply with text in place of running the tool
+resume = event.create_resume("respond", response="Please rephrase that.")
+
+# For older LangGraph runtimes that expect ``{"type": "edit", "args": ...}``:
+resume = event.create_resume("edit", args_modifier=fn, use_edited_action=False)
+```
+
 ### Custom Tool Extractors
 
 ```python
@@ -213,12 +237,14 @@ for event in parser.parse(stream):
             print(event.content, end="")
 ```
 
-For [LangChain deep agents](https://docs.langchain.com/oss/python/deepagents/subagents), `ContentEvent.agent_name` is extracted from `lc_agent_name` metadata:
+For [LangChain deep agents](https://docs.langchain.com/oss/python/deepagents/subagents), `ContentEvent.agent_name` is extracted from `lc_agent_name` metadata, and `ContentEvent.is_subagent` is set to `True` when deepagents (>= 0.6) tags the run with `ls_agent_type="subagent"`. Match on either signal:
 
 ```python
-case ContentEvent(content=text, agent_name=name):
-    label = f"[{name}] " if name else ""
+case ContentEvent(content=text, agent_name=name, is_subagent=True):
+    label = f"[{name or 'subagent'}] "
     print(f"{label}{text}", end="")
+case ContentEvent(content=text):
+    print(text, end="")
 ```
 
 ### Custom Stream Mode
@@ -234,6 +260,60 @@ for event in parser.parse(stream):
             print(f"Progress: {data}")
 ```
 
+### Reasoning & Thinking
+
+Reasoning content arrives as a distinct `ReasoningEvent` so UIs can render it differently from the final answer (greyed out, collapsed, etc.). Two sources, same event type:
+
+```python
+for event in parser.parse(stream):
+    match event:
+        case ReasoningEvent(content=text, source="content_block"):
+            # From langchain-core reasoning blocks (Anthropic thinking,
+            # OpenAI reasoning summaries). Streamed token-by-token.
+            print(f"\033[90m{text}\033[0m", end="")  # grey
+        case ReasoningEvent(content=text, source="think_tool"):
+            # From the built-in think_tool ThinkToolExtractor.
+            print(f"💭 {text}")
+        case ContentEvent(content=text):
+            print(text, end="")
+```
+
+### Rich Inline Display
+
+For agents that need to show DataFrames, charts, images, or HTML in the transcript, use a `display_inline`-style tool. The parser recognizes the convention and emits a typed `DisplayEvent` — no stringified dict hacks.
+
+**Tool side** — return a JSON string with `display_type`, `data`, `title`, `status`:
+
+```python
+def show_dataframe(df_name: str) -> str:
+    import json
+    df = load(df_name)
+    return json.dumps({
+        "type": "display_inline",
+        "display_type": "dataframe",
+        "title": df_name,
+        "data": df.to_html(),       # or fig.to_json() for plotly,
+        "status": "success",         # base64 PNG for matplotlib, etc.
+    })
+```
+
+Configure your LangGraph tool registration with `name="display_inline"` (or register a custom `DisplayInlineExtractor` for a different name).
+
+**Consumer side** — match on `DisplayEvent`:
+
+```python
+for event in parser.parse(stream):
+    match event:
+        case DisplayEvent(display_type="dataframe", data=html, title=title):
+            ui.show_html(f"<h3>{title}</h3>{html}")
+        case DisplayEvent(display_type="plotly", data=plotly_json):
+            ui.show_plotly(json.loads(plotly_json))
+        case DisplayEvent(display_type=kind, data=data):
+            ui.show_generic(kind, data)
+```
+
+The `display_type` field is consumer-defined — any string the tool and UI agree on. Common values: `"dataframe"`, `"image"`, `"plotly"`, `"html"`, `"json"`.
+
 ### Configuration Options
 
 ```python
@@ -415,16 +495,17 @@ The package includes extractors for common LangGraph tools:
 
 - **ThinkToolExtractor**: Extracts reflections from `think_tool`
 - **TodoExtractor**: Extracts todo lists from `write_todos`
+- **DisplayInlineExtractor**: Extracts inline display artifacts from `display_inline`
 
 ## Examples
 
 ### FastAPI WebSocket Streaming
 
-See [examples/fastapi_websocket.py](examples/fastapi_websocket.py) for a complete example of streaming LangGraph events to a web client via WebSockets.
+See [examples/fastapi_websocket.py](examples/fastapi_websocket.py) for a complete example using `FastAPIAdapter` to stream LangGraph events to a web client.
 
 ```bash
 # Install dependencies
-pip install fastapi uvicorn websockets
+pip install 'langgraph-stream-parser[fastapi]' uvicorn
 
 # Run the example
 uvicorn examples.fastapi_websocket:app --reload

langgraph_stream_parser-0.2.1/assets/header.svg

@@ -0,0 +1,87 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="340" viewBox="0 0 1280 340" role="img" aria-label="langgraph-stream-parser — typed events and adapters for LangGraph streaming output">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#0B1221"/>
+      <stop offset="1" stop-color="#121226"/>
+    </linearGradient>
+    <linearGradient id="accent" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0" stop-color="#7C5CFF"/>
+      <stop offset="1" stop-color="#34D6C8"/>
+    </linearGradient>
+    <radialGradient id="glow" cx="0.82" cy="0.15" r="0.6">
+      <stop offset="0" stop-color="#7C5CFF" stop-opacity="0.22"/>
+      <stop offset="1" stop-color="#7C5CFF" stop-opacity="0"/>
+    </radialGradient>
+  </defs>
+
+  <rect width="1280" height="340" rx="20" fill="url(#bg)"/>
+  <rect width="1280" height="340" rx="20" fill="url(#glow)"/>
+  <rect x="1" y="1" width="1278" height="338" rx="19" fill="none" stroke="#26284A" stroke-width="1.5"/>
+
+  <!-- ===== left: identity ===== -->
+  <g transform="translate(72,64)">
+    <rect width="92" height="34" rx="17" fill="#1A1535" stroke="url(#accent)" stroke-width="1.5"/>
+    <circle cx="22" cy="17" r="5" fill="url(#accent)"/>
+    <text x="38" y="23" font-family="'SF Mono','JetBrains Mono','Consolas',monospace" font-size="15" fill="#C9BEFF">v0.2</text>
+  </g>
+
+  <text x="70" y="176" font-family="'SF Mono','JetBrains Mono','Consolas',monospace" font-size="50" font-weight="700" fill="#F2F6FC" letter-spacing="-1">langgraph<tspan fill="url(#accent)">-stream-parser</tspan></text>
+
+  <text x="72" y="220" font-family="'Segoe UI',Helvetica,Arial,sans-serif" font-size="22" fill="#A6AECB">Typed events &#38; adapters for LangGraph streaming output.</text>
+  <text x="72" y="250" font-family="'Segoe UI',Helvetica,Arial,sans-serif" font-size="22" fill="#A6AECB">The shared runtime behind the deep-agent surfaces.</text>
+
+  <g font-family="'SF Mono','JetBrains Mono','Consolas',monospace" font-size="13" fill="#7C7FA6">
+    <text x="72" y="298">StreamParser</text>
+    <text x="196" y="298" fill="#45487A">&#8226;</text>
+    <text x="216" y="298">extractors</text>
+    <text x="312" y="298" fill="#45487A">&#8226;</text>
+    <text x="332" y="298">adapters</text>
+    <text x="420" y="298" fill="#45487A">&#8226;</text>
+    <text x="440" y="298">host &#183; demo</text>
+  </g>
+
+  <!-- ===== right: stream -> typed events ===== -->
+  <g transform="translate(840,86)">
+    <!-- source: graph.stream() -->
+    <rect width="150" height="40" rx="10" fill="#161433" stroke="#3A2F66" stroke-width="1.5"/>
+    <text x="18" y="25" font-family="'SF Mono','Consolas',monospace" font-size="13" fill="#9FB0CC">graph.stream()</text>
+
+    <!-- arrow -->
+    <line x1="150" y1="20" x2="196" y2="20" stroke="url(#accent)" stroke-width="2"/>
+    <path d="M196 20 l-9 -5 v10 z" fill="#34D6C8"/>
+
+    <!-- parser node -->
+    <rect x="196" y="2" width="118" height="36" rx="10" fill="#1A1535" stroke="url(#accent)" stroke-width="1.5"/>
+    <circle cx="216" cy="20" r="5" fill="url(#accent)"/>
+    <text x="230" y="25" font-family="'SF Mono','Consolas',monospace" font-size="12" fill="#C9BEFF">parse()</text>
+
+    <!-- typed event chips -->
+    <g font-family="'SF Mono','Consolas',monospace" font-size="12">
+      <g transform="translate(40,72)">
+        <rect width="130" height="26" rx="6" fill="#10243A" stroke="#2F9BFF" stroke-width="1"/>
+        <circle cx="15" cy="13" r="4" fill="#2F9BFF"/>
+        <text x="28" y="17" fill="#8FC4FF">ContentEvent</text>
+      </g>
+      <g transform="translate(190,72)">
+        <rect width="150" height="26" rx="6" fill="#0C2A22" stroke="#34D6C8" stroke-width="1"/>
+        <circle cx="15" cy="13" r="4" fill="#34D6C8"/>
+        <text x="28" y="17" fill="#7FE3D6">ToolCallStart</text>
+      </g>
+      <g transform="translate(40,108)">
+        <rect width="150" height="26" rx="6" fill="#0C2A22" stroke="#34D6C8" stroke-width="1"/>
+        <circle cx="15" cy="13" r="4" fill="#34D6C8"/>
+        <text x="28" y="17" fill="#7FE3D6">ToolCallEnd</text>
+      </g>
+      <g transform="translate(210,108)">
+        <rect width="130" height="26" rx="6" fill="#241A33" stroke="#7C5CFF" stroke-width="1"/>
+        <circle cx="15" cy="13" r="4" fill="#7C5CFF"/>
+        <text x="28" y="17" fill="#C9BEFF">Interrupt</text>
+      </g>
+      <g transform="translate(40,144)">
+        <rect width="180" height="26" rx="6" fill="#10243A" stroke="#2F9BFF" stroke-width="1"/>
+        <circle cx="15" cy="13" r="4" fill="#2F9BFF"/>
+        <text x="28" y="17" fill="#8FC4FF">Reasoning &#183; Display &#8230;</text>
+      </g>
+    </g>
+  </g>
+</svg>

{langgraph_stream_parser-0.1.7 → langgraph_stream_parser-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "langgraph-stream-parser"
-version = "0.1.7"
+version = "0.2.1"
 description = "Universal parser for LangGraph streaming outputs"
 readme = "README.md"
 license = {text = "MIT"}
@@ -38,12 +38,19 @@ jupyter = [
 fastapi = [
     "fastapi>=0.100",
 ]
+demo = [
+    "deepagents>=0.3",
+]
+real = [
+    "langchain-openai>=0.2",
+    "langgraph>=1.1.0",
+]
 dev = [
     "pytest>=7.0",
     "pytest-asyncio>=0.21",
     "pytest-cov>=4.0",
-    "langgraph>=0.2.0",
-    "langchain-core>=0.2.0",
+    "langgraph>=1.1.0",
+    "langchain-core>=1.4.0",
     "rich>=13.0",
     "fastapi>=0.100",
     "httpx>=0.25",
@@ -65,6 +72,9 @@ packages = ["src/langgraph_stream_parser"]
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
 testpaths = ["tests"]
+markers = [
+    "real_model: hits a live LLM via OpenRouter (opt-in; skips without OPENROUTER_API_KEY)",
+]
 
 [tool.coverage.run]
 source = ["src/langgraph_stream_parser"]

{langgraph_stream_parser-0.1.7 → langgraph_stream_parser-0.2.1}/src/langgraph_stream_parser/__init__.py

@@ -32,9 +32,11 @@ Legacy Dict-Based API:
 from .parser import StreamParser
 from .events import (
     ContentEvent,
+    ReasoningEvent,
     ToolCallStartEvent,
     ToolCallEndEvent,
     ToolExtractedEvent,
+    DisplayEvent,
     InterruptEvent,
     StateUpdateEvent,
     UsageEvent,
@@ -47,8 +49,14 @@ from .events import (
     event_to_dict,
 )
 from .extractors.base import ToolExtractor
-from .extractors.builtins import ThinkToolExtractor, TodoExtractor, DisplayInlineExtractor
+from .extractors.builtins import (
+    DisplayInlineExtractor,
+    GenericToolExtractor,
+    ThinkToolExtractor,
+    TodoExtractor,
+)
 from .resume import create_resume_input, prepare_agent_input
+from .host import load_agent_spec, HostConfig, Workspace
 from .compat import (
     stream_graph_updates,
     astream_graph_updates,
@@ -56,16 +64,18 @@ from .compat import (
     aresume_graph_from_interrupt,
 )
 
-__version__ = "0.1.7"
+__version__ = "0.2.1"
 
 __all__ = [
     # Main parser
     "StreamParser",
     # Event types
     "ContentEvent",
+    "ReasoningEvent",
     "ToolCallStartEvent",
     "ToolCallEndEvent",
     "ToolExtractedEvent",
+    "DisplayEvent",
     "InterruptEvent",
     "StateUpdateEvent",
     "UsageEvent",
@@ -80,9 +90,14 @@ __all__ = [
     "ThinkToolExtractor",
     "TodoExtractor",
     "DisplayInlineExtractor",
+    "GenericToolExtractor",
     # Resume utilities
     "create_resume_input",
     "prepare_agent_input",
+    # Host conventions
+    "load_agent_spec",
+    "HostConfig",
+    "Workspace",
     # Serialization
     "event_to_dict",
     # Legacy/compat functions

{langgraph_stream_parser-0.1.7 → langgraph_stream_parser-0.2.1}/src/langgraph_stream_parser/adapters/__init__.py

@@ -4,6 +4,7 @@ from .base import BaseAdapter, ToolStatus, ToolState
 from .print import PrintAdapter
 from .cli import CLIAdapter
 from .fastapi import FastAPIAdapter
+from .session import SessionAdapter, Session
 
 __all__ = [
     "BaseAdapter",
@@ -12,4 +13,6 @@ __all__ = [
     "PrintAdapter",
     "CLIAdapter",
     "FastAPIAdapter",
+    "SessionAdapter",
+    "Session",
 ]