kalibr 1.2.0__tar.gz → 1.2.2__tar.gz

{kalibr-1.2.0 → kalibr-1.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.2
 Name: kalibr
-Version: 1.2.0
+Version: 1.2.2
 Summary: Unified LLM Observability & Multi-Model AI Integration Framework - Deploy to GPT, Claude, Gemini, Copilot with full telemetry.
 Author-email: Kalibr Team <support@kalibr.systems>
 License: Apache-2.0
@@ -64,7 +64,6 @@ Requires-Dist: pytest>=7.4.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
-Dynamic: license-file
 
 # Kalibr Python SDK
 
@@ -188,6 +187,41 @@ policy = get_policy(
 )
 ```
 
+### Intelligent Routing with decide()
+
+Register execution paths and let Kalibr decide the best strategy:
+
+```python
+from kalibr import register_path, decide
+
+# Register available paths
+register_path(goal="book_meeting", model_id="gpt-4o", tool_id="calendar_api")
+register_path(goal="book_meeting", model_id="claude-3-sonnet")
+
+# Get intelligent routing decision
+decision = decide(goal="book_meeting")
+model = decision["model_id"]       # Selected based on outcomes
+tool = decision.get("tool_id")     # If tool routing enabled
+print(decision["exploration"])     # True if exploring new paths
+```
+
+### Goal Context
+
+Tag traces with goals for outcome tracking:
+
+```python
+from kalibr import goal, set_goal, get_goal, clear_goal
+
+# Context manager (recommended)
+with goal("book_meeting"):
+    response = openai.chat.completions.create(...)
+
+# Or manual control
+set_goal("book_meeting")
+response = openai.chat.completions.create(...)
+clear_goal()
+```
+
 ## TraceCapsule - Cross-Agent Tracing
 
 Propagate trace context across agent boundaries:
@@ -285,7 +319,7 @@ Configure via environment variables:
 | `KALIBR_API_KEY` | API key for authentication | *Required* |
 | `KALIBR_TENANT_ID` | Tenant identifier | `default` |
 | `KALIBR_COLLECTOR_URL` | Collector endpoint URL | `https://api.kalibr.systems/api/ingest` |
-| `KALIBR_INTELLIGENCE_URL` | Intelligence API URL | `https://kalibr-intelligence.fly.dev` |
+| `KALIBR_INTELLIGENCE_URL` | Intelligence API URL | `https://dashboard.kalibr.systems/intelligence` |
 | `KALIBR_SERVICE_NAME` | Service name for spans | `kalibr-app` |
 | `KALIBR_ENVIRONMENT` | Environment (prod/staging/dev) | `prod` |
 | `KALIBR_WORKFLOW_ID` | Workflow identifier | `default` |
@@ -294,20 +328,20 @@ Configure via environment variables:
 ## CLI Commands
 
 ```bash
-# Serve your app with tracing
-kalibr serve myapp.py
+# Show version
+kalibr version
 
-# Run with managed runtime
-kalibr run myapp.py --port 8000
+# Validate configuration
+kalibr validate
 
-# Deploy to cloud platforms
-kalibr deploy myapp.py --runtime fly.io
+# Check connection status
+kalibr status
 
-# Fetch trace capsule by ID
-kalibr capsule <trace-id>
+# Package for deployment
+kalibr package
 
-# Show version
-kalibr version
+# Update schemas
+kalibr update_schemas
 ```
 
 ## Supported Providers

{kalibr-1.2.0 → kalibr-1.2.2}/README.md

@@ -120,6 +120,41 @@ policy = get_policy(
 )
 ```
 
+### Intelligent Routing with decide()
+
+Register execution paths and let Kalibr decide the best strategy:
+
+```python
+from kalibr import register_path, decide
+
+# Register available paths
+register_path(goal="book_meeting", model_id="gpt-4o", tool_id="calendar_api")
+register_path(goal="book_meeting", model_id="claude-3-sonnet")
+
+# Get intelligent routing decision
+decision = decide(goal="book_meeting")
+model = decision["model_id"]       # Selected based on outcomes
+tool = decision.get("tool_id")     # If tool routing enabled
+print(decision["exploration"])     # True if exploring new paths
+```
+
+### Goal Context
+
+Tag traces with goals for outcome tracking:
+
+```python
+from kalibr import goal, set_goal, get_goal, clear_goal
+
+# Context manager (recommended)
+with goal("book_meeting"):
+    response = openai.chat.completions.create(...)
+
+# Or manual control
+set_goal("book_meeting")
+response = openai.chat.completions.create(...)
+clear_goal()
+```
+
 ## TraceCapsule - Cross-Agent Tracing
 
 Propagate trace context across agent boundaries:
@@ -217,7 +252,7 @@ Configure via environment variables:
 | `KALIBR_API_KEY` | API key for authentication | *Required* |
 | `KALIBR_TENANT_ID` | Tenant identifier | `default` |
 | `KALIBR_COLLECTOR_URL` | Collector endpoint URL | `https://api.kalibr.systems/api/ingest` |
-| `KALIBR_INTELLIGENCE_URL` | Intelligence API URL | `https://kalibr-intelligence.fly.dev` |
+| `KALIBR_INTELLIGENCE_URL` | Intelligence API URL | `https://dashboard.kalibr.systems/intelligence` |
 | `KALIBR_SERVICE_NAME` | Service name for spans | `kalibr-app` |
 | `KALIBR_ENVIRONMENT` | Environment (prod/staging/dev) | `prod` |
 | `KALIBR_WORKFLOW_ID` | Workflow identifier | `default` |
@@ -226,20 +261,20 @@ Configure via environment variables:
 ## CLI Commands
 
 ```bash
-# Serve your app with tracing
-kalibr serve myapp.py
+# Show version
+kalibr version
 
-# Run with managed runtime
-kalibr run myapp.py --port 8000
+# Validate configuration
+kalibr validate
 
-# Deploy to cloud platforms
-kalibr deploy myapp.py --runtime fly.io
+# Check connection status
+kalibr status
 
-# Fetch trace capsule by ID
-kalibr capsule <trace-id>
+# Package for deployment
+kalibr package
 
-# Show version
-kalibr version
+# Update schemas
+kalibr update_schemas
 ```
 
 ## Supported Providers

{kalibr-1.2.0 → kalibr-1.2.2}/kalibr/__init__.py

@@ -56,7 +56,17 @@ from .collector import is_configured as is_collector_configured
 from .collector import (
     setup_collector,
 )
-from .context import get_parent_span_id, get_trace_id, new_trace_id, trace_context
+from .context import (
+    get_parent_span_id,
+    get_trace_id,
+    new_trace_id,
+    trace_context,
+    # Goal context (v1.3.0)
+    goal,
+    set_goal,
+    get_goal,
+    clear_goal,
+)
 from .cost_adapter import (
     AnthropicCostAdapter,
     BaseCostAdapter,
@@ -79,6 +89,8 @@ from .intelligence import (
     get_policy,
     report_outcome,
     get_recommendation,
+    register_path,
+    decide,
 )
 
 if os.getenv("KALIBR_AUTO_INSTRUMENT", "true").lower() == "true":
@@ -114,6 +126,11 @@ __all__ = [
     "get_trace_id",
     "get_parent_span_id",
     "new_trace_id",
+    # Goal Context (v1.3.0)
+    "goal",
+    "set_goal",
+    "get_goal",
+    "clear_goal",
     # Tracer
     "Tracer",
     "SpanContext",
@@ -144,4 +161,6 @@ __all__ = [
     "get_policy",
     "report_outcome",
     "get_recommendation",
+    "register_path",
+    "decide",
 ]

{kalibr-1.2.0 → kalibr-1.2.2}/kalibr/context.py

@@ -8,6 +8,7 @@ HTTP requests to SDK calls (OpenAI, Anthropic, Google).
 import random
 import string
 import uuid
+from contextlib import contextmanager
 from contextvars import ContextVar
 from typing import Dict, Optional
 
@@ -130,3 +131,44 @@ def inject_kalibr_context_into_span(span: Span):
             span.set_attribute("kalibr.http_trace_id", ctx["trace_id"])
         if ctx.get("span_id"):
             span.set_attribute("kalibr.http_span_id", ctx["span_id"])
+
+
+# ============================================================================
+# Goal Context for Outcome Tracking (v1.3.0)
+# ============================================================================
+
+_goal_context: ContextVar[Optional[str]] = ContextVar("goal_context", default=None)
+
+
+def set_goal(goal: str):
+    """Set the current goal for all subsequent Kalibr traces."""
+    _goal_context.set(goal)
+
+
+def get_goal() -> Optional[str]:
+    """Get the current goal."""
+    return _goal_context.get()
+
+
+def clear_goal():
+    """Clear the current goal."""
+    _goal_context.set(None)
+
+
+@contextmanager
+def goal(goal_name: str):
+    """Context manager to set goal for a block of code.
+
+    Usage:
+        with kalibr.goal("research_company"):
+            agent.run("Research Weights & Biases")
+    """
+    previous = get_goal()
+    set_goal(goal_name)
+    try:
+        yield
+    finally:
+        if previous:
+            set_goal(previous)
+        else:
+            clear_goal()