chore(release): Release v1.1.0

Author: skylarmb

CHANGELOG.md

@@ -1,5 +1,30 @@
 ## [Unreleased]
 
+## [1.1.0] - 2026-05-19
+
+### Added
+
+- **Charts API: `client.charts` CRUD surface**
+  - New `client.charts.create()`, `.list()`, `.get(chart_id)`, `.update(chart_id, request)`, and `.delete(chart_id)` methods (plus `*_async` variants) backed by `POST /v1/charts`, `GET /v1/charts`, `GET /v1/charts/{chart_id}`, `PUT /v1/charts/{chart_id}`, and `DELETE /v1/charts/{chart_id}`. Chart request and response models are exported from `honeyhive.models`.
+
+### Changed
+
+- **CrewAI integration example refreshed**
+  - The CrewAI example (`examples/integrations/crewai_integration.py`) has been rewritten with three realistic customer-support scenarios (single-agent with tool calls, sequential two-agent crew, and `@trace` escalation). Crews are now named for clearer span labels, and teardown properly flushes remaining spans.
+
+### Fixed
+
+- **Tracer init: `project` / `HH_PROJECT` no longer required**
+  - `HoneyHiveTracer.init()` previously required `project` and treated a missing value as degraded mode. Since the backend determines the project from the API key, only `api_key` is actually needed. Callers that followed the v1.0.1 deprecation guidance and removed `project` were silently running in degraded mode — this is now fixed. `project` and `HH_PROJECT` remain accepted for backwards compatibility (deprecated, to be removed in v2.0).
+
+- **Duplicate `model` spans in `evaluate()`**
+  - `evaluate()` could occasionally emit two `model` spans for a single LLM call when running multiple datapoints concurrently. The underlying race condition in instrumentation setup has been fixed.
+
+### Removed
+
+- **`cp_base_url=` parameter and `HH_CP_API_URL` env var removed**
+  - These options were vestigial configuration for an incomplete Control Plane integration that was never wired up or shipped. No customer code could have depended on them. They have been removed to clean up the public API surface. If you happen to pass `cp_base_url=` or set `HH_CP_API_URL`, simply remove them — `HH_API_URL` / `base_url=` is the only base-URL setting.
+
 ## [1.0.2] - 2026-05-11
 
 ### Fixed
@@ -9,7 +34,7 @@
   - The two legacy write paths have been removed now that the scores are correctly written to the chain span as the single source of truth.
 
 - **API Client: `event_id` typed as required on `POST /events` responses**
-  - `PostEventResponse.event_id` was incorrectly typed as `Optional[str]` in the OpenAPI spec; the backend always returns the field on a 2xx response. The spec was corrected and the generated SDK now reflects the runtime guarantee, removing the need for defensive `if event.event_id:` guards. No runtime behavior change, but strictly typed mypy codebases with `warn_unreachable = True` or pyright with `reportUnnecessaryComparison` enabled may produce "unnecessary comparison" or "redundant Optional guard" warnings, depending on exact usage patterns. 
+  - `PostEventResponse.event_id` was incorrectly typed as `Optional[str]` in the OpenAPI spec; the backend always returns the field on a 2xx response. The spec was corrected and the generated SDK now reflects the runtime guarantee, removing the need for defensive `if event.event_id:` guards. No runtime behavior change, but strictly typed mypy codebases with `warn_unreachable = True` or pyright with `reportUnnecessaryComparison` enabled may produce "unnecessary comparison" or "redundant Optional guard" warnings, depending on exact usage patterns.
 
 ### Added
 

CONTRIBUTING.md

@@ -76,7 +76,7 @@ make help
 Key commands:
 - `make check` - Run all comprehensive checks (format, lint, tests, validation)
 - `make test` - Run all tests
-- `make format` - Format code with Black and isort
+- `make format` - Format code with ruff
 - `make lint` - Run linting checks
 - `make generate-sdk` - Generate SDK from OpenAPI spec
 
@@ -88,8 +88,7 @@ make check
 ```
 
 This runs all quality checks:
-- ✅ Black formatting
-- ✅ Import sorting (isort)
+- ✅ Ruff formatting and import sorting
 - ✅ Static analysis (pylint + mypy)
 - ✅ Unit tests (fast, mocked)
 - ✅ Integration test validation

Makefile

@@ -1,7 +1,7 @@
 .PHONY: help install install-dev test test-all test-unit test-integration check-integration lint format check check-format check-lint typecheck check-tracer-patterns check-no-mocks generate generate-sdk compare-sdk docs-serve docs-build clean clean-all build publish
 
 # Use uv run to automatically resolve the workspace venv and dependencies.
-# --extra dev ensures SDK dev optional-dependencies (black, isort, tox, etc.) are installed.
+# --extra dev ensures SDK dev optional-dependencies (ruff, tox, etc.) are installed.
 # Override with: UV_RUN="python3" make build
 UV_RUN ?= uv run --extra dev
 PYTHON ?= $(UV_RUN) python
@@ -23,7 +23,7 @@ help:
 	@echo "  make test-integration - Run integration tests only (requires .env)"
 	@echo ""
 	@echo "Code Quality:"
-	@echo "  make format          - Format code with black and isort"
+	@echo "  make format          - Format code with ruff"
 	@echo "  make lint            - Run linting checks"
 	@echo "  make typecheck       - Run mypy type checking"
 	@echo "  make check           - Run ALL checks"
@@ -84,8 +84,8 @@ check-integration:
 
 # Code Quality
 format:
-	$(UV_RUN) black src tests examples scripts
-	$(UV_RUN) isort src tests examples scripts
+	$(UV_RUN) ruff format src tests examples scripts
+	$(UV_RUN) ruff check --select I --fix src tests examples scripts
 
 lint:
 	$(UV_RUN) tox -e lint

docs/gen_ref_pages.py

@@ -179,8 +179,7 @@ def _is_nav_visible(parts: tuple[str, ...]) -> bool:
     identifier = ".".join(parts)
     with mkdocs_gen_files.open(full_doc_path, "w") as fd:
         fd.write(
-            f"---\ntitle: {identifier}\n---\n\n"
-            f"# `{identifier}`\n\n::: {identifier}\n"
+            f"---\ntitle: {identifier}\n---\n\n# `{identifier}`\n\n::: {identifier}\n"
         )
 
 # Write the literate-nav summary so the nav tree mirrors the package layout.

examples/advanced_usage.py

@@ -20,8 +20,12 @@
 import time
 from typing import Any, Dict, Optional
 
-from honeyhive import enrich_span  # Legacy pattern for context manager demo
-from honeyhive import HoneyHiveTracer, trace, trace_class
+from honeyhive import (
+    HoneyHiveTracer,
+    enrich_span,  # Legacy pattern for context manager demo
+    trace,
+    trace_class,
+)
 from honeyhive.config.models import SessionConfig, TracerConfig
 from honeyhive.models import EventType
 

examples/basic_usage.py

@@ -156,7 +156,8 @@ def process_data(input_data):
 
     # Initialize API client
     client = HoneyHive(
-        api_key="your-api-key-here", test_mode=True  # Use test mode for examples
+        api_key="your-api-key-here",
+        test_mode=True,  # Use test mode for examples
     )
     print("✓ API client initialized")
     print("✓ Ready for API operations (events, datasets, etc.)")

examples/debug_openai_instrumentor_spans.py

@@ -49,13 +49,13 @@
 
 def init_honeyhive_tracer(session_name: str):
     """Initialize HoneyHive tracer with verbose logging enabled."""
-    print(f"\n{'='*80}")
+    print(f"\n{'=' * 80}")
     print(f"INITIALIZING HONEYHIVE TRACER")
-    print(f"{'='*80}")
+    print(f"{'=' * 80}")
     print(f"Session: {session_name}")
     print(f"Server URL: {HH_SERVER_URL or 'default'}")
     print(f"Verbose: True")
-    print(f"{'='*80}\n")
+    print(f"{'=' * 80}\n")
 
     tracer = HoneyHiveTracer.init(
         api_key=HH_API_KEY,
@@ -70,11 +70,11 @@ def init_honeyhive_tracer(session_name: str):
 
 def instrument_openai(tracer):
     """Initialize OpenAI instrumentor with tracer provider."""
-    print(f"\n{'='*80}")
+    print(f"\n{'=' * 80}")
     print(f"INSTRUMENTING OPENAI")
-    print(f"{'='*80}")
+    print(f"{'=' * 80}")
     print(f"Using tracer provider: {tracer.provider}")
-    print(f"{'='*80}\n")
+    print(f"{'=' * 80}\n")
 
     instrumentor = OpenAIInstrumentor()
     instrumentor.instrument(tracer_provider=tracer.provider)
@@ -228,7 +228,7 @@ def test_multiple_sequential_calls(queries: list) -> list:
     results = []
 
     for i, query in enumerate(queries):
-        print(f"[TEST 4] Processing query {i+1}/{len(queries)}: {query}")
+        print(f"[TEST 4] Processing query {i + 1}/{len(queries)}: {query}")
 
         response = client.chat.completions.create(
             model="gpt-3.5-turbo",
@@ -242,9 +242,9 @@ def test_multiple_sequential_calls(queries: list) -> list:
         result = response.choices[0].message.content
         if result:
             results.append(result)
-            print(f"[TEST 4] Response {i+1}: {result}")
+            print(f"[TEST 4] Response {i + 1}: {result}")
         else:
-            print(f"[TEST 4] Response {i+1}: <empty>")
+            print(f"[TEST 4] Response {i + 1}: <empty>")
 
     # Enrich with aggregated metrics
     print(f"[TEST 4] Attempting enrich_span with aggregated metrics...")
@@ -262,9 +262,9 @@ def test_multiple_sequential_calls(queries: list) -> list:
 
 def main():
     """Run all debug tests."""
-    print(f"\n{'#'*80}")
+    print(f"\n{'#' * 80}")
     print(f"# OPENAI INSTRUMENTOR SPAN DEBUG SCRIPT")
-    print(f"{'#'*80}\n")
+    print(f"{'#' * 80}\n")
 
     # Initialize tracer
     tracer = init_honeyhive_tracer("Debug Session - OpenAI Instrumentor Spans")
@@ -285,23 +285,23 @@ def main():
         # Test 4: Multiple sequential calls
         test_multiple_sequential_calls(["What is AI?", "What is ML?", "What is DL?"])
 
-        print(f"\n{'='*80}")
+        print(f"\n{'=' * 80}")
         print(f"ALL TESTS COMPLETED")
-        print(f"{'='*80}\n")
+        print(f"{'=' * 80}\n")
 
     except Exception as e:
-        print(f"\n{'!'*80}")
+        print(f"\n{'!' * 80}")
         print(f"ERROR OCCURRED: {e}")
-        print(f"{'!'*80}\n")
+        print(f"{'!' * 80}\n")
         import traceback
 
         traceback.print_exc()
 
     finally:
         # Flush tracer to ensure all spans are sent
-        print(f"\n{'='*80}")
+        print(f"\n{'=' * 80}")
         print(f"FLUSHING TRACER")
-        print(f"{'='*80}\n")
+        print(f"{'=' * 80}\n")
         flush(tracer)
 
         # Uninstrument to clean up

examples/evaluate_with_adk_instrumentor.py

@@ -76,7 +76,7 @@ def get_current_time(city: str) -> dict:
 
     tz = ZoneInfo(tz_identifier)
     now = datetime.datetime.now(tz)
-    report = f'The current time in {city} is {now.strftime("%Y-%m-%d %H:%M:%S %Z%z")}'
+    report = f"The current time in {city} is {now.strftime('%Y-%m-%d %H:%M:%S %Z%z')}"
     return {"status": "success", "report": report}
 
 

examples/evaluate_with_enrichment.py

@@ -199,15 +199,15 @@ def postprocess(text: str) -> str:
 
     # For demo, manually iterate
     for i, datapoint in enumerate(mock_dataset):
-        print(f"\n  Datapoint {i+1}/{len(mock_dataset)}:")
+        print(f"\n  Datapoint {i + 1}/{len(mock_dataset)}:")
         result = simple_llm_task(datapoint)
         print(f"    ✓ Output: {result['output'][:50]}...")
 
     print("\n✓ Simple task evaluation completed")
 
     print("\n  📝 Running complex task on mock dataset...")
     for i, datapoint in enumerate(mock_dataset):
-        print(f"\n  Datapoint {i+1}/{len(mock_dataset)}:")
+        print(f"\n  Datapoint {i + 1}/{len(mock_dataset)}:")
         result = complex_task_with_steps(datapoint)
         print(f"    ✓ Output: {result['output'][:50]}...")