feat(extensibility): add extensibility module (#102)

Co-authored-by: Max Heidinger <max.heidinger@sap.com>
Co-authored-by: Udit Marolia <udit.marolia@sap.com>
Co-authored-by: Gregor Hollmig <gregor.hollmig@sap.com>
Co-authored-by: Sophia Abiezzi <sophia.abiezzi@sap.com>
Co-authored-by: Rishi Kunnath <rishi.kunnath@sap.com>
Co-authored-by: Lucas Vianna <lucas.vianna@sap.com>
Co-authored-by: Gabriel Silva <gabriel.silva02@sap.com>
Co-authored-by: Arup Sengupta <arup.sengupta@sap.com>
Co-authored-by: Tiago Kochenborger <tiago.kochenborger@sap.com>

Author: 10 people

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sap-cloud-sdk"
-version = "0.17.0"
+version = "0.18.0"
 description = "SAP Cloud SDK for Python"
 readme = "README.md"
 license = "Apache-2.0"
@@ -35,6 +35,7 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
+extensibility = ["a2a-sdk>=0.2.0"]
 starlette = ["starlette>=0.40.0"]
 langchain = ["langchain-core>=1.2.7"]
 
@@ -49,6 +50,7 @@ packages = ["src/sap_cloud_sdk", "src/buf"]
 dev = [
     "pytest>=8.4.2",
     "pytest-cov>=7.0.0",
+    "pytest-asyncio>=1.0.0",
     "pytest-bdd>=7.2.0",
     "python-dotenv>=1.0.0",
     "ty>=0.0.21",
@@ -57,8 +59,8 @@ dev = [
     "starlette>=0.40.0",
     "anyio>=3.6.2",
     "httpx>=0.27.0",
+    "a2a-sdk>=0.2.0",
     "langchain-core>=1.2.7",
-    "pytest-asyncio>=1.0.0",
 ]
 
 [tool.pytest.ini_options]

src/sap_cloud_sdk/core/telemetry/__init__.py

@@ -24,6 +24,37 @@
     execute_tool_span,
     invoke_agent_span,
 )
+from sap_cloud_sdk.core.telemetry.extensions import (
+    extension_context,
+    get_extension_context,
+    ExtensionType,
+    ATTR_IS_EXTENSION,
+    ATTR_EXTENSION_TYPE,
+    ATTR_CAPABILITY_ID,
+    ATTR_EXTENSION_ID,
+    ATTR_EXTENSION_NAME,
+    ATTR_EXTENSION_VERSION,
+    ATTR_EXTENSION_ITEM_NAME,
+    ATTR_EXTENSION_URL,
+    ATTR_SOLUTION_ID,
+    ATTR_SUMMARY_TOTAL_OPERATION_COUNT,
+    ATTR_SUMMARY_TOTAL_DURATION_MS,
+    ATTR_SUMMARY_TOOL_CALL_COUNT,
+    ATTR_SUMMARY_HOOK_CALL_COUNT,
+    ATTR_SUMMARY_HAS_INSTRUCTION,
+    resolve_source_info,
+    build_extension_span_attributes,
+    reset_tool_call_metrics,
+    get_tool_call_metrics,
+    record_tool_call_duration,
+    reset_hook_call_metrics,
+    get_hook_call_metrics,
+    record_hook_call_duration,
+    call_extension_tool,
+    call_extension_hook,
+    emit_extensions_summary_span,
+    ExtensionContextLogFilter,
+)
 from sap_cloud_sdk.core.telemetry.middleware import TelemetryMiddleware
 
 __all__ = [
@@ -42,6 +73,35 @@
     "chat_span",
     "execute_tool_span",
     "invoke_agent_span",
+    "extension_context",
+    "get_extension_context",
+    "ExtensionType",
+    "ATTR_IS_EXTENSION",
+    "ATTR_EXTENSION_TYPE",
+    "ATTR_CAPABILITY_ID",
+    "ATTR_EXTENSION_ID",
+    "ATTR_EXTENSION_NAME",
+    "ATTR_EXTENSION_VERSION",
+    "ATTR_EXTENSION_ITEM_NAME",
+    "ATTR_EXTENSION_URL",
+    "ATTR_SOLUTION_ID",
+    "ATTR_SUMMARY_TOTAL_OPERATION_COUNT",
+    "ATTR_SUMMARY_TOTAL_DURATION_MS",
+    "ATTR_SUMMARY_TOOL_CALL_COUNT",
+    "ATTR_SUMMARY_HOOK_CALL_COUNT",
+    "ATTR_SUMMARY_HAS_INSTRUCTION",
+    "resolve_source_info",
+    "build_extension_span_attributes",
+    "reset_tool_call_metrics",
+    "get_tool_call_metrics",
+    "record_tool_call_duration",
+    "reset_hook_call_metrics",
+    "get_hook_call_metrics",
+    "record_hook_call_duration",
+    "call_extension_tool",
+    "call_extension_hook",
+    "emit_extensions_summary_span",
+    "ExtensionContextLogFilter",
     "TelemetryMiddleware",
 ]