Changelog

Version history and release notes for the SignalWire Agents SDK.

Version History

Version	Date	Type	Highlights
1.0.15	2025	Feature	Add WebRTC calling to sw-agent-dokku and fix route handling
1.0.14	2025	Feature	Add WebRTC calling support to sw-agent-dokku generated apps
1.0.13	2025	Feature	Add sw-agent-dokku CLI for Dokku deployments and fix AgentServer health endpoints
1.0.12	2025	Feature	Export SkillBase from skills package for easier custom skill development
1.0.11	2025	Feature	Add mcp-gateway CLI command and cloud function support in sw-agent-init
1.0.10	2025	Patch	Fix Google Cloud Functions /swaig endpoint and URL detection
1.0.9	2025	Patch	Fix Lambda and Azure Functions serverless handlers
1.0.8	2025	Patch	Version bump release
1.0.7	2025	Feature	New sw-agent-init CLI tool for project scaffolding
1.0.6	2025	Patch	Fix circular copy issue in contexts
1.0.5	2025	Release	Version bump release
1.0.4	2025	Feature	Call flow verb insertion API for SWML customization
1.0.3	2025	Patch	SWML schema updates for queues and context switching
1.0.2	2025	Patch	Added serve_static_files() to AgentServer
1.0.1	2025	Patch	Minor fixes to included examples
1.0.0	2025	Initial	First public release

Version 1.0.15

Bug Fix Release

Fixes route handling in AgentServer to prevent catch-all routes from overshadowing custom routes.

Changes

Area	Change
AgentServer	Move catch-all handler registration to startup event
AgentServer	Custom routes like `/get_token` now work correctly with gunicorn
sw-agent-dokku	Update GitHub Actions to use reusable workflows
sw-agent-dokku	Improved WebRTC client with robust pattern
sw-agent-dokku	Always update SWML handler URL on startup

Version 1.0.14

Feature Release

Adds WebRTC calling support to sw-agent-dokku generated applications, allowing browser-based calls.

Changes

Area	Change
sw-agent-dokku	Add WebRTC calling support to generated web interface
sw-agent-dokku	Add `/get_token` endpoint for guest token generation
sw-agent-dokku	Add `/get_credentials` endpoint for curl examples
sw-agent-dokku	Add `/get_resource_info` endpoint for dashboard links
sw-agent-dokku	Auto-create SWML handler in SignalWire on startup
sw-agent-dokku	Add SignalWire credentials to environment templates

Version 1.0.13

Feature Release

Adds sw-agent-dokku CLI for deploying SignalWire agents to Dokku servers, and fixes AgentServer health endpoints to work with gunicorn.

Changes

Area	Change
CLI	Added `sw-agent-dokku` CLI for Dokku deployments
sw-agent-dokku	Supports simple git push deploys or GitHub Actions CI/CD
sw-agent-dokku	Generates Procfile, CHECKS, requirements.txt for Dokku
sw-agent-dokku	Optional web interface with static file serving
sw-agent-dokku	Preview environments for pull requests
AgentServer	Register `/health` and `/ready` endpoints in `__init__`
AgentServer	Health endpoints now work with gunicorn (not just `server.run()`)

Version 1.0.12

Feature Release

Exports SkillBase from the skills package for more convenient custom skill development.

Changes

Area	Change
Skills	Export `SkillBase` from `signalwire_agents.skills` for convenience
Skills	Can now import as `from signalwire_agents.skills import SkillBase`

Version 1.0.11

Feature Release

Added mcp-gateway CLI command for running MCP Gateway servers and enhanced sw-agent-init with cloud function deployment support.

Changes

Area	Change
CLI	Added `mcp-gateway` CLI command to run MCP Gateway servers
sw-agent-init	Added `--platform` option to generate cloud function deployments (aws, gcp, azure)
sw-agent-init	Added `--region` option to specify deployment region
sw-agent-init	Fixed generated `app.py` to be compatible with `swaig-test`
sw-agent-init	Updated requirements template to use signalwire-agents>=1.0.10

Version 1.0.10

Patch Release

Fixed Google Cloud Functions serverless handler to match Lambda and Azure improvements.

Changes

Area	Change
Google Cloud Functions	Added `/swaig` endpoint support with function name in request body
Google Cloud Functions	Added URL detection for correct webhook URL generation in SWML
Google Cloud Functions	Fixed serverless mode handling in `run()` method
Auth	Simplified header access using case-insensitive `.get()` method
Serverless	Improved error logging with full traceback

Version 1.0.9

Patch Release

Fixed serverless handler issues for AWS Lambda and Azure Functions deployments.

Changes

Area	Change
Lambda	Fixed `/swaig` endpoint support - function name now correctly read from request body
Lambda	Added support for HTTP API v2 payload format (`rawPath`) in addition to REST API v1 (`pathParameters.proxy`)
Lambda	Fixed base64-encoded body handling
Azure Functions	Fixed URL detection for correct webhook URL generation in SWML
Azure Functions	Added `/swaig` endpoint support with function name in request body
Serverless	Improved request body parsing consistency across all serverless platforms

Version 1.0.8

Patch Release

Version bump release with no functional changes from 1.0.7.

Version 1.0.7

Feature Release

Added the sw-agent-init CLI tool for scaffolding new SignalWire agent projects.

Changes

Area	Change
CLI	Added `sw-agent-init` interactive project generator
CLI	Supports basic and full project templates
CLI	Auto-detects SignalWire credentials from environment
CLI	Optional virtual environment creation
CLI	Generates test scaffolding with pytest

Version 1.0.6

Patch Release

Fixed a circular reference issue when copying agents with contexts.

Changes

Area	Change
AgentBase	Fixed circular copy issue in `_contexts_builder` during ephemeral agent creation

Version 1.0.5

Release

Version bump release with no functional changes from 1.0.4.

Version 1.0.4

Feature Release

Added call flow verb insertion API for customizing SWML call flow with pre-answer, post-answer, and post-AI verbs.

Changes

Area	Change
AgentBase	Added `add_pre_answer_verb()` for ringback tones, screening, routing
AgentBase	Added `add_post_answer_verb()` for welcome messages, disclaimers
AgentBase	Added `add_post_ai_verb()` for cleanup, transfers, logging
AgentBase	Added `add_answer_verb()` to configure answer verb (max_duration, etc.)
AgentBase	Added `clear_pre_answer_verbs()`, `clear_post_answer_verbs()`, `clear_post_ai_verbs()`
AgentBase	Fixed `auto_answer=False` to actually skip the answer verb
AgentBase	Added pre-answer verb validation with helpful warnings

Version 1.0.3

Patch Release

Updated SWML schema with new features for queue management and enhanced context switching.

Changes

Area	Change
SWML Schema	Added `enter_queue` method for queue management
SWML Schema	Added `change_context` action for SWAIG functions
SWML Schema	Added `change_step` action for SWAIG functions
SWML Schema	Added `transfer_after_bridge` parameter to `connect` method
SWML Schema	Improved documentation for `execute`, `transfer`, and `connect` destinations
SWML Schema	Fixed payment connector URL documentation link

Version 1.0.2

Patch Release

Added serve_static_files() method to AgentServer for properly serving static files alongside agents.

Changes

Area	Change
AgentServer	Added `serve_static_files(directory, route)` method
AgentServer	Static files now correctly fall back after agent routes
AgentServer	Both `/route` and `/route/` now work for agent endpoints

Version 1.0.1

Patch Release

Minor fixes to included examples for better compatibility with the swaig-test CLI tool.

Changes

Area	Change
Examples	Fixed deprecated API calls in `swml_service_routing_example.py`
Examples	Added error handling for remote search in `sigmond_remote_search.py`
Examples	Fixed argparse conflicts with swaig-test in several examples
Examples	Updated examples to return agents from `main()` for testing

Version 1.0.0

Initial Release

The first public release of the SignalWire Agents SDK, providing a comprehensive Python framework for building AI voice agents.

Core Features

Feature	Description
AgentBase	Base class for all voice AI agents
SWAIG Functions	Define callable functions with `@agent.tool`
SwaigFunctionResult	Chainable response builder with actions
DataMap	Serverless REST API integration
Skills System	Auto-discovered plugin architecture
Prefabs	Pre-built agent archetypes
Contexts	Multi-step conversation workflows
AgentServer	Host multiple agents on one server

Built-in Skills

datetime: Current time and date information
native_vector_search: Local document search
web_search: Web search integration
math: Mathematical calculations
datasphere: SignalWire DataSphere integration

Prefab Agents

InfoGatherer: Structured information collection
FAQBot: Knowledge base Q&A
Survey: Multi-question surveys
Receptionist: Call routing
Concierge: Restaurant/service booking

CLI Tools

swaig-test: Test agents and functions locally
sw-search: Build and query search indexes
sw-agent-init: Create new agent projects

Deployment Support

Local development server
AWS Lambda
Google Cloud Functions
Azure Functions
CGI mode
Docker/Kubernetes

Versioning Policy

The SDK follows Semantic Versioning:

Version Component	Meaning
MAJOR (1.x.x)	Breaking changes requiring code updates
MINOR (x.1.x)	New features, backwards compatible
PATCH (x.x.1)	Bug fixes, backwards compatible

Upgrade Notifications

To stay informed about new releases:

Watch the GitHub repository
Subscribe to release notifications
Check pip show signalwire-agents for current version
Use pip install --upgrade signalwire-agents to update

Reporting Issues

To report bugs or request features:

Check existing GitHub issues
Create a new issue with:
- SDK version (pip show signalwire-agents)
- Python version (python --version)
- Minimal reproduction code
- Expected vs actual behavior

Contributing

Contributions are welcome! See the repository’s CONTRIBUTING.md for guidelines.

This concludes the SignalWire Agents SDK documentation.