Hermes BibleUnofficial Docs
← All docs Docs / Developer Guide

ACP Internals

The ACP adapter wraps Hermes' synchronous in an async JSON RPC stdio server. Key implementation files: Boot flow The Zed ACP Registry path launches the same ada

Developer Guide
Section
Developer Guide
Source
hermesbible.com/docs/developer-guide/acp-internals

The ACP adapter wraps Hermes' synchronous in an async JSON RPC stdio server. Key implementation files: Boot flow The Zed ACP Registry path launches the same ada

Excerpt from the official Hermes Agent documentation, quoted for reference. View source

What this page covers

Section outline mirrored from the official Hermes Agent documentation. Follow any heading to read the complete text on the source site.

Upstream outline

  1. Boot flow
  2. Major components
  3. HermesACPAgent
  4. SessionManager
  5. Event bridge
  6. Permission bridge
  7. Tool rendering helpers
  8. Session lifecycle
  9. Cancelation
  10. Forking
  11. Provider/auth behavior
  12. Working directory binding
  13. Duplicate same-name tool calls
  14. Approval callback restoration

Section map

Boot flow

Maps boot flow to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

Major components

Maps major components to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

HermesACPAgent

Maps hermesacpagent to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

SessionManager

Maps sessionmanager to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

Event bridge

Maps event bridge to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

Permission bridge

Maps permission bridge to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

Tool rendering helpers

Maps tool rendering helpers to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

Session lifecycle

Maps session lifecycle to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

Implementation notes

  • Use this Developer Guide doc as a navigation page first: the local clone mirrors the source structure and links each heading back to the authoritative upstream section.
  • Primary decision areas: Boot flow, Major components, HermesACPAgent, SessionManager, Event bridge. Read those source anchors before changing installs, credentials, automation, or runtime configuration.
  • Useful search signals for this doc: internals, adapter, wraps, synchronous, async. These are derived from the public title and summary so the clone remains lightweight.

Decision table

Best fitDeveloper Guide documentation

Use when you need orientation for acp internals before applying exact upstream commands.

Verify firstBoot flow

Open the source anchor for Boot flow and confirm platform-specific requirements before changing configuration.

Escalate to sourceCommands, credentials, runtime behavior

Use the upstream page as the authority for current syntax, release changes, and security-sensitive steps.

Verification checklist

  1. Use this page to orient yourself within Developer Guide, then open the linked source page for exact current syntax.
  2. Start with the source section for Boot flow; do not rely on the local summary for commands or secrets.
  3. Check platform, install method, provider, and credential assumptions before changing a real environment.
  4. Review the source section for Major components if the page involves setup, automation, messaging, or runtime behavior.
  5. After applying anything from the source, run the smallest relevant smoke test before widening scope.

Risk notes

Runtime access

Check filesystem, shell, browser, repository, and server permissions before granting the agent write access.

What this page covers

  • Core concept and where it fits in the Hermes Agent system.
  • Setup or operating context implied by the upstream page summary.
  • The source page link for full current details and updates.

Source mirror note

This page is generated from the public Hermes Bible index so the clone has the same route coverage and search surface. It stores the public title, category, summary, and source link locally; use the source page for full upstream text and updates.

Open source page