feat(tracing): infer error ownership from tracebacks

Add configurable frame ownership rules and safe provenance so uncategorized span failures can be attributed without inspecting exception text.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: jshaikScale

src/agentex/lib/core/tracing/__init__.py

@@ -2,10 +2,19 @@
 from agentex.lib.core.tracing.trace import Trace, AsyncTrace
 from agentex.lib.core.tracing.tracer import Tracer, AsyncTracer
 from agentex.lib.core.tracing.span_error import (
+    ERROR_CLASSIFIER_VERSION,
+    DEFAULT_ERROR_CLASSIFIER_CONFIG,
+    DEFAULT_TRACEBACK_OWNERSHIP_CONFIG,
+    ErrorBoundary,
     ErrorCategory,
     PlatformError,
     ApplicationError,
     CategorizedError,
+    ExceptionMapping,
+    ErrorClassification,
+    ErrorClassifierConfig,
+    TracebackOwnershipConfig,
+    classify_error,
 )
 from agentex.lib.core.tracing.span_queue import (
     AsyncSpanQueue,
@@ -23,6 +32,15 @@
     "ApplicationError",
     "PlatformError",
     "ErrorCategory",
+    "ErrorBoundary",
+    "ExceptionMapping",
+    "ErrorClassification",
+    "ErrorClassifierConfig",
+    "TracebackOwnershipConfig",
+    "ERROR_CLASSIFIER_VERSION",
+    "DEFAULT_ERROR_CLASSIFIER_CONFIG",
+    "DEFAULT_TRACEBACK_OWNERSHIP_CONFIG",
+    "classify_error",
     "AsyncSpanQueue",
     "get_default_span_queue",
     "shutdown_default_span_queue",

src/agentex/lib/core/tracing/processors/sgp_tracing_processor.py

@@ -88,6 +88,10 @@ def _build_sgp_span(span: Span, env_vars: EnvironmentVariables) -> SGPSpan:
     if error is not None:
         sgp_span.set_error(error_type=error["type"], error_message=error["message"])
         sgp_span.metadata["error_category"] = error.get("category", "unknown")
+        sgp_span.metadata["error_category_source"] = error.get("category_source", "legacy")
+        sgp_span.metadata["error_classifier_version"] = error.get("classifier_version", "legacy")
+        if "category_reason" in error:
+            sgp_span.metadata["error_category_reason"] = error["category_reason"]
     return sgp_span