Add Anvil agent - #417
Open
foundev wants to merge 2 commits into
Open
Conversation
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
foundev
force-pushed
the
add-brokk-agent
branch
from
August 4, 2026 16:52
02f5a7c to
7700b2f
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.
Adding a New Agent: Anvil
Registers Anvil, a portable Rust ACP server with model routing, tools, permissions, sandboxing, sessions, and MCP integration.
anvil0.24.4(pinned to the current npm release; the hourly auto-update will pick up later versions)What this PR adds, step by step
1. The manifest. The entire entry is two files:
anvil/agent.jsonandanvil/icon.svg. The manifest:{ "id": "anvil", "name": "Anvil", "version": "0.24.4", "description": "Portable Rust ACP server with model routing, tools, permissions, sandboxing, sessions, and MCP integration", "repository": "https://github.com/BrokkAi/anvil", "website": "https://anvil.brokk.ai", "authors": ["Brokk AI"], "license": "LGPL-3.0-only", "distribution": { "npx": { "package": "@brokkai/anvil@0.24.4" } } }2. What a client does with it. The
distribution.npxblock tells clients (Zed, JetBrains, …) to launch the agent as:The
@brokkai/anvilnpm package installs the released native binary for the host platform (macOS, Linux glibc, Windows, Android/Termux). There is deliberately noargsarray: the binary speaks ACP JSON-RPC over stdio as soon as it starts, no subcommand or flag needed.3. Proof the launch works. Piping an ACP
initializerequest into exactly that command (this downloads the published package from npm and runs it; the agent keeps serving after the response, so Ctrl-C to exit):returns (pretty-printed):
{ "jsonrpc": "2.0", "id": 1, "result": { "protocolVersion": 1, "agentCapabilities": { "loadSession": true, "promptCapabilities": { "image": true, "audio": false, "embeddedContext": true }, "mcpCapabilities": { "http": true, "sse": true, "acp": false }, "sessionCapabilities": { "list": {}, "delete": {}, "additionalDirectories": {}, "fork": {}, "resume": {}, "close": {} }, "auth": {} }, "authMethods": [ { "id": "none", "name": "No authentication required", "description": "Anvil needs no login; model providers are configured per session (/setup) or through environment variables." } ] } }4. This repo's schema/build validation, run from this branch:
5. This repo's ACP auth check.
verify_agents.pyreads the manifest above, sees thenpxdistribution, and builds the launch command itself (verify_agents.py,build_agent_command):npx --prefix <sandbox> --yes @brokkai/anvil@0.24.4— the same invocation as step 2, sandboxed. It then performs theinitializehandshake and checks the advertised auth methods. Run with a wiped sandbox so the package is freshly downloaded from npm:(The
→ Auth check:line is truncated by the verifier's own logging — it prints only the first three tokens of the command; the full command is the one described above.)Checklist
id(anvil/)agent.jsonvalidates against the schemaicon.svgis a 16x16 monochrome SVG usingcurrentColor(Anvil's own mark)npxdistributionpackageis version-pinned and matchesversionverify_agents.py --auth-checkpasses against the published npm package