Add metadata support to deferred tool exceptions #3345
+459
−30
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
DouweM
requested changes
Nov 6, 2025
DouweM
reviewed
Nov 6, 2025
Enables CallDeferred and ApprovalRequired exceptions to carry arbitrary metadata via an optional `metadata` parameter. The metadata is accessible in DeferredToolRequests.metadata keyed by tool_call_id. This allows tools to: - Provide cost/time estimates for approval decisions - Include task IDs for external execution tracking - Store context about why approval is required - Attach priority or urgency information Backward compatible - metadata defaults to empty dict if not provided.
Extract metadata population logic into separate _populate_deferred_calls helper function to reduce cyclomatic complexity from 16 to 15.
Per Douwe's comments:
1. Store None instead of {} when no metadata provided
2. Don't add tool_call_id to metadata dict when None
3. Update Temporal wrap/unwrap methods to handle metadata
- Updated test assertions to reflect None metadata behavior
- Updated doc example snapshots to show metadata={}
- Fixed codespell issue with table formatting
cjohnhanson
force-pushed
the
feat/deferred-tool-metadata
branch
from
7e17594 to
42cf5b8
Compare
- Replace contrived task_id parameter with realistic tool signatures - Add ComputeDeps class demonstrating dependency injection pattern - Show using ctx.deps to compute metadata from tool arguments - Remove incorrect statement about backwards compatibility - Update test_examples.py to match new realistic example
- Add mock model responses for flight booking example - Update documentation snapshots to include metadata field - Follow existing pattern for deferred tool testing
- Complete test_approval_required_without_metadata() by running agent with approval results to hit the tool implementation line - Complete test_mixed_deferred_tools_with_metadata() by running agent with all deferred tool results to hit tool implementation lines - Remove unreachable branch check in _populate_deferred_calls() - keys are always present in both dicts by construction This achieves 100% coverage for the deferred tool metadata feature.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Enables
CallDeferredandApprovalRequiredexceptions to carry arbitrary metadata via an optionalmetadataparameter. The metadata is accessible inDeferredToolRequests.metadatakeyed bytool_call_id.Backward compatible - metadata defaults to empty dict if not provided.