tools.admin_whisper module
Tool: admin_whisper admin whisper tool
- async tools.admin_whisper.run(channel_id='', prompt='', message_count=50, remember=False, *, ctx=None)[source]
Tool entrypoint: send a secret admin whisper to a shard in
channel_id.Thin wrapper around
_admin_whisper(). Fetches recent channel history to orient the persona, runs a one-shot LLM call with the whisper prompt injected as an out-of-band admin override, and returns the shard’s reply as a JSON string without posting anything to the target channel.- Parameters:
channel_id (
str) – Target channel or DM ID where the shard is embedded.prompt (
str) – Secret message/command to whisper to the shard.message_count (
int) – Recent messages to include as context (default 50, capped at 100).remember (
bool) – When True, include any existing short-term notes for the channel and persist the whisper exchange as a new short-term note.ctx – Tool context (config, redis, adapter, message cache).
- Return type:
- Returns:
JSON string with the shard’s reply, or an
errorfield on failure.