refactor: rename skills from tmux-agent-orchestrate-* to multi-agent-mux-* in backplane scripts and documents
This commit is contained in:
@@ -20,12 +20,12 @@ Modern agentic workflows often suffer from session timeout, lack of process isol
|
||||
|
||||
All orchestration functionalities are structured under the `.agents/skills/` directory:
|
||||
|
||||
* **`tmux-agent-orchestrate-create`**: Spawns isolated tmux sessions running specified agent CLI wrappers. It captures system processes, updates metadata registries, and enforces authentication checks.
|
||||
* **`tmux-agent-orchestrate-stop`**: Gracefully terminates agent CLI sessions (using key macros like `/exit` or `Exit`) and handles disk purge operations (removing conversation JSON files and SQLite logs for deleted workspaces).
|
||||
* **`tmux-agent-orchestrate-resume`**: Restores stopped sessions by resolving workspace UUIDs from disk or cache, and invokes the underlying agent using session-resume parameters (e.g., `claude -r <uuid>` or `hermes --resume <uuid>`).
|
||||
* **`tmux-agent-orchestrate-status`**: Queries the running states of all active sessions, detecting PID mismatches, command signatures, and drifts between actual tmux instances and the registry database.
|
||||
* **`tmux-agent-orchestrate-monitor`**: A long-running Kanban reconcile worker that dynamically monitors tmux sessions and synchronizes states to `.mam/agent-sessions.yaml`.
|
||||
* **`tmux-agent-orchestrate-delegate-job`**: The core asynchronous task distribution module containing:
|
||||
* **`multi-agent-mux-create`**: Spawns isolated tmux sessions running specified agent CLI wrappers. It captures system processes, updates metadata registries, and enforces authentication checks.
|
||||
* **`multi-agent-mux-stop`**: Gracefully terminates agent CLI sessions (using key macros like `/exit` or `Exit`) and handles disk purge operations (removing conversation JSON files and SQLite logs for deleted workspaces).
|
||||
* **`multi-agent-mux-resume`**: Restores stopped sessions by resolving workspace UUIDs from disk or cache, and invokes the underlying agent using session-resume parameters (e.g., `claude -r <uuid>` or `hermes --resume <uuid>`).
|
||||
* **`multi-agent-mux-status`**: Queries the running states of all active sessions, detecting PID mismatches, command signatures, and drifts between actual tmux instances and the registry database.
|
||||
* **`multi-agent-mux-monitor`**: A long-running Kanban reconcile worker that dynamically monitors tmux sessions and synchronizes states to `.mam/agent-sessions.yaml`.
|
||||
* **`multi-agent-mux-delegate-job`**: The core asynchronous task distribution module containing:
|
||||
* `registry.py`: Atomically registers and claims jobs using file advisory locks (`fcntl`).
|
||||
* `job_subscriber.py`: Connects to the MQTT backplane, captures live events, and appends them to audit trails.
|
||||
* `publish_event.py`: Emits execution status transitions and error details from workspace scripts.
|
||||
@@ -83,12 +83,12 @@ To ensure communication integrity across public MQTT brokers, the backplane inte
|
||||
├── .agents/
|
||||
│ └── skills/ # Core orchestration shell wrappers & libraries
|
||||
│ ├── lib.sh # Shared orchestration library
|
||||
│ ├── tmux-agent-orchestrate-create/
|
||||
│ ├── tmux-agent-orchestrate-stop/
|
||||
│ ├── tmux-agent-orchestrate-resume/
|
||||
│ ├── tmux-agent-orchestrate-status/
|
||||
│ ├── tmux-agent-orchestrate-monitor/
|
||||
│ └── tmux-agent-orchestrate-delegate-job/
|
||||
│ ├── multi-agent-mux-create/
|
||||
│ ├── multi-agent-mux-stop/
|
||||
│ ├── multi-agent-mux-resume/
|
||||
│ ├── multi-agent-mux-status/
|
||||
│ ├── multi-agent-mux-monitor/
|
||||
│ └── multi-agent-mux-delegate-job/
|
||||
│ ├── requirements.txt # Python dependency declaration
|
||||
│ └── scripts/ # Core backplane implementation (Python)
|
||||
├── .mam/ # Multi-Agent Mux metadata (git-ignored)
|
||||
@@ -117,11 +117,11 @@ For detailed setup instructions, please consult the **[BOOTSTRAP.md](./BOOTSTRAP
|
||||
```bash
|
||||
python3 -m venv .venv
|
||||
source .venv/bin/activate
|
||||
pip install -r .agents/skills/tmux-agent-orchestrate-delegate-job/requirements.txt
|
||||
pip install -r .agents/skills/multi-agent-mux-delegate-job/requirements.txt
|
||||
```
|
||||
3. **Run Registry Diagnostics:**
|
||||
```bash
|
||||
.venv/bin/python3 .agents/skills/tmux-agent-orchestrate-delegate-job/scripts/registry.py list
|
||||
.venv/bin/python3 .agents/skills/multi-agent-mux-delegate-job/scripts/registry.py list
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user