zhi
7b93db3ed9
- Delete NEW_FEAT.md - Create FEAT.md with complete feature documentation across all versions - Update README.md to reflect individual tool names and add @mention override
108 lines
4.9 KiB
Markdown
108 lines
4.9 KiB
Markdown
# Dirigent — Feature List
|
|
|
|
All implemented features across all versions.
|
|
|
|
---
|
|
|
|
## Core: Rule-Based No-Reply Gate
|
|
- Deterministic logic in `before_model_resolve` hook decides whether to route to no-reply model
|
|
- **human-list** mode: humanList senders bypass gate; others need end symbol to pass
|
|
- **agent-list** mode: agentList senders need end symbol; others bypass
|
|
- Non-Discord messages skip entirely
|
|
- DM sessions (no metadata) always bypass
|
|
- Per-channel policy overrides via JSON file (runtime-updateable)
|
|
|
|
## Core: End-Symbol Enforcement
|
|
- Injects prompt instruction: "Your response MUST end with 🔚"
|
|
- Gateway keywords (NO_REPLY, HEARTBEAT_OK) exempt from end symbol
|
|
- Group chats get additional rule: "If not relevant, reply NO_REPLY"
|
|
- End symbols configurable per-channel via policy
|
|
|
|
## Core: No-Reply API
|
|
- OpenAI-compatible API (`/v1/chat/completions`, `/v1/responses`, `/v1/models`)
|
|
- Always returns `NO_REPLY` — used as the override model target
|
|
- Optional bearer auth (`AUTH_TOKEN`)
|
|
- Auto-started/stopped with gateway lifecycle
|
|
|
|
## Turn-Based Speaking (Multi-Bot)
|
|
- Only the current speaker is allowed to respond; others forced to no-reply model
|
|
- Turn order auto-populated from bot accounts seen in each channel
|
|
- Turn advances on end-symbol (successful speech) or NO_REPLY
|
|
- Successful speech resets NO_REPLY cycle counter
|
|
- If all bots NO_REPLY in a cycle → channel goes **dormant**
|
|
- Dormant reactivation: human message → first in order; bot message → next after sender
|
|
- Turn timeout: auto-advance after 60s of inactivity
|
|
- Manual control: `/dirigent turn-status`, `/dirigent turn-advance`, `/dirigent turn-reset`
|
|
|
|
## Human @Mention Override *(v0.3.0)*
|
|
- When a `humanList` user @mentions specific agents (`<@USER_ID>`):
|
|
- Extracts mentioned Discord user IDs from message content
|
|
- Maps userIds → accountIds via reverse bot token lookup
|
|
- Filters to agents in the current turn order
|
|
- Orders by their position in the current turn order
|
|
- Temporarily replaces speaking order with only those agents
|
|
- Cycle: a → b → c → (back to a) → restore original order, go dormant
|
|
- Edge cases:
|
|
- All override agents NO_REPLY → restore + dormant
|
|
- `resetTurn` clears any active override
|
|
- Human message without mentions → restores override, normal flow
|
|
- Mentioned users not in turn order → ignored
|
|
|
|
## Agent Identity Injection
|
|
- Group chat prompts include: agent name, Discord accountId, Discord userId
|
|
- userId resolved from bot token (base64 first segment)
|
|
|
|
## Scheduling Identifier
|
|
- Configurable identifier (default: `➡️`) used for moderator handoff
|
|
- Handoff format: `<@TARGET_USER_ID>➡️` (non-semantic scheduling signal)
|
|
- Agent prompt explains: identifier is meaningless — check chat history, decide whether to reply
|
|
- If nothing to say → NO_REPLY
|
|
|
|
## Moderator Bot Presence
|
|
- Maintains Discord Gateway WebSocket connection for moderator bot
|
|
- Shows "online" status with "Moderating" activity
|
|
- Handles reconnect, resume, heartbeat, invalid session recovery
|
|
- Singleton guard prevents duplicate connections
|
|
- Sends handoff messages to trigger next speaker's turn
|
|
|
|
## Individual Tools *(v0.3.0)*
|
|
Nine standalone tools (split from former monolithic `dirigent_tools`):
|
|
|
|
### Discord Control
|
|
- **`dirigent_channel_create`** — Create private Discord channel with user/role permissions
|
|
- **`dirigent_channel_update`** — Update permissions on existing private channel
|
|
- **`dirigent_member_list`** — List guild members with pagination and field projection
|
|
|
|
### Policy Management
|
|
- **`dirigent_policy_get`** — Get all channel policies
|
|
- **`dirigent_policy_set`** — Set/update a channel policy (listMode, humanList, agentList, endSymbols)
|
|
- **`dirigent_policy_delete`** — Delete a channel policy
|
|
|
|
### Turn Management
|
|
- **`dirigent_turn_status`** — Show turn state (order, current speaker, dormant status, override info)
|
|
- **`dirigent_turn_advance`** — Manually advance to next speaker
|
|
- **`dirigent_turn_reset`** — Reset turn order (go dormant, clear overrides)
|
|
|
|
## Slash Command: `/dirigent`
|
|
- `status` — Show all channel policies
|
|
- `turn-status` — Show turn state for current channel
|
|
- `turn-advance` — Manually advance turn
|
|
- `turn-reset` — Reset turn order
|
|
|
|
## Project Rename (WhisperGate → Dirigent) *(v0.2.0)*
|
|
- All plugin ids, tool names, config keys, file paths, docs updated
|
|
- Legacy `whispergate` config key still supported as fallback
|
|
|
|
## Installer Script
|
|
- `scripts/install-dirigent-openclaw.mjs`
|
|
- `--install` / `--uninstall` with delta-tracking
|
|
- Auto-reinstall (uninstall + install) if already installed
|
|
- Backup before changes, rollback on failure
|
|
- Records stored in `~/.openclaw/dirigent-install-records/`
|
|
|
|
## Discord Control API (Sidecar)
|
|
- Private channel create/update with permission overwrites
|
|
- Member list with pagination + field projection
|
|
- Guardrails: action validation, id-list limits, response-size limit
|
|
- Runs as optional companion service (`discord-control-api/`)
|