Python SDK Changelog

This page documents the release history of the Agentuity Python SDK.

v0.0.105

Changes:

• Fixed: Fixed issue with session_id formatting in OpenTelemetry tracing to ensure proper string conversion

v0.0.104

⚠️ Breaking Changes:

• AgentContext constructor parameter renamed from run_id to session_id for better alignment with session references. The runId property remains available for backward compatibility but is deprecated.

Changed:

• Switch from OpenLIT to TraceLoop SDK for OpenTelemetry instrumentation to improve async context management

Fixed:

• Resolved "context attached/detached in a different context" warnings in async environments, particularly with LangChain instrumentation

v0.0.103

Added:

• Telegram IO support with comprehensive Telegram integration capabilities
• New Telegram API module for Telegram-specific operations and utilities
• Telegram data processing support in the data layer for handling Telegram-specific content types

Changed:

• Updated agent directory structure to prefer agentuity_agents over agentuity-agents for improved Python compatibility

v0.0.102

Changes:

• Added: Enable the ability to use custom email domains for email replies

v0.0.101

Changes:

• Fixed: DevMode: make sure certain props are set on metadata for improved development mode debugging

v0.0.100 ⚠️

Changes:

• Changed: Shortened Discord interface method name from discord_message() to discord() for improved usability

⚠️ Breaking Changes

The Discord interface method has been renamed from discord_message() to discord(). Update your code to use the new method name:

- message = await req.data.discord_message()
+ message = await req.data.discord()

v0.0.98

Changes:

• Fixed: Email: text and html should return a str not a list of str to match JS behavior

v0.0.97

Changes:

• Fixed: Filter out empty headers from headers special HTTP header

v0.0.96

Changes:

• Added: Enhanced ObjectStorePutParams with additional headers and metadata support
• Fixed: Fixed difference in HTTP header casing and other cleanup items

v0.0.95

Changes:

• Added: ObjectStore service with comprehensive object storage capabilities including get, put, delete, and public URL generation

v0.0.94

Changes:

• Fixed: Fixed naming conflict with openAI Agents SDK by renaming agents directory to agentuity-agents with backward compatibility
• Fixed: Removed ruff from runtime dependencies as it's only needed for development

v0.0.93

Changes:

• Fixed: Improved route handling for extra path segments and better 404 error messages
• Fixed: Enhanced logging to display actual HTTP method and full request path
• Fixed: Simplified health check response headers and consolidated route registration

v0.0.92

Changes:

• Added: Email class support for large attachments and send reply functionality
• Added: Structured interfaces for agent requests, context, data, and email processing with streaming and async capabilities
• Added: Ability to send reply emails with attachments and telemetry support
• Changed: Standardized naming conventions for content type attributes across the application
• Changed: Enhanced encapsulation and interface compliance for agent context, data, and request objects
• Changed: Deprecated legacy property names in favor of new, consistent ones, with warnings for backward compatibility
• Fixed: Added OpenTelemetry tracing headers to HTTP requests for improved observability
• Fixed: Corrected attribute names in tests and code to ensure consistent access to content type properties

v0.0.91

Changes:

• Added: LlamaIndex instrumentation for automatic Agentuity gateway integration
• Added: LlamaIndex now automatically uses Agentuity API key and gateway when no OpenAI API key is provided
• Added: OpenAI client patching within LlamaIndex for seamless Agentuity integration

v0.0.90

Changes:

• Fixed: Apply safe filename fix similar to CLI and always prefer to load config but fallback to yaml in dev

v0.0.89

Changes:

• Fixed: Fix outgoing requests missing traceid in OpenTelemetry instrumentation

v0.0.88

Changes:

• Added: Agent startup checks with stack trace printing in development mode
• Fixed: Fixed issue with OTel trace id not getting propagated correctly and causing it not to be associated with the correct session in production

v0.0.87

Changes:

• Fixed: Fixed handoff issues by implementing deferred handoff execution with improved error handling and agent communication
• Fixed: Added configurable HTTP timeouts for agent communication
• Fixed: Improved connection error handling for client disconnections during streaming

v0.0.86

Changes:

• Added: Email class for parsing inbound email messages with support for extracting subject, sender, recipients, and attachments
• Added: Async email() method to Data class for parsing RFC822 email content
• Added: mail-parser dependency for email parsing functionality
• Changed: Updated AgentResponse.handoff() to accept DataLike types instead of only dict for improved flexibility
• Changed: Enhanced JSON serialization in AgentResponse.json() with better error handling and fallback for objects with dict
• Fixed: Fixed duplicate variable assignment in RemoteAgent.run() method

v0.0.85

Added:

• Added support for constructing data objects from both synchronous and asynchronous byte iterators (#45)
• Added synchronous reading methods for data objects (#45)

Changed:

• Improved local development instructions in README (#44)
• Enhanced agent input handling to accept a broader range of data types (#45)
• Configured explicit timeout settings for agent network operations (#45)

Fixed:

• Improved data conversion logic to handle a wider range of input types (#45)

v0.0.84 ⚠️

Added:

• Added AGENTUITY_SDK_KEY (#42)

⚠️ Breaking Changes

The environment variable for API authentication has changed from AGENTUITY_API_KEY to AGENTUITY_SDK_KEY. You will need to update any references to this environment variable in your code and deployment configurations.

For example, the following changes are required:

- os.environ["AGENTUITY_API_KEY"] = "your-api-key"
+ os.environ["AGENTUITY_SDK_KEY"] = "your-api-key"

When using the Agentuity CLI, it will detect this change and ask if you would like assistance migrating your code automatically.

If you're using an Agentic code editor (such as Cursor, Windsurf, etc.), you can use this prompt to update your code with these changes:

The Agentuity SDK v0.0.115 has renamed AGENTUITY_API_KEY to AGENTUITY_SDK_KEY.
Please find all instances of AGENTUITY_API_KEY in my code and replace them with AGENTUITY_SDK_KEY.

v0.0.83

Fixed:

• Fix issue vectors, better typing for Vector and KeyValue in context (#40)

v0.0.82 ⚠️

Changes:

• Add support for streaming data to and from agents. This includes streaming data to the agent via the data object and streaming data from the agent via the stream property of the AgentResponse object.
• The trigger property of the AgentRequest object will have the value agent when the request is invoked by another agent.
• The AgentContext object now has a scope property that will have the value of local when the context is local or remote when agent is being invoked by another agent remotely. In the case of agent-to-agent invocation or handoff within the same project, the scope will be local.
• Deprecated the local /run/:agentId route since the updated /:agentId route now supports streaming data to and from the agent directly. This route will be removed in a near future release.

⚠️ Breaking Changes

The data object of AgentRequest has changed to support fully streaming data and this required a breaking change. Most of the property accessors are now async functions to support the streaming use case. You can read more about this change in Pull Request #38.

For example, the following code changes are required to get the request data as text:

- text = req.data.text;
+ text = await req.data.text();

For example, to get the request data as JSON, you need to make the following changes:

- json = req.data.json;
+ json = await req.data.json();

See the following documentation Pull Request for specific SDK changes.

If you're using an Agentic code editor (such as Cursor, Windsurf, etc.), you can use this prompt to update your code with these changes:

The agents in the agents folder use an older version of the Agentuity SDK which assume the req.data object has properties on it like req.data.json

The new way to do this is with a promise. eg. `await req.data.json()`

The breaking change is here:  https://github.com/agentuity/sdk-py/pull/38

Review this PR, make a plan to change the agents to the latest agentuity SDK with async await support, and execute on it.

v0.0.77

Added:

• Add comprehensive test suite with pytest (#27)
• Expand test coverage for logger, context, and langchain instrumentation (#28)
• Add agent inspect endpoint support (#29)

v0.0.76

Fixed:

• Fix Langchain instrumentation and add openai-agents dependency (#24)

v0.0.75

Added:

• Add data and markdown methods to AgentResponse class (#26)
• Add PyPI release workflow (#22)

Changed:

• Update logo URL from relative to absolute path (#19)
• Remove 'work in progress' warning from README (#20)
• Update Agentuity gateway URL from /llm/ to /gateway/ (#21)
• Update to use AGENTUITY_CLOUD_PORT with fallback to PORT (#23)
• Use transport instead of API for hosted SDK api (#25)
• Update CHANGELOG.md for v0.0.74 (#18)

v0.0.74

Added:

• Better support for OpenAI and Agents framework (#16)
• Add agentName to logger (#17)

v0.0.73

Fixed:

• Fix issue with non-stream functionality (#15)

v0.0.72

Added:

• Add the @agentuity/agentId to the context.logger for an agent (#13)

Fixed:

• Fix import issue and add ruff for formatting and linting (#14)

v0.0.71

Added:

• SSE and Stream support with new stream() method and improved documentation (#12)

v0.0.70

Added:

• Stream IO Input: add new facility to support stream io for input data (#10)

v0.0.69

Changes:

• Implemented Vector and KeyValue services
• Reorganized types into logical files
• Added support for local handoff
• Improved error handling
• Added support for dynamic return types
• Added get_agents method on context
• Moved autostart into main package
• Added tracing for remote agent calls
• Added httpx dependency for improved HTTP client support