mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-04-25 00:51:20 +00:00
Fix ACP module path documentation from acp_adapter to hermes_agent.acp
This commit is contained in:
parent
420c4d02e2
commit
b49bd7b93d
5 changed files with 21 additions and 21 deletions
|
|
@ -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)
|
||||||
|
|
|
||||||
|
|
@ -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.
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
|
|
@ -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:
|
||||||
|
|
|
||||||
|
|
@ -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.
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue