Skip to content

Add debugging member to ToolAnnotations - #253

Merged
domfarolino merged 1 commit into
webmachinelearning:mainfrom
beaufortfrancois:debugging-member
Sep 17, 2026
Merged

domfarolino merged 1 commit into
webmachinelearning:mainfrom
beaufortfrancois:debugging-member

Conversation

@beaufortfrancois

@beaufortfrancois beaufortfrancois commented Aug 21, 2026

Copy link
Copy Markdown
Collaborator

Following the WebML CG resolution, this PR adds a debugging boolean member to the ToolAnnotations dictionary to provide a way for web apps and frameworks to register tools intended specifically for developer tooling and inspection (e.g., Chrome DevTools AI assistance, testing frameworks) so that general-purpose/end-user agents can filter them out.

Note that I went with debugging rather than debuggingHint because it is a definitive categorization flag identifying the tool's intended domain/audience (developer/debugging tools vs. user-facing tools) rather than a behavioral hint about how the tool executes.

Fixes #207


Preview | Diff

@beaufortfrancois

Copy link
Copy Markdown
Collaborator Author

FYI I have a WIP Chromium CL at https://chromium-review.googlesource.com/c/chromium/src/+/8398587

@markafoltz
markafoltz self-requested a review September 16, 2026 21:24
@markafoltz

Copy link
Copy Markdown
Collaborator

PR LGTM.

One question that comes to mind is whether a tool marked as debugging must not set consequentialHint. Those two categories seem mutually exclusive, as debugging should not have irreversible, real-world side effects.

@domfarolino
domfarolino merged commit 8a82bb7 into webmachinelearning:main Sep 17, 2026
2 checks passed
github-actions Bot added a commit that referenced this pull request Sep 17, 2026
SHA: 8a82bb7
Reason: push, by domfarolino

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
chromium-wpt-export-bot pushed a commit to web-platform-tests/wpt that referenced this pull request Sep 18, 2026
When a tool is registered with `debugging: true`, this annotation
indicates that the tool is intended for debugging and developer
tooling rather than end-user interactions.

Spec PR: webmachinelearning/webmcp#253

Bug: 489045948
Change-Id: Ie80de3eccd61e9b8420a32e2deb4ab3e89301dee
beckysiegel pushed a commit to chromium/chromium that referenced this pull request Sep 18, 2026
When a tool is registered with `debugging: true`, this annotation
indicates that the tool is intended for debugging and developer
tooling rather than end-user interactions.

Spec PR: webmachinelearning/webmcp#253

Bug: 489045948
Change-Id: Ie80de3eccd61e9b8420a32e2deb4ab3e89301dee
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/8398587
Reviewed-by: Philip Pfaffe <pfaffe@chromium.org>
Commit-Queue: Fr <beaufort.francois@gmail.com>
Cr-Commit-Position: refs/heads/main@{#1700568}
chromium-wpt-export-bot pushed a commit to web-platform-tests/wpt that referenced this pull request Sep 18, 2026
When a tool is registered with `debugging: true`, this annotation
indicates that the tool is intended for debugging and developer
tooling rather than end-user interactions.

Spec PR: webmachinelearning/webmcp#253

Bug: 489045948
Change-Id: Ie80de3eccd61e9b8420a32e2deb4ab3e89301dee
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/8398587
Reviewed-by: Philip Pfaffe <pfaffe@chromium.org>
Commit-Queue: Fr <beaufort.francois@gmail.com>
Cr-Commit-Position: refs/heads/main@{#1700568}
chromium-wpt-export-bot pushed a commit to web-platform-tests/wpt that referenced this pull request Sep 18, 2026
When a tool is registered with `debugging: true`, this annotation
indicates that the tool is intended for debugging and developer
tooling rather than end-user interactions.

Spec PR: webmachinelearning/webmcp#253

Bug: 489045948
Change-Id: Ie80de3eccd61e9b8420a32e2deb4ab3e89301dee
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/8398587
Reviewed-by: Philip Pfaffe <pfaffe@chromium.org>
Commit-Queue: Fr <beaufort.francois@gmail.com>
Cr-Commit-Position: refs/heads/main@{#1700568}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Support developer tooling

4 participants