Repository navigation
Add an agent-tools projection: the tools agents call, on every surface - #11
Merged
Merged
Conversation
The tools Projections offers coding agents, their parameters and the surfaces that expose them (projections mcp, MCP Apps hosts, VS Code's languageModelTools and the Copilot app canvas), as one api/v0 extraction drawn by the built-in api renderer. - The extractor reads source, never runs the CLI: it evaluates the catalog's Rust literals (json!, helpers, format!, consts), and reads the VS Code manifest, the canvas's actions and the MCP Apps additions. Any revision extracts, built or not. A test checks the evaluated catalog against the VS Code manifest, which CI keeps equal to the CLI's tools/list. - Its comparator classifies each change as agents calling the tools meet it, in the metadata.compatibility shape the api renderer counts and filters (a parameter removed, made required or narrowed is breaking; a tool that starts writing or needs more trust breaks behavior), and flags drift between surfaces (a tool or parameter on one but not another, or a stale VS Code manifest) in the summary, the renderer's notices and metadata.surfaceParity. - Bookmarks #7 (compare takes definitionRevision) and #9 (the view tools take viewer); the agent tools doc mentions it. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
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.
A projection of the tools Projections exposes to coding agents: each tool, its parameters (name, type, enum values, limits, required) and the surfaces that expose it (
projections mcp, MCP Apps hosts, VS Code'slanguageModelTools, the Copilot app canvas).Extraction (
.github/projections/agent-tools/, custom,determinism: pure, scoped to six files): reads source at each revision, never runs the CLI, so history extracts without building it.catalog.rsis evaluated from its Rust literals (json!, the file's helpers,format!, consts, struct literals); anything else fails with its line.actionslist and itsprojectinput. MCP Apps:app.rs'sviewer_requestand the tools linked to the view.projections mcptools/listfrom an MCP Apps client;agent-tools.test.mjschecks it against the VS Code manifest.Renderer: built-in
api, one row per surface, tool (compare on mcp, mcp-apps, vscode · read-only · trust: extract) and parameter (definition?: "base" | "head"). Parameters a surface adds to every tool (folder,project) appear once, on its surface row.Comparator (
agent-tools.comparator.yaml) writesmetadata.compatibility, so the api renderer counts levels and offers Breaking only:metadata.surfaceParity, the change's summary and the renderer's notices): a tool missing from a surface every tool should be on (options.everyTool), a canvas action not in the catalog, a parameter missing from a surface its tool is on (exceptoptions.dropped: VS Code'sconfirm), or with a different schema there. For VS Code it says to runnode scripts/tools.mjs.Bookmarks: #7 (
compare.definitionRevision: 1 additive change) and #9 (vieweronopen_projection,current_view,refreshandscreenshot: 4 additive changes);projections bookmark run --trustruns both.Checks:
projections check -p agent-tools --trust(all pass, renderer checks included),projections bookmark run --trust,cargo test -p projections-cli --test comparator_tests,node --test .github/projections/agent-tools/agent-tools.test.mjs,npm run docs:check,check:considered,check:links,check:boundaries,check:portability, oxfmt and eslint.