Goosetown Researcher Slack

search_messages(
  query_terms: "oauth implementation",     # Text to search. "double quotes" for phrases. -exclude to exclude.
  filter: {
    in_channel_names: ["#example-channel"],      # Limit to channels (use # prefix)
    in_dm_or_channel_ids: ["C1234567890"], # Limit to channel/DM IDs (use when you have IDs, not names)
    from_user_id_or_usernames: [{username: "john"}],  # Messages from specific users
    not_from_user_id_or_usernames: [{username: "bot-notifications"}],  # Exclude users (e.g., bots)
    not_in_channel_names: ["#spam"],       # Exclude channels
    after: "2026-01-01",                   # After date (YYYY-MM-DD)
    before: "2026-02-01",                  # Before date
    on: "today",                           # Specific date, "today", or "yesterday"
    newer_than: "P7D",                     # ISO 8601 duration (P7D = 7 days, PT5H = 5 hours)
    newer_than_timezone: "America/New_York",  # REQUIRED when using newer_than
    is_thread: true,                       # Messages that started threads
    is_reply: true,                        # Replies within threads
    is_pinned: true,                       # Pinned messages only
    is_saved: true,                        # Messages in your Saved Items (high signal)
    has_reaction: "thumbsup",              # Messages with specific emoji reaction (no colons)
    has_my_reaction: "eyes",               # Messages you reacted to with this emoji
    has_file: true,                        # Messages with file attachments
  },
  sort_method: "by_relevance",             # "by_relevance" (default) or "by_newest_time"
  count: 20,                               # Max results (up to 100)
  page: 1,                                 # Page number for pagination (page 2, 3, etc. for more results)
  search_type: "messages",                 # "messages" (default) or "files" to search for files instead
  user_timezone: "America/New_York",       # Pass when available in your context
)

get_channel_messages(
  channels: [
    {channel_name: "example-channel"},                          # By name
    {channel_id_or_dm_id: "C1234567890"},                 # By ID
    {dm_username: "john"},                                 # DM with user
    {channel_name: "example-channel", thread_ts: "1234567890.123456"},  # Specific thread
  ],
  messages_to_retrieve: 30,    # Max 100
  after_date: "2026-01-01",   # After date
  before_date: "2026-02-01",  # Before date
  on: "today",                # Specific date, "today", or "yesterday"
  newer_than: "P7D",          # ISO 8601 duration
  user_timezone: "America/New_York",  # REQUIRED when using newer_than
)

get_channel_info(channel_name: "example-channel")
get_channel_info(dm_username: "john")
get_channel_info(channel_id_or_dm_id: "C1234567890")

get_user_info(inputs: [
  {username: "john"},
  {email: "john@company.com"},
  {user_id: "U1234567890"},
  {real_name: "John Doe"},
  {username: "me"},           # Current authenticated user
])

list_channels(
  channel_types: "public_channel,private_channel",  # Also: mpim, im
  name_filter: "eng-",        # Case-insensitive substring filter
  limit: 200,
)

misc_read(operation: "get_workspaces")
misc_read(operation: "get_user_profile", user_id: "U123")
misc_read(operation: "list_user_reactions", user_id: "U123", extra_params: {count: 20, page: 1, full: true})
misc_read(operation: "get_presence", user_id: "U123")
misc_read(operation: "get_dnd_info", user_id: "U123")
misc_read(operation: "get_channel_members", channel_id: "C123")
misc_read(operation: "list_scheduled_messages", channel_id: "C123")

message_tool(
  operation: "get_message_info",       # Safe — read only
  channel_id: "C123",
  message_ts: "1234567890.123456",
  full_reactions: true,
)
message_tool(
  operation: "get_message_reactions",  # Safe — read only
  channel_id: "C123",
  message_ts: "1234567890.123456",
  full_reactions: true,
)

search_messages(query_terms: "topic keyword", count: 20)

search_messages(
  query_terms: "topic",
  filter: {in_channel_names: ["#relevant-channel"]},
  count: 20,
)

get_channel_messages(
  channels: [{channel_id_or_dm_id: "C123", thread_ts: "1234567890.123456"}],
  messages_to_retrieve: 50,
)

search_messages(
  query_terms: "topic",
  filter: {from_user_id_or_usernames: [{username: "key-person"}]},
  count: 20,
)

# Step 1: Get the DM channel ID
get_channel_info(dm_username: "john")
# Step 2: Search within that DM using the channel ID
search_messages(
  query_terms: "topic",
  filter: {in_dm_or_channel_ids: ["D1234567890"]},
  count: 20,
)