Fix ACP module path documentation from acp_adapter to hermes_agent.acp

This commit is contained in:
alt-glitch 2026-04-24 07:36:03 +05:30
parent 420c4d02e2
commit b49bd7b93d
5 changed files with 21 additions and 21 deletions

View file

@ -69,7 +69,7 @@ hermes-agent/
│ ├── server.py # RPC handlers and session logic │ ├── server.py # RPC handlers and session logic
│ ├── render.py # Optional rich/ANSI bridge │ ├── render.py # Optional rich/ANSI bridge
│ └── slash_worker.py # Persistent HermesCLI subprocess for slash commands │ └── slash_worker.py # Persistent HermesCLI subprocess for slash commands
├── acp_adapter/ # ACP server (VS Code / Zed / JetBrains integration) ├── hermes_agent/acp/ # ACP server (VS Code / Zed / JetBrains integration)
├── cron/ # Scheduler (jobs.py, scheduler.py) ├── cron/ # Scheduler (jobs.py, scheduler.py)
├── environments/ # RL training environments (Atropos) ├── environments/ # RL training environments (Atropos)
├── tests/ # Pytest suite (~3000 tests) ├── tests/ # Pytest suite (~3000 tests)

View file

@ -10,20 +10,20 @@ The ACP adapter wraps Hermes' synchronous `AIAgent` in an async JSON-RPC stdio s
Key implementation files: Key implementation files:
- `acp_adapter/entry.py` - `hermes_agent/acp/entry.py`
- `acp_adapter/server.py` - `hermes_agent/acp/server.py`
- `acp_adapter/session.py` - `hermes_agent/acp/session.py`
- `acp_adapter/events.py` - `hermes_agent/acp/events.py`
- `acp_adapter/permissions.py` - `hermes_agent/acp/permissions.py`
- `acp_adapter/tools.py` - `hermes_agent/acp/tools.py`
- `acp_adapter/auth.py` - `hermes_agent/acp/auth.py`
- `acp_registry/agent.json` - `acp_registry/agent.json`
## Boot flow ## Boot flow
```text ```text
hermes acp / hermes-acp / python -m acp_adapter hermes acp / hermes-acp / python -m hermes_agent.acp
-> acp_adapter.entry.main() -> hermes_agent.acp.entry.main()
-> load ~/.hermes/.env -> load ~/.hermes/.env
-> configure stderr logging -> configure stderr logging
-> construct HermesACPAgent -> construct HermesACPAgent
@ -36,7 +36,7 @@ Stdout is reserved for ACP JSON-RPC transport. Human-readable logs go to stderr.
### `HermesACPAgent` ### `HermesACPAgent`
`acp_adapter/server.py` implements the ACP agent protocol. `hermes_agent/acp/server.py` implements the ACP agent protocol.
Responsibilities: Responsibilities:
@ -48,7 +48,7 @@ Responsibilities:
### `SessionManager` ### `SessionManager`
`acp_adapter/session.py` tracks live ACP sessions. `hermes_agent/acp/session.py` tracks live ACP sessions.
Each session stores: Each session stores:
@ -71,7 +71,7 @@ The manager is thread-safe and supports:
### Event bridge ### Event bridge
`acp_adapter/events.py` converts AIAgent callbacks into ACP `session_update` events. `hermes_agent/acp/events.py` converts AIAgent callbacks into ACP `session_update` events.
Bridged callbacks: Bridged callbacks:
@ -88,7 +88,7 @@ asyncio.run_coroutine_threadsafe(...)
### Permission bridge ### Permission bridge
`acp_adapter/permissions.py` adapts dangerous terminal approval prompts into ACP permission requests. `hermes_agent/acp/permissions.py` adapts dangerous terminal approval prompts into ACP permission requests.
Mapping: Mapping:
@ -100,7 +100,7 @@ Timeouts and bridge failures deny by default.
### Tool rendering helpers ### Tool rendering helpers
`acp_adapter/tools.py` maps Hermes tools to ACP tool kinds and builds editor-facing content. `hermes_agent/acp/tools.py` maps Hermes tools to ACP tool kinds and builds editor-facing content.
Examples: Examples:
@ -144,7 +144,7 @@ ACP does not implement its own auth store.
Instead it reuses Hermes' runtime resolver: Instead it reuses Hermes' runtime resolver:
- `acp_adapter/auth.py` - `hermes_agent/acp/auth.py`
- `hermes_cli/runtime_provider.py` - `hermes_cli/runtime_provider.py`
So ACP advertises and uses the currently configured Hermes provider/credentials. So ACP advertises and uses the currently configured Hermes provider/credentials.

View file

@ -14,7 +14,7 @@ This page is the top-level map of Hermes Agent internals. Use it to orient yours
┌─────────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────────┐
│ Entry Points │ │ Entry Points │
│ │ │ │
│ CLI (cli.py) Gateway (gateway/run.py) ACP (acp_adapter/) │ CLI (cli.py) Gateway (gateway/run.py) ACP (hermes_agent/acp/)
│ Batch Runner API Server Python Library │ │ Batch Runner API Server Python Library │
└──────────┬──────────────┬───────────────────────┬───────────────────┘ └──────────┬──────────────┬───────────────────────┬───────────────────┘
│ │ │ │ │ │
@ -122,7 +122,7 @@ hermes-agent/
│ # dingtalk, feishu, wecom, wecom_callback, weixin, │ # dingtalk, feishu, wecom, wecom_callback, weixin,
│ # bluebubbles, qqbot, homeassistant, webhook, api_server │ # bluebubbles, qqbot, homeassistant, webhook, api_server
├── acp_adapter/ # ACP server (VS Code / Zed / JetBrains) ├── hermes_agent/acp/ # ACP server (VS Code / Zed / JetBrains)
├── cron/ # Scheduler (jobs.py, scheduler.py) ├── cron/ # Scheduler (jobs.py, scheduler.py)
├── plugins/memory/ # Memory provider plugins ├── plugins/memory/ # Memory provider plugins
├── plugins/context_engine/ # Context engine plugins ├── plugins/context_engine/ # Context engine plugins

View file

@ -650,7 +650,7 @@ Related entrypoints:
```bash ```bash
hermes-acp hermes-acp
python -m acp_adapter python -m hermes_agent.acp
``` ```
Install support first: Install support first:

View file

@ -43,7 +43,7 @@ This installs the `agent-client-protocol` dependency and enables:
- `hermes acp` - `hermes acp`
- `hermes-acp` - `hermes-acp`
- `python -m acp_adapter` - `python -m hermes_agent.acp`
## Launching the ACP server ## Launching the ACP server
@ -58,7 +58,7 @@ hermes-acp
``` ```
```bash ```bash
python -m acp_adapter python -m hermes_agent.acp
``` ```
Hermes logs to stderr so stdout remains reserved for ACP JSON-RPC traffic. Hermes logs to stderr so stdout remains reserved for ACP JSON-RPC traffic.