random_channel_message

Pick one or more random messages from the local ingested message cache for a channel. Pass count (1-25) to sample multiple distinct messages in a single call — use this when the user asks for N random messages from a chat instead of calling the tool repeatedly.

User guide / All capabilities

Contract

Effect: read. Evidence role: message_evidence.

Sample random ingested messages from a channel, with optional author and timestamp filters. Supports returning up to 25 messages per call via count.

Parameters

This is the current provider-facing JSON Schema, generated from the runtime definition.

{
  "type": "object",
  "properties": {
    "channel_id": {
      "type": "string",
      "description": "Channel ID to sample from. Messages are chosen from already ingested local messages for this channel."
    },
    "count": {
      "type": "number",
      "description": "Optional number of distinct random messages to return (1-25). Defaults to 1. Use this to fulfill \"give me N random messages\" requests in a single call instead of calling the tool repeatedly."
    },
    "author_id": {
      "type": "string",
      "description": "Optional author user ID filter. When set, sample only from this author's ingested messages in the channel."
    },
    "after_timestamp": {
      "type": "number",
      "description": "Optional lower timestamp bound in unix milliseconds (inclusive)."
    },
    "before_timestamp": {
      "type": "number",
      "description": "Optional upper timestamp bound in unix milliseconds (exclusive)."
    }
  },
  "required": [
    "channel_id"
  ]
}

Execution requirements

• channel messages must already be ingested locally

Expected postconditions

• returns up to count random ingested messages or reports that no ingested message matched