tools.dm_history module

Search or fetch recent messages from a user’s DM history.

async tools.dm_history.run(mode='recent', query='', limit=10, target_user_id='', *, ctx=None)[source]

Execute this tool and return the result.

Parameters:
  • mode (str) – The mode value.

  • query (str) – Search query or input string.

  • limit (int) – Maximum number of items.

  • target_user_id (str) – Optional target user ID.

  • ctx (ToolContext | None)

Returns:

Result string.

Return type:

str