Daily Edition Sources +4

Builder Work: Hermes Keeps an SDK Upgrade From Dropping the Conversation

A public Claude-assisted MCP migration in Hermes Agent shows the durable craft: make a compatibility seam explicit, then test every way an upgrade can lose meaning without crashing.

A rough-marker diagram connects a Hermes MCP field adapter and HTTP transport change to a public server test, with a broken-arrow warning beside a tool-result card.
Diagram Punkversion changes deserve adapters and tests for what can disappear silently.
repo NousResearch/hermes-agent evidence
4 source signals 1 repo commit 11a9dcf
Evidence: commit 11a9dcf / August 18, 2026 / Daily Edition
Open Edition Evidence below

Dependency upgrades are often presented as a version number and a green lockfile. Hermes Agent’s MCP 2.0 migration is the more useful kind of public receipt: it names Claude Opus 5 (1M context) in its co-author metadata, then shows the unglamorous work needed to keep an agent conversation intact after an SDK changes its surface.

The repo evidence

MCP 2.0 moved model fields from camelCase to snake_case, changed the server import, and moved its HTTP stack to a different module. Hermes did not scatter version checks through its tools. In the inspected MCP tool module, mcp_field reads both field spellings while sdk_httpx() asks the installed SDK which HTTP implementation it actually uses.

That distinction is not cosmetic. A missing field alias could make a failed tool result look successful, an image lose its MIME type, or pagination stop after the first page. The migration also moves server tests toward MCPServer.call_tool, the public call surface, instead of a private manager whose contract changed beneath it.

The transferable skill

The transferable building skill: treat a library upgrade as a translation boundary, not a find-and-replace exercise. Put field normalization and foreign-client selection behind small adapters; then write tests for the dangerous direction of failure—the response that looks plausible but has silently lost a tool result, a cursor, or an auth error. Builders can reuse that pattern whenever an agent spans an SDK, a protocol, and an optional dependency.

The limit

The co-author trailer is public proof of coding-agent participation, not an audit of who wrote which line or a guarantee of correctness. The commit and tests describe merged source; they do not prove a released package, a reader’s dependency mix, or interoperability with every MCP server. The next meaningful receipt would be a release note and a real cross-version connection test.

Evidence Trail

Receipts below the story

The article above is the public narrative. This section keeps the source trail and limits on the same page.

Edition
DateAugust 18, 2026
LaneDaily Edition
Confidence78%
Sources4
ReposNousResearch/hermes-agent

Primary Evidence

Evidence Limits

  • The co-author trailer proves disclosed coding-agent participation, not a contribution share, authorship attribution beyond the commit, or a release outcome.
  • Merged source and tests do not prove that all installations use MCP 2.0 successfully, that every optional dependency combination works, or that a release includes the change.
Letters & Corrections

Send a note to the desk

Corrections, missing context, or a follow-up lead.