Integration Compatibility Matrix

Last Updated: 2026-04-03

Tracks compatibility between Tenuo and upstream integration libraries.

Supported Versions

Version Philosophy: Tenuo uses permissive constraints in pyproject.toml to maximize compatibility. We warn at runtime (not fail) if you have a version with known issues. This lets you try Tenuo without upgrading your entire stack.

Runtime Warnings: If you import a Tenuo integration with a version that has known issues, you’ll see a warning like:

Tenuo compatibility notice: openai==1.2.0
  Issue: OpenAI 1.0-1.5 may have httpx compatibility issues
  Recommendation: Upgrade to openai>=1.6 if you encounter this issue

Status Legend

• Stable: Production-ready, actively tested
• Beta: Works but may have rough edges
• In Development: Not yet released
• Deprecated: No longer supported

Known Issues

OpenAI

Current Status: Stable (minimum + latest passing)

Version Notes:

• Minimum and latest tracks are monitored by automation.
• Latest matrix verification: Run #23964271744.

Recent Changes:

• 1.50.0: Added streaming support for tool calls (Compatible)
• 1.40.0: Response format changes (Compatible)
• 1.6.0: Fixed httpx compatibility

Tracking: Open a new integration issue if regressions reappear.

CrewAI

Current Status: Stable (minimum + latest passing)

Version Notes:

• 1.0.x: Requires explicit backstory for Agent and expected_output for Task. Tenuo’s wrapper code works, but you must provide these fields. Tenuo will warn at runtime.
• Latest matrix verification: Run #23964271744.

Recent Changes:

• 1.9.0: Added hierarchical process support (Compatible)
• 1.5.0: Tool signature changes (Backwards compatible)
• 1.1.0: Made backstory/expected_output have defaults

Tracking: Open a new integration issue if regressions reappear.

AutoGen

Current Status: Stable (minimum + latest passing)

Version Notes:

• Minimum and latest tracks are monitored by automation.
• Latest matrix verification: Run #23964271744.

Tracking: Open a new integration issue if regressions reappear.

LangChain

Current Status: Stable (minimum + latest passing)

Version Notes:

• 0.2.0-0.2.26: Works standalone, but incompatible with langgraph>=0.2. Tenuo will warn if you use langgraph.
• 0.2.27+: Required when paired with langgraph>=0.2.
• Latest matrix verification: Run #23964271744.

Recent Changes:

• 0.3.0: Pydantic v2 migration (Compatible)
• 0.2.27: Compatible with langgraph 0.2.0
• 0.2.0: Core extraction

Temporal

Current Status: Stable (minimum + latest passing)

Version Notes:

• 1.23.0: Minimum required version. Introduces SimplePlugin API used by TenuoTemporalPlugin.
• <1.23.0: TenuoTemporalPlugin is not available. Manual TenuoWorkerInterceptor + Worker(interceptors=[...]) pattern works.
• Replay safety (determinism of PoP signatures, workflow.now() usage) is verified on both minimum and latest.

Replay Safety Testing:

• PoP signatures are deterministic across replays (same inputs → same output).
• Workflow interceptor uses workflow.now(), not time.time() or datetime.now().
• EnvKeyResolver uses pre-cached keys inside the sandbox (no os.environ access).
• Workflow history recorded on one SDK version replays cleanly via Replayer.

Tracking: Open a new integration issue if regressions reappear.

LangGraph

Current Status: Stable (minimum + latest passing)

Version Notes:

• 0.2.0+: Requires langchain-core>=0.2.27. Tenuo’s [langgraph] extra handles this automatically.
• 0.0.x/0.1.x: Not supported (requires langchain-core<0.2, which conflicts with our langchain integration).
• Latest matrix verification: Run #23964271744.

Recent Changes:

• 0.2.0: Updated to support langchain-core>=0.2
• 0.1.0: Initial stable release (incompatible with our langchain-core requirement)

Version Testing Status

Last tested: Run #23964271744

Testing Cadence:

• Minimum versions: Weekly
• Latest versions: Weekly
• Pre-release: Manual (on major releases)

Deprecation Timeline

Scheduled Deprecations

None currently scheduled.

Watching

• CrewAI 1.x: monitor 2.0 migration path
• OpenAI 1.x: monitor 2.0 migration path
• LangChain/LangGraph: monitor joint compatibility surface
• AutoGen: monitor AgentChat and extension package changes
• Temporal: monitor SimplePlugin API stability and SandboxRestrictions changes

Reporting Compatibility Issues

If you encounter compatibility issues:

1. Check this matrix for known issues
2. Search existing issues: Integration label
3. Open new issue with:
   • Integration name and version
   • Tenuo version
   • Python version
   • Minimal reproduction case
   • Error message/traceback

Issue Template: Use the “Integration Compatibility” template when creating issues.

Changelog References

Quick links to upstream changelogs:

• OpenAI Python Changelog
• CrewAI Releases
• AutoGen Changelog
• LangChain Changelog
• LangGraph Releases
• MCP Releases
• Temporal Python SDK Releases

Maintenance Policy

Tenuo maintains compatibility with:

• Latest major version + previous major version
• Latest 2 minor versions within supported major
• Minimum version as declared in pyproject.toml

Example: If latest is 2.5.0, we support:

• 2.5.x (latest)
• 2.4.x (previous minor)
• 1.x.x (previous major, best-effort)
• Minimum declared version (always tested)

Contributing

Help us maintain compatibility:

1. Report issues early: Beta test new releases
2. Share workarounds: Document temporary fixes
3. Submit PRs: Fix compatibility issues
4. Join discussions: GitHub Discussions

This matrix is updated from automated compatibility runs. Tracker issues are opened only for active regressions and closed once fixed or invalidated.