tadpole - v2026.2.0

tadpole/intent

Gateway intents as a bitfield, with privileged-intent detection. Discord sends only the event families you subscribe to, and the subscription is this bitfield inside the IDENTIFY payload.

When you reach for this

Building the intents half of a tadpole config. Start empty with new, switch bits on with enable; the value is opaque, so a typo’d integer cannot reach Discord through it.

import tadpole/intent

let intents =
  intent.new()
  |> intent.enable(intent.guilds)
  |> intent.enable(intent.guild_messages)
  |> intent.enable(intent.message_content)

The privileged trio

Three bits sit behind toggles in the Developer Portal (Bot → Privileged Gateway Intents), and requesting one without its toggle ends the connection with close code 4014 the moment the bot identifies:

check_privileged lists which privileged bits a config requests; tadpole refuses nothing — Discord does the enforcing, after connect. The guide’s “Privileged intents” section has the whole story.

The wire

to_int produces the raw integer the IDENTIFY payload carries; tadpole/gateway/shard does exactly that when it builds its ShardConfig. intent_name names one bit for logs and rendered errors; to_string names them all, or “(none)”.

Every function here is total bit arithmetic, so nothing fails at runtime. The one failure is configurational — a privileged bit without its portal toggle — and it surfaces as close 4014 after connect, not as an error from this module.

See also

Types

Intents

opaque </> 
pub opaque type Intents

Values

all

</> 
pub const all: List(Int)

auto_moderation_configuration

</> 
pub const auto_moderation_configuration: Int

auto_moderation_execution

</> 
pub const auto_moderation_execution: Int

check_privileged

</> 
pub fn check_privileged(intents: Intents) -> List(Int)

Requesting these without the Developer Portal toggles ends in close code 4014 at Identify.

direct_message_polls

</> 
pub const direct_message_polls: Int

direct_message_reactions

</> 
pub const direct_message_reactions: Int

direct_message_typing

</> 
pub const direct_message_typing: Int

direct_messages

</> 
pub const direct_messages: Int

disable

</> 
pub fn disable(intents: Intents, intent: Int) -> Intents

enable

</> 
pub fn enable(intents: Intents, intent: Int) -> Intents

enabled

</> 
pub fn enabled(intents: Intents) -> List(Int)

from_int

</> 
pub fn from_int(value: Int) -> Intents

guild_expressions

</> 
pub const guild_expressions: Int

guild_integrations

</> 
pub const guild_integrations: Int

guild_invites

</> 
pub const guild_invites: Int

guild_members

</> 
pub const guild_members: Int

guild_message_polls

</> 
pub const guild_message_polls: Int

guild_message_reactions

</> 
pub const guild_message_reactions: Int

guild_message_typing

</> 
pub const guild_message_typing: Int

guild_messages

</> 
pub const guild_messages: Int

guild_moderation

</> 
pub const guild_moderation: Int

guild_presences

</> 
pub const guild_presences: Int

guild_scheduled_events

</> 
pub const guild_scheduled_events: Int

guild_voice_states

</> 
pub const guild_voice_states: Int

guild_webhooks

</> 
pub const guild_webhooks: Int

guilds

</> 
pub const guilds: Int

has

</> 
pub fn has(intents: Intents, intent: Int) -> Bool

intent_name

</> 
pub fn intent_name(intent: Int) -> String

is_privileged

</> 
pub fn is_privileged(intent: Int) -> Bool

message_content

</> 
pub const message_content: Int

new

</> 
pub fn new() -> Intents

privileged

</> 
pub const privileged: List(Int)

to_int

</> 
pub fn to_int(intents: Intents) -> Int

The raw integer sent in the Identify payload.

to_string

</> 
pub fn to_string(intents: Intents) -> String
✨ Search Document