v0.6.1 - April 9, 2026

Improvements

• auto_instrument now uses BatchSpanProcessor by default, enabling asynchronous span export in a background thread. This significantly reduces response time overhead under concurrent workloads compared to the previous synchronous SimpleSpanProcessor.

What's New

• auto_instrument accepts a new disable_batch parameter (default False). Pass disable_batch=True to use synchronous span export, which may be preferable in short-lived scripts or test environments where the process may exit before the batch is flushed.

Resolves #40

v0.6.0 - April 8, 2026

What's New

• Local mode for sap_cloud_sdk.destination — run destination operations without SAP BTP connectivity during local development
• Place mocks/destination.json, mocks/fragments.json, or mocks/certificates.json at the repo root; create_client(), create_fragment_client(), and create_certificate_client() automatically return a local client when the corresponding file is detected
• LocalDevDestinationClient, LocalDevFragmentClient, and LocalDevCertificateClient support full CRUD (get, list, create, update, delete) at both service-instance and subaccount level
• Tenant-scoped entries and all four AccessStrategy values (SUBSCRIBER_ONLY, PROVIDER_ONLY, SUBSCRIBER_FIRST, PROVIDER_FIRST) are fully supported
• A WARNING is logged on every local-client creation to prevent accidental use in production

Contributors

• Application Foundation Toolkit Libraries Team

v0.5.0 - April 3, 2026

What's New

• New sap_cloud_sdk.ias module for working with SAP Identity Authentication Service
• parse_token() decodes IAS JWT tokens (no signature verification) into a typed IASClaims dataclass
• All 25 standard IAS claims mapped as named fields, including user_uuid (global user ID) and app_tid (tenant ID)
• Unrecognized claims collected in custom_attributes
• IASTokenError raised on malformed tokens; absent claims are None rather than errors

Contributors

• Application Foundation Toolkit Libraries Team

v0.4.0 - March 31, 2026

Breaking Changes

• ObjectStore: Removed implicit audit logging - All object store operations (upload, download, delete, list, etc.) no longer automatically log audit events.

Migration Guide

If your application requires audit logging for object store operations, you must now implement it explicitly:

from sap_cloud_sdk.objectstore import create_client
from sap_cloud_sdk.core.auditlog import create_client as create_audit_client, DataModificationEvent

# Create clients
store_client = create_client("my-instance")
audit_client = create_audit_client()

# Upload with explicit audit logging
store_client.put_object_from_bytes("file.txt", b"data", "text/plain")
audit_client.log(DataModificationEvent(
    object_type="s3-object",
    object_id={"bucket": "my-bucket", "key": "file.txt"},
    # ... other audit event details
))

What Changed

• Removed implicit audit log calls from all ObjectStore operations
• Removed audit log client initialization and helper methods from ObjectStore

Contributors

• Application Foundation Toolkit Libraries Team

v0.3.2 - March 31, 2026

What Changed

• Changed adoption metrics aggregation temporality to DELTA for less memory overhead and compatibility with BTP metering systems.

Contributors

• Application Foundation Toolkit Libraries Team

v0.3.1 - March 27, 2026

Bug Fixes

• Fixed set_aicore_config() not passing instance_name to all _get_secret() calls. Previously, only _get_aicore_base_url() received the custom instance name, while clientid, clientsecret, url, and AICORE_RESOURCE_GROUP always resolved from the default aicore-instance path.

Contributors

• Application Foundation Toolkit Libraries Team

v0.3.0 - March 27, 2026

What's New

• Enabled OTLP HTTP exporter via OTel-native OTEL_EXPORTER_OTLP_PROTOCOL="http/protobuf"
• Enabled BaggageSpanProcessor out-of-the-box for automatic W3C baggage injection in span attributes. SDK does not push to or manage the baggage header, it still depends on the underlying OTel instrumentation.

Contributors

• Application Foundation Toolkit Libraries Team
• hope hope.leong@sap.com

v0.2.0 - March 24, 2026

What's New

• Enabled console tracing through the OTel-native environment variable OTEL_TRACES_EXPORTER="console"
• Enabled parent-to-child attribute propagation in context overlays through the propagate parameter, which defaults to False
• Added gen_ai.operation.name to span attributes when using context_overlay()

What Changed

• Pinned runtime dependency versions, limiting automatic updates to the patch version in order to avoid breaking changes.

Contributors

• Application Foundation Toolkit Libraries Team

v0.1.1 - March 19, 2026

What's New

Bug Fixes

Pinned traceloop-sdk version (>=0.52.0,<0.53.0) due to a bug introduced in 0.53.0 that breaks the instrumentation of LangChain.

What Changed

Renamed cloud_sdk telemetry attributes

sap.telemetry.sdk.name -> sap.cloud_sdk.name
sap.telemetry.sdk.language -> sap.cloud_sdk.language
sap.telemetry.sdk.version -> sap.cloud_sdk.version

Contributors

• Application Foundation Toolkit Libraries Team

v0.1.0 - March 16, 2026

What's New

• 🎉 Initial Release of SAP Cloud SDK for Python - Complete SDK providing consistent, type-safe interfaces for interacting with SAP services, following Python best practices while maintaining compatibility with the BTP ecosystem.

• 🤖 AI Core Configuration Module - Reads and configure secrets so they are available to the LiteLLM library.

• 📋 Audit Log Service Module - Comprehensive compliance audit logging for SAP Audit Log Service with support for 6 event types:

  • Security Events (authentication, authorization)
  • Data Access Events (GDPR compliance for data reading)
  • Data Modification Events (tracking data changes with old/new values)
  • Data Deletion Events (specialized for data removal tracking)
  • Configuration Change Events (system configuration changes)
  • Configuration Deletion Events (configuration removal tracking)
  • Unified logging interface with type-safe dataclass patterns
  • Custom attributes and details support for enhanced context

• 🌐 Destination Service Module - Complete SAP BTP Destination Service integration featuring:

  • Full V1 Admin API support (CRUD operations for destinations, fragments, certificates)
  • V2 Runtime API with automatic token retrieval and refresh
  • Multi-level access (Service Instance and Subaccount levels)
  • Transparent Proxy support for on-premise connectivity
  • Certificate management with multiple format support (PEM, JKS, P12)
  • Fragment-based configuration merging
  • Pagination support for listing operations

• 🗂️ ObjectStore Service Module - S3-compatible object storage with comprehensive functionality:

  • Multiple upload methods (from bytes, file, stream)
  • Object retrieval with streaming support
  • Object existence checking and metadata inspection
  • Object listing
  • Idempotent delete operations
  • Context manager support
  • SSL configuration options

• 🔐 Secret Resolver Module - Secure credential management with hierarchical resolution:

  • Kubernetes-mounted secrets support (/etc/secrets/appfnd///)
  • Environment variable fallback (_)
  • Type-safe configuration using dataclasses
  • Multi-instance support for complex deployments
  • Handling of missing secrets with default values
  • Automatic hyphen-to-underscore conversion for environment variables

• 📊 Telemetry & Observability Module - OpenTelemetry tracing with GenAI specialization:

  • Auto-instrumentation for AI frameworks (LiteLLM, OpenAI, and more)
  • 8 GenAI-specific operations (Chat, Text Completion, Embeddings, Content Generation, Retrieval, Tool Execution, Agent Creation/Invocation)
  • Custom span creation with attributes and events
  • GenAI-specific spans following OpenTelemetry conventions
  • Thread-safe and async-safe tenant ID tracking
  • Nested span support for complex workflows
  • Custom metrics with provider and operation categorization

• 📋 Documentation & Resources

  • Each module includes comprehensive documentation with examples
  • Development setup and contribution guidelines
  • Best practices for credential management and secure usage

Bug Fixes

This is the initial release, so no bug fixes are applicable.

Breaking Changes

This is the initial release, so no breaking changes apply. Future releases will follow semantic versioning with clear migration guides for any breaking changes.

Contributors

Application Foundation Toolkit Libraries Team