Skip to main content
Starting with Python SDK v0.9.0 and TypeScript SDK v0.2.0, manual tool execution requires explicit version specification. This is a breaking change from earlier versions where toolkit versioning was optional.

Breaking change

Manual tool execution now requires explicit version specification. The tools.execute() method will fail without a version.

Before (will fail)

After (required)

Choose one of three migration strategies:

Option 1: Configure version at SDK level

Option 2: Pass version with each execution

Option 3: Use environment variables

Migration checklist

  1. Audit your code: Find all tools.execute() calls in your codebase
  2. Choose a strategy: Select one of the three options above based on your needs
  3. Test thoroughly: Verify tools work correctly with pinned versions
  4. Deploy gradually: Roll out changes incrementally to minimize risk

Temporary workaround

During migration, you can temporarily skip version checks (not recommended for production):
The dangerouslySkipVersionCheck flag is only for migration or debugging. Never use in production.

Next

Migrate to sessions