glassflow-rius 0.8.0__tar.gz

glassflow_rius-0.8.0/.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly

glassflow_rius-0.8.0/.github/workflows/ci.yml

@@ -0,0 +1,69 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7.0.1
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - run: uv sync --locked --group dev
+      - run: uv run ruff check .
+      - run: uv run ruff format --check .
+      - run: uv run mypy
+      - run: uv build
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v7.0.1
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+      - run: uv sync --locked --group dev
+      - run: uv run pytest
+
+  # The mcp extra is unbounded (mcp>=1.0.0) and the two majors have different
+  # result shapes (snake_case + InputRequiredResult in 2.x, GLA2-300); the
+  # default suite exercises the locked 1.x, this job re-runs the MCP
+  # instrumentation tests with 2.x overlaid so a future rename fails a build
+  # instead of silently un-flagging error results.
+  mcp-v2:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7.0.1
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - run: uv sync --locked --group dev
+      - run: uv run --with "mcp>=2,<3" pytest tests/test_mcp_instrumentation.py
+
+  # Every instrumentation.REGISTRY entry must resolve against its real package —
+  # enable_instrumentations() swallows ImportError, so a typo'd module/class name
+  # would otherwise ship silently.
+  extras-smoke:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7.0.1
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - run: uv sync --locked --group dev --all-extras
+      - run: uv run pytest tests/test_instrumentation_registry.py
+        env:
+          GLASSFLOW_ALL_EXTRAS: "1"

glassflow_rius-0.8.0/.github/workflows/release.yml

@@ -0,0 +1,102 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+    steps:
+      - uses: googleapis/release-please-action@45996ed1f6d02564a971a2fa1b5860e934307cf7 # v5.0.0
+        id: release
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+  publish:
+    needs: release-please
+    if: ${{ needs.release-please.outputs.release_created == 'true' }}
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/glassflow-rius/
+    permissions:
+      id-token: write # OIDC for PyPI Trusted Publishing
+      contents: read
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7.6.0
+        with:
+          enable-cache: true
+      - run: uv sync --locked --group dev
+      - run: uv run pytest
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1
+
+  # Tell glassflow-docs a new version shipped: its bump-api-reference workflow
+  # opens the pin-bump + regenerated-reference PR. Fires only after the PyPI
+  # publish succeeded (the docs workflow pip-installs the version). Needs
+  # DOCS_DISPATCH_TOKEN — a fine-grained PAT (or GitHub App token) with
+  # contents:write on glassflow/glassflow-docs; GITHUB_TOKEN cannot dispatch
+  # cross-repo. Skips gracefully while the secret is unset (the docs
+  # workflow's weekly schedule is the fallback).
+  dispatch-docs:
+    needs: [release-please, publish]
+    if: ${{ needs.release-please.outputs.release_created == 'true' }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Dispatch the docs API-reference bump
+        env:
+          TOKEN: ${{ secrets.DOCS_DISPATCH_TOKEN }}
+          TAG: ${{ needs.release-please.outputs.tag_name }}
+        run: |
+          if [ -z "$TOKEN" ]; then
+            echo "DOCS_DISPATCH_TOKEN not configured; skipping (the docs weekly fallback will catch up)." >> "$GITHUB_STEP_SUMMARY"
+            exit 0
+          fi
+          version="${TAG#v}"
+          curl -sS --fail-with-body -X POST \
+            -H "Authorization: Bearer $TOKEN" \
+            -H "Accept: application/vnd.github+json" \
+            https://api.github.com/repos/glassflow/glassflow-docs/dispatches \
+            -d "{\"event_type\":\"sdk-release\",\"client_payload\":{\"version\":\"$version\"}}"
+
+  # Announce on Slack AFTER the PyPI publish succeeds, so the channel only
+  # ever sees releases that actually shipped. A separate `on: release`
+  # workflow would never fire: release-please creates the GitHub Release with
+  # GITHUB_TOKEN, whose events don't trigger other workflows.
+  notify:
+    needs: [release-please, publish]
+    if: ${{ needs.release-please.outputs.release_created == 'true' }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Post release summary to Slack
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          SLACK_WEBHOOK: ${{ secrets.SLACK_WEBHOOK_RELEASES }}
+          TAG: ${{ needs.release-please.outputs.tag_name }}
+        run: |
+          if [ -z "$SLACK_WEBHOOK" ]; then
+            echo "SLACK_WEBHOOK_RELEASES not configured; skipping." >> "$GITHUB_STEP_SUMMARY"
+            exit 0
+          fi
+          release_json=$(gh release view "$TAG" --repo "$GITHUB_REPOSITORY" --json body,url)
+          url=$(jq -r .url <<<"$release_json")
+          # release-please changelog markdown -> Slack mrkdwn:
+          # headings to bold, **bold** to *bold*, [text](url) to <url|text>
+          body=$(jq -r .body <<<"$release_json" | sed -E \
+            -e 's/^#{1,6} +(.*)$/*\1*/' \
+            -e 's/\*\*([^*]+)\*\*/*\1*/g' \
+            -e 's/\[([^]]+)\]\(([^)]+)\)/<\2|\1>/g' \
+            | head -c 3500)
+          jq -n --arg tag "$TAG" --arg url "$url" --arg body "$body" \
+            '{text: (":package: *glassflow-rius \($tag)* is on PyPI (<\($url)|release notes>)\n\n\($body)")}' \
+            | curl -sS --fail-with-body -X POST -H 'Content-Type: application/json' -d @- "$SLACK_WEBHOOK"

glassflow_rius-0.8.0/.gitignore

@@ -0,0 +1,22 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+
+# Virtual envs / uv
+.venv/
+
+# Test / coverage / type caches
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+# OS / editor
+.DS_Store
+.idea/
+.vscode/

glassflow_rius-0.8.0/.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.20
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

glassflow_rius-0.8.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.8.0"
+}

glassflow_rius-0.8.0/CHANGELOG.md

@@ -0,0 +1,112 @@
+# Changelog
+
+## [0.8.0](https://github.com/glassflow/rius-sdk-python/compare/v0.7.0...v0.8.0) (2026-08-05)
+
+
+### ⚠ BREAKING CHANGES
+
+* rebrand SDK to glassflow-rius, import rius ([#44](https://github.com/glassflow/rius-sdk-python/issues/44))
+
+### Features
+
+* rebrand SDK to glassflow-rius, import rius ([#44](https://github.com/glassflow/rius-sdk-python/issues/44)) ([82c91c1](https://github.com/glassflow/rius-sdk-python/commit/82c91c1f644ca31e53bc2737e8cf2326dfa1aba6))
+
+
+### Documentation
+
+* update readme title ([#46](https://github.com/glassflow/rius-sdk-python/issues/46)) ([4ae480a](https://github.com/glassflow/rius-sdk-python/commit/4ae480a626b4175789bac652bf9767bcbe50a705))
+
+## [0.7.0](https://github.com/glassflow/glassflow-python/compare/v0.6.0...v0.7.0) (2026-08-04)
+
+
+### Features
+
+* emit partial (pending) spans at span start ([#37](https://github.com/glassflow/glassflow-python/issues/37)) ([e39e555](https://github.com/glassflow/glassflow-python/commit/e39e55545bb718ab83c196c5ec5b2ce631c00cb8))
+
+
+### Bug Fixes
+
+* support mcp 2.x result shapes in MCP instrumentation ([#42](https://github.com/glassflow/glassflow-python/issues/42)) ([65aff4b](https://github.com/glassflow/glassflow-python/commit/65aff4b51bcbd9688f72dd0f0733dbc34bfb642d))
+
+
+### Documentation
+
+* remove em dashes from docstrings ([#39](https://github.com/glassflow/glassflow-python/issues/39)) ([7ca0af5](https://github.com/glassflow/glassflow-python/commit/7ca0af5a6237fec0918ab8745067da2e1f798004))
+
+## [0.6.0](https://github.com/glassflow/glassflow-python/compare/v0.5.0...v0.6.0) (2026-07-20)
+
+
+### Features
+
+* agent-lifetime heartbeat sender ([#32](https://github.com/glassflow/glassflow-python/issues/32)) ([7c592a8](https://github.com/glassflow/glassflow-python/commit/7c592a8822341e06b9bcd444502530a84dc80679))
+
+## [0.5.0](https://github.com/glassflow/glassflow-python/compare/v0.4.1...v0.5.0) (2026-07-15)
+
+
+### Features
+
+* record time-to-first-token on streaming generations ([#29](https://github.com/glassflow/glassflow-python/issues/29)) ([6c1ecaa](https://github.com/glassflow/glassflow-python/commit/6c1ecaa46c7086b2bbdccc5a4d4dd7ade036c3c7))
+
+## [0.4.1](https://github.com/glassflow/glassflow-python/compare/v0.4.0...v0.4.1) (2026-07-09)
+
+
+### Documentation
+
+* complete Google-style docstrings for the public API ([#26](https://github.com/glassflow/glassflow-python/issues/26)) ([75d82a1](https://github.com/glassflow/glassflow-python/commit/75d82a19617f89cebdc813f61757fdc3a5119b46))
+
+## [0.4.0](https://github.com/glassflow/glassflow-python/compare/v0.3.0...v0.4.0) (2026-07-06)
+
+
+### Features
+
+* first-class MCP tool-call instrumentation ([#24](https://github.com/glassflow/glassflow-python/issues/24)) ([623004f](https://github.com/glassflow/glassflow-python/commit/623004fdd388b7244d7bbc4374b1023ea7680793))
+
+## [0.3.0](https://github.com/glassflow/glassflow-python/compare/v0.2.0...v0.3.0) (2026-07-05)
+
+
+### ⚠ BREAKING CHANGES
+
+* Generation.set_model() is now set_response_model(); Generation.set_finish_reason() is now set_finish_reasons().
+
+### Features
+
+* bundled auto-instrumentation via OpenInference ([6945ab1](https://github.com/glassflow/glassflow-python/commit/6945ab13bead44f61d765273e23d9ce26513d6e2))
+* pre-1.0 API cleanups from the SDK review ([a294b94](https://github.com/glassflow/glassflow-python/commit/a294b945a01c68da3f918a5e9721b5d67a27433c))
+
+
+### Bug Fixes
+
+* crash-proofing and semconv corrections ([dd06b18](https://github.com/glassflow/glassflow-python/commit/dd06b187b2396e2648dc60b690f4c6c1367b72bb))
+* define init() lifecycle semantics ([4374298](https://github.com/glassflow/glassflow-python/commit/4374298615b5b08920a2b3bda96f4bdd27d760c9))
+* emit gen_ai.*.messages in the spec role/parts shape ([a7225d0](https://github.com/glassflow/glassflow-python/commit/a7225d0987c5e63e645b7f5d0f074bb1a42ffd46))
+* harden export-stage masking ([9781380](https://github.com/glassflow/glassflow-python/commit/9781380d68936a43b91db45403511d5b2fceeeb7))
+
+## [0.2.0](https://github.com/glassflow/glassflow-python/compare/v0.1.0...v0.2.0) (2026-07-03)
+
+
+### ⚠ BREAKING CHANGES
+
+* start_generation/start_as_current_generation param 'system' is now 'provider', and the emitted attribute is gen_ai.provider.name (was gen_ai.system).
+
+### Features
+
+* emit gen_ai.provider.name; rename generation param system -> provider ([f30ea71](https://github.com/glassflow/glassflow-python/commit/f30ea71674fe4d2797e9ab5d5842e393b40054c0))
+* harden export pipeline reliability ([0934973](https://github.com/glassflow/glassflow-python/commit/093497379eaed0ae0b0d56c9653efc1f37438ed1))
+* head-based sampling via sample_rate ([67d4fd1](https://github.com/glassflow/glassflow-python/commit/67d4fd1ea00950645866e391f3c38c6dcbf9cb8b))
+* PII masking and content opt-out at export ([2c3b4b0](https://github.com/glassflow/glassflow-python/commit/2c3b4b054bb78e2bc1757e55b944ee8e636aa418))
+
+## [0.1.0](https://github.com/glassflow/glassflow-python/compare/v0.0.1...v0.1.0) (2026-07-02)
+
+
+### Features
+
+* add `@observe` decorator for tracing user functions ([4e0ba4d](https://github.com/glassflow/glassflow-python/commit/4e0ba4d1013bb527df655012010fcd7accf65004))
+* add span-kind model (semconv) and kind param to `@observe` ([e1305d8](https://github.com/glassflow/glassflow-python/commit/e1305d8c05ca03b56975a67645a9c6f004c5a339))
+* add start_generation LLM capture helper (gen_ai-native) ([415b168](https://github.com/glassflow/glassflow-python/commit/415b1685403ff2fa6bc4450fe0242e6cd0f5c9a8))
+* add start_span manual span API + Observation handle ([70835f8](https://github.com/glassflow/glassflow-python/commit/70835f890ba2e48de22af99b393a9269d27cec1b))
+* align span API naming + add manual create/update/end lifecycle ([17e8f31](https://github.com/glassflow/glassflow-python/commit/17e8f31e634963f97c53e2be1fed84d434e85b15))
+
+
+### Documentation
+
+* update README title to GlassFlow Python SDK ([33cdacb](https://github.com/glassflow/glassflow-python/commit/33cdacb67b11454c16febfccbc89bdc0593bcd18))

glassflow_rius-0.8.0/CLAUDE.md

@@ -0,0 +1,89 @@
+# CLAUDE.md — rius-sdk-python
+
+Conventions for the GlassFlow instrumentation SDK (Python). Follow these; they
+override generic defaults.
+
+## What this is
+
+A public, OpenTelemetry-native tracing SDK for AI agents / LLM applications. It
+emits **OpenTelemetry GenAI (`gen_ai.*`) traces over OTLP/HTTP** to the managed
+GlassFlow platform (or any OTLP-compatible backend). GlassFlow is **managed-only**
+— there is no self-host, so config targets the managed endpoint.
+
+- Distribution name: `glassflow-rius` (PyPI) · import package: `rius`
+- `src/` layout; tests in `tests/`
+- Python-first; the TS/JS SDK lives in a separate repository
+
+## Tooling (uv-native)
+
+```bash
+uv sync --group dev       # set up the environment
+uv run pytest             # tests
+uv run ruff check .       # lint
+uv run ruff format .      # format (use --check in CI)
+uv run mypy               # type-check (strict)
+uv build                  # build sdist + wheel
+```
+
+Use `uv` + `ruff` as the toolchain. Do not add pip/venv workflows or a separate
+formatter/linter (no black/isort/flake8). Commit `uv.lock`.
+
+## Code conventions
+
+- **Python 3.10+**. Use modern typing (`X | None`, built-in generics).
+- **Fully typed**; ship `py.typed`. `mypy --strict` must pass (config in `pyproject.toml`).
+- **Ruff** for both lint and format; line length 100.
+- Public API is re-exported from `rius/__init__.py` and listed in `__all__`.
+- Prefer **dependency injection over mocking** for testability
+  (e.g. `init(span_exporter=...)` instead of patching the OTLP exporter).
+
+## OpenTelemetry conventions
+
+- **Convention-native** wire format — emit established conventions directly, never
+  a bespoke `glassflow.*` namespace (we own the backend, and this gives free
+  third-party ingestion via the normalizer). Pick the richest convention per concept:
+  - **Span kind:** `openinference.span.kind` (`SpanKind` enum) — gen_ai's
+    `operation.name` is not a sufficient kind taxonomy. Set `gen_ai.operation.name`
+    too where it maps.
+  - **LLM/generation spans:** fully **gen_ai-native** (`gen_ai.input.messages` /
+    `output.messages`, `gen_ai.request.model`, `gen_ai.usage.*`) — see `generation.py`.
+  - **Generic/tool/retriever spans:** `input.value` / `output.value` (OpenInference);
+    gen_ai has no generic non-LLM I/O.
+- Build on the OTel SDK primitives (`TracerProvider`, `BatchSpanProcessor`,
+  OTLP/HTTP exporter). Don't hand-roll tracing internals.
+- **Span API naming** (OTel/Langfuse/Laminar convention): `start_as_current_*` =
+  context manager (activates context, auto-ends); bare `start_*` = manual (returns
+  a handle you must `.end()`). Don't invert these.
+- All attribute keys live in `semconv.py`. Respect OTel norms (e.g. `service.name`).
+
+## Testing — TDD (required)
+
+- **Test-first.** Write a failing test, watch it fail for the right reason, then
+  write minimal code to pass. No production code without a failing test first.
+- pytest; use real code over mocks (inject dependencies).
+- Before pushing, all gates must be green: `ruff check`, `ruff format --check`,
+  `mypy`, `pytest`.
+
+## Versioning & releases
+
+- **Single source of truth** for the version: `__version__` in
+  `src/rius/__init__.py` (annotated `# x-release-please-version`);
+  hatchling reads it. **Do not** edit the version anywhere else or hand-write
+  `CHANGELOG.md`.
+- Releases are automated by **release-please** + **PyPI Trusted Publishing**
+  (`.github/workflows/release.yml`). Merging the auto-generated Release PR bumps
+  the version, tags `vX.Y.Z`, creates a GitHub Release, and publishes to PyPI.
+
+## Git & PR conventions
+
+- **Branch from `main`.** Branch names: `<user>/<TICKET>-short-desc`
+  (e.g. `pablo/gla2-19-observe-decorator`). Linear team key is `GLA2`.
+- **PRs are squash-merged; the PR title becomes the commit on `main`** and is
+  what release-please reads (the squash body is blank). PR titles must therefore
+  be Conventional Commits: `feat:` (minor), `fix:` (patch), `feat!:` (breaking —
+  must be marked in the **title**, since `BREAKING CHANGE:` footers in branch
+  commits don't survive the squash), plus `chore:`/`docs:`/`test:`/`refactor:`/
+  `ci:`. Non-conforming titles are ignored for versioning.
+- **No AI attribution** in commits or PRs (no `Co-Authored-By: Claude`, no
+  "Generated with…" trailers).
+- Open a PR; CI (lint/format/mypy + tests on Python 3.10–3.14 + extras smoke) must pass to merge.

glassflow_rius-0.8.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GlassFlow
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

glassflow_rius-0.8.0/PKG-INFO

@@ -0,0 +1,196 @@
+Metadata-Version: 2.4
+Name: glassflow-rius
+Version: 0.8.0
+Summary: GlassFlow Rius SDK — OpenTelemetry-native tracing for AI agents and LLM applications.
+Project-URL: Homepage, https://github.com/glassflow/rius-sdk-python
+Project-URL: Repository, https://github.com/glassflow/rius-sdk-python.git
+Project-URL: Issues, https://github.com/glassflow/rius-sdk-python/issues
+Author-email: GlassFlow <hello@glassflow.dev>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,genai,llm,observability,opentelemetry,otel,rius,tracing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: opentelemetry-api>=1.24.0
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.24.0
+Requires-Dist: opentelemetry-sdk>=1.24.0
+Provides-Extra: anthropic
+Requires-Dist: openinference-instrumentation-anthropic>=1.0.6; extra == 'anthropic'
+Provides-Extra: instruments
+Requires-Dist: mcp>=1.0.0; extra == 'instruments'
+Requires-Dist: openinference-instrumentation-anthropic>=1.0.6; extra == 'instruments'
+Requires-Dist: openinference-instrumentation-langchain>=0.1.67; extra == 'instruments'
+Requires-Dist: openinference-instrumentation-litellm>=0.1.34; extra == 'instruments'
+Requires-Dist: openinference-instrumentation-llama-index>=4.4.3; extra == 'instruments'
+Requires-Dist: openinference-instrumentation-openai>=0.1.52; extra == 'instruments'
+Provides-Extra: langchain
+Requires-Dist: openinference-instrumentation-langchain>=0.1.67; extra == 'langchain'
+Provides-Extra: litellm
+Requires-Dist: openinference-instrumentation-litellm>=0.1.34; extra == 'litellm'
+Provides-Extra: llama-index
+Requires-Dist: openinference-instrumentation-llama-index>=4.4.3; extra == 'llama-index'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == 'mcp'
+Provides-Extra: openai
+Requires-Dist: openinference-instrumentation-openai>=0.1.52; extra == 'openai'
+Description-Content-Type: text/markdown
+
+# Rius Python SDK
+
+OpenTelemetry-native tracing for AI agents and LLM applications. `glassflow-rius`
+emits [OpenTelemetry GenAI](https://opentelemetry.io/docs/specs/semconv/gen-ai/)
+traces over OTLP to the managed GlassFlow observability platform (or any
+OTLP-compatible backend).
+
+> Status: alpha. APIs may change.
+
+## Install
+
+```bash
+pip install glassflow-rius
+```
+
+## Quickstart
+
+```python
+import rius
+from rius import observe, start_as_current_generation, start_as_current_span
+from rius.semconv import SpanKind
+
+rius.init(
+    api_key="glassflow_...",          # or set GLASSFLOW_API_KEY
+    service_name="my-agent",          # or set GLASSFLOW_SERVICE_NAME
+)
+
+# 1. Decorator — trace a whole function
+@observe
+def handle(query: str) -> str: ...
+
+# 2. Context manager — trace a block
+with start_as_current_span("retrieve", kind=SpanKind.RETRIEVER) as obs:
+    obs.set_output(docs)
+
+# 3. LLM generations — gen_ai-native
+with start_as_current_generation("chat", model="gpt-4o", input=messages) as gen:
+    gen.set_output(reply)
+    gen.set_usage(input_tokens=42, output_tokens=17)
+```
+
+Each surface has a **manual** variant for lifetimes a `with` block can't express
+(streaming, callbacks): `start_span(...)` / `start_generation(...)` return a handle
+you `.update()` and must `.end()` yourself.
+
+Configuration is resolved from explicit arguments first, then environment
+variables:
+
+| Argument       | Environment variable     | Default                        | Description                                                          |
+| -------------- | ------------------------ | ------------------------------ | -------------------------------------------------------------------- |
+| `endpoint`     | `GLASSFLOW_ENDPOINT`     | `https://ingest.glassflow.dev` | Base OTLP endpoint. Traces are sent to `<endpoint>/v1/traces`.       |
+| `api_key`      | `GLASSFLOW_API_KEY`      | —                              | Injected as an `Authorization: Bearer <key>` header on every export. |
+| `service_name` | `GLASSFLOW_SERVICE_NAME` | `unknown_service`              | Sets the OpenTelemetry `service.name` resource attribute.            |
+| `disabled`     | `GLASSFLOW_DISABLED`     | `false`                        | Kill switch. When true, spans are created but never exported.        |
+| `sample_rate`  | `GLASSFLOW_SAMPLE_RATE`  | `1.0`                          | Head sampling ratio `0.0`–`1.0` (whole-trace; children follow root). |
+| `capture_content` | `GLASSFLOW_CAPTURE_CONTENT` | `true`                    | When false, prompt/response content is stripped at export (metadata still sent). |
+
+`mask` is a code-only option (no env var): pass a callable to `init(mask=...)` and
+it is applied to every content attribute value at export, across our spans and any
+bundled third-party instrumentation. A mask that accepts a `key` keyword also
+receives the attribute key, for per-attribute decisions.
+
+```python
+rius.init(mask=lambda value: "[REDACTED]")   # redact all captured content
+rius.init(mask=lambda value, *, key: hash_pii(value) if "input" in key else value)
+rius.init(capture_content=False)             # drop content entirely, keep metadata
+```
+
+## Auto-instrumentation
+
+The SDK bundles existing OTel instrumentors (OpenInference) as optional extras,
+so a single install captures your LLM provider and framework calls. Install the
+extras you need and `init()` enables whatever it finds; the instrumentation
+spans nest under your `@observe` / `start_as_current_span` traces automatically.
+
+```bash
+pip install "glassflow-rius[openai]"        # one provider
+pip install "glassflow-rius[instruments]"   # everything supported
+```
+
+```python
+rius.init()                          # auto-enables installed instrumentors
+rius.init(instruments=["openai"])    # restrict to specific ones
+rius.init(instruments=[])            # disable auto-instrumentation
+```
+
+Supported instruments: `openai`, `anthropic`, `langchain`, `llama-index`,
+`litellm`, and `mcp`. Content captured by instrumentors is covered by the same
+`mask` / `capture_content` controls as our own spans.
+
+The `mcp` instrument is built in: if the [`mcp`](https://pypi.org/project/mcp/)
+package is installed, every `ClientSession.call_tool()` your agent makes becomes
+a first-class TOOL span (`execute_tool <name>`) with `gen_ai.tool.name`, the
+arguments and result as `input.value`/`output.value`, latency, and error status
+(including tools that return `isError` results).
+
+Instrumentors patch libraries process-wide, so a scoped client
+(`init(set_global=False)`) only enables them when `instruments=[...]` is passed
+explicitly. Calling `init()` again while a client is active logs a warning and
+returns the existing client unchanged; call `client.shutdown()` first to
+reconfigure.
+
+## Reliability
+
+Export is designed to never block or crash your application:
+
+- **Async batched export.** Spans are queued in-process and exported in batches
+  from a background thread (`BatchSpanProcessor`). Span creation stays fast even
+  when the backend is slow or unreachable.
+- **Retries.** Transient failures (connection errors, 429/5xx) are retried with
+  exponential backoff and jitter, bounded by the export timeout.
+- **Graceful degradation.** If the backend stays down, spans are dropped and an
+  error is logged — exceptions never propagate into application code. A failing
+  `mask` callable drops only the affected attribute value (fail closed), never
+  the batch.
+- **Flush on shutdown.** Pending spans are flushed automatically at interpreter
+  exit. Call `client.flush()` to force an export, or `client.shutdown()` to
+  drain and stop.
+
+Batching and backpressure are tunable via the standard OpenTelemetry env vars:
+`OTEL_BSP_MAX_QUEUE_SIZE` (default 2048; spans beyond this are dropped),
+`OTEL_BSP_SCHEDULE_DELAY` (default 5000 ms), `OTEL_BSP_MAX_EXPORT_BATCH_SIZE`
+(default 512), and `OTEL_BSP_EXPORT_TIMEOUT` (default 30000 ms).
+
+## Development
+
+```bash
+uv sync --group dev
+uv run pytest
+uv run ruff check . && uv run ruff format --check .
+uv run mypy
+```
+
+## Releasing
+
+Releases are automated with [release-please](https://github.com/googleapis/release-please)
+and published to PyPI via Trusted Publishing.
+
+1. Merge changes to `main` using [Conventional Commits](https://www.conventionalcommits.org/)
+   (`feat:` → minor, `fix:` → patch, `feat!:`/`BREAKING CHANGE` → major).
+2. release-please keeps a **Release PR** open that bumps `__version__` and updates
+   `CHANGELOG.md`. Merge it when you want to cut a release.
+3. Merging tags `vX.Y.Z`, creates a GitHub Release, and publishes to PyPI automatically.
+
+Non-conventional commits are ignored for versioning.
+
+## License
+
+MIT
+