agentstream
Read, transform, and write AI agent session logs across formats (Claude, Codex, Gemini) with AG-UI events as the canonical format.
Installation
pip install agentstream
Quick Start
import agentstream
# Discover all agent sessions
sessions = agentstream.discover_sessions("~/myproject")
# Read as grouped messages
for msg in agentstream.read_messages(sessions[0]):
print(f"{msg.role}: {msg.text[:100]}")
for tc in msg.tool_calls:
print(f" -> {tc.name}({tc.args})")
Development
uv venv
uv pip install -e ".[dev]"
# Run tests with coverage
uv run pytest
# Type checking (ty is Astral's fast type checker)
uv run ty check
# Linting
uv run ruff check agentstream
Version Management
Python and Node.js versions are centralized in .python-version and .node-version files at the repo root.
Auto-updated from version files:
- CI workflows
- devcontainer
- Docker builds (via
make upinbackend/)
Manual updates required when changing versions:
| File | Settings to update |
|---|---|
pyproject.toml |
requires-python, target-version (ruff), python-version (ty) |
daemon/pyproject.toml |
requires-python, target-version |
backend/api/pyproject.toml |
requires-python, target-version |
Version policy:
- SDK (agentstream): Supports Python 3.12+ for broad compatibility
- Backend services (daemon, api): Require Python 3.13+ (we control deployment)
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file wandb_agentstream-1.0.3-py3-none-any.whl.
File metadata
- Download URL: wandb_agentstream-1.0.3-py3-none-any.whl
- Upload date:
- Size: 1.2 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
778e8dcfbfd747e2000a99b3e4fb7e146f1ce7527c26b8adb9f0ffa5a960fae7
|
|
| MD5 |
7b681f31deb4254e1c533c0b6e9bab64
|
|
| BLAKE2b-256 |
007229280c8886347aa2fbdbd8d3109503c131f756d153f72d820485119d8dff
|
Provenance
The following attestation bundles were made for wandb_agentstream-1.0.3-py3-none-any.whl:
Publisher:
release.yml on wandb/agentstream
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
wandb_agentstream-1.0.3-py3-none-any.whl -
Subject digest:
778e8dcfbfd747e2000a99b3e4fb7e146f1ce7527c26b8adb9f0ffa5a960fae7 - Sigstore transparency entry: 2106144040
- Sigstore integration time:
-
Permalink:
wandb/agentstream@51fcf22991b115fe21b115be6290eeaaffac8500 -
Branch / Tag:
refs/tags/v1.0.3 - Owner: https://github.com/wandb
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@51fcf22991b115fe21b115be6290eeaaffac8500 -
Trigger Event:
push
-
Statement type:
