feat: Implement tool provenance tracking for tool execution logging - #1382
Draft
vasilyl wants to merge 3 commits into
Draft
feat: Implement tool provenance tracking for tool execution logging#1382vasilyl wants to merge 3 commits into
vasilyl wants to merge 3 commits into
Conversation
vasilyl
force-pushed
the
tool-provenance-tracking
branch
from
August 25, 2026 19:48
3c18af4 to
0d9a26f
Compare
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Please ensure you have read the contribution guide before creating a pull request.
Link to Issue or Description of Change
1. Link to an existing issue (if applicable):
2. Or, if no issue exists, describe the change:
Problem:
During complex multi-agent executions or nested tool invocations, it is difficult to trace the origin of a tool (e.g., whether it is a local function, an MCP tool, a sub-agent, or a transfer agent). This lack of provenance makes debugging and analytics on tool usage patterns highly challenging.
Solution:
Introduce a
getToolOrigin(t tool.Tool) stringhelper insidebigquery_agent_analytics_plugin.goto inspect the tool's type and return its origin classification (LOCAL,SUB_AGENT,MCP,A2A,TRANSFER_AGENT, orUNKNOWN). Use this to populate atool_originattribute in telemetry logs forTOOL_START,TOOL_END, andTOOL_ERRORevent types.Testing Plan
Added a unit test
TestToolProvenanceto verify thatgetToolOrigincorrectly identifiesLOCALfunction tools andSUB_AGENTagent tools.Checklist