Ping Hook

A minimal MindRoom hook plugin that responds to !ping-hook with 🏓 Pong from hook!.

Features

• Registers a router-scoped message:received hook
• Responds to the exact command !ping-hook
• Sends the reply into the current room and thread with ctx.send_message()
• Sets ctx.suppress = True so MindRoom does not continue with the normal response flow

How It Works

1. A user sends !ping-hook in a room or thread.
2. The ping-hook hook checks the incoming message body.
3. If it matches, the hook posts 🏓 Pong from hook! back into the same room and thread.
4. The hook suppresses the rest of the message pipeline so the command behaves like a lightweight built-in action.

Hooks

Hook	Event	Purpose
ping-hook	message:received	Respond to !ping-hook with a direct message reply

Install

Vendor this plugin with the MindRoom CLI:

mindroom plugins install ping-hook-plugin

Then reference it from config.yaml:

plugins:
  - path: plugins/ping-hook-plugin

Update to the latest commit later with:

mindroom plugins update ping-hook-plugin

The command pins the exact installed commit in .mindroom-plugin.lock.json and strictly validates the plugin before activating it. For a manual checkout instead, see Setup below.

Setup

1. Copy this plugin to ~/.mindroom/plugins/ping-hook.
2. Add the plugin to config.yaml:

   plugins:
     - path: plugins/ping-hook
   

3. Restart MindRoom.

No agent tools or plugin settings are required.