feat(harness): instrument Anthropic streaming usage and tool calls

cascadeflow/__init__.py

@@ -239,6 +239,21 @@
     get_tool_risk_routing,
 )
 
+# NEW: Harness API scaffold (V2 core branch)
+from .harness import (
+    HarnessConfig,
+    HarnessInitReport,
+    HarnessRunContext,
+    init,
+    reset,
+    run,
+    agent as harness_agent,
+    get_harness_config,
+    get_current_run,
+    get_harness_callback_manager,
+    set_harness_callback_manager,
+)
+
 # ==================== MAIN AGENT & RESULT ====================
 
 
@@ -381,6 +396,18 @@
     "ToolRiskClassification",  # NEW: v0.8.0 - Classification result
     "ToolRiskClassifier",  # NEW: v0.8.0 - Tool risk classifier
     "get_tool_risk_routing",  # NEW: v0.8.0 - Routing by risk level
+    # ===== HARNESS API (V2 scaffold) =====
+    "HarnessConfig",
+    "HarnessInitReport",
+    "HarnessRunContext",
+    "init",
+    "reset",
+    "run",
+    "harness_agent",
+    "get_harness_config",
+    "get_current_run",
+    "get_harness_callback_manager",
+    "set_harness_callback_manager",
     # ===== PROVIDERS =====
     "ModelResponse",
     "BaseProvider",

cascadeflow/harness/__init__.py

@@ -0,0 +1,38 @@
+"""
+Core harness API scaffold for V2 planning work.
+
+This module provides a minimal, backward-compatible surface:
+- init(): global harness settings (opt-in)
+- run(): scoped run context for budget/trace accounting
+- agent(): decorator for attaching policy metadata
+
+The implementation intentionally avoids modifying existing CascadeAgent behavior.
+"""
+
+from .api import (
+    HarnessConfig,
+    HarnessInitReport,
+    HarnessRunContext,
+    agent,
+    get_harness_callback_manager,
+    get_current_run,
+    get_harness_config,
+    init,
+    reset,
+    run,
+    set_harness_callback_manager,
+)
+
+__all__ = [
+    "HarnessConfig",
+    "HarnessInitReport",
+    "HarnessRunContext",
+    "init",
+    "run",
+    "agent",
+    "get_current_run",
+    "get_harness_callback_manager",
+    "get_harness_config",
+    "set_harness_callback_manager",
+    "reset",
+]