Google Antigravity Python SDK — v0.1.5 Release Notes

[karmel]

The v0.1.5 release of the Google Antigravity Python SDK introduces native OpenTelemetry tracing support, declarative subagent configurations, improved type safety, and critical robustness and compatibility updates.

🌟 Key Highlights

• OpenTelemetry Tracing Support: Integrates OpenTelemetry tracing into the SDK to translate session, turn, step, and tool lifecycle events into standard GenAI-compliant semantic spans for advanced monitoring and performance debugging.
• Declarative Subagent Configurations: Adds support for configuring static subagents with custom instructions and tools directly using the new SubagentConfig and SubagentCapabilities classes.

---

📋 Detailed Changes

Features & Enhancements

• OpenTelemetry Tracing: Implemented OpenTelemetry tracing support for SDK lifecycle events conforming to GenAI Semantic Conventions, with custom task-safe active span propagation for tool execution. (@karmel)
• Declarative Subagent Configurations: Added SubagentConfig and SubagentCapabilities in types.py to support constructing static subagents with declarative instructions and tools. (@karmel)

Robustness & Usability

• Type Safety in AgentConfig: Type-annotated policies, hooks, and triggers parameters on AgentConfig and its subclasses to improve type safety and the overall developer experience. (@NTaylorMullen)
• Lifecycle Hook Routing: Shifted core orchestration of OnSessionStartHook, turn-level hooks (PRE_TURN and POST_TURN), and OnSessionEndHook to the connection layer, implementing the Python-side HookRouter for event routing. (@abhipatel12 )
• Public API Cleanup: Hid internal validation methods on media and error classes by prefixing them with an underscore (e.g., _validate_mime_type and _from_pydantic on validation errors). (@NTaylorMullen)

Bug Fixes

• Historical Step Absorption: Ensured historical step absorption is properly drained during initialization to prevent persistence non-linearity issues in Conversation. (@abhipatel12 )
• Python 3.14 Compatibility: Resolved potential name shadowing in the Conversation class by renaming the top-level connection module import. (@alekandreev)