Aide

################################################################################ Aide Compiler Plugin [🔬]¶

feature disabled by default, to use it enable in plugin parameters

################################################################################ Configuration¶

Configure Aide in your build.gradle.kts:

ktGram {
    // Enable AIDE compiler extensions (Automatic .send() chaining)
    aideEnabled = true

}

################################################################################ Usage Example¶

################################################################################## Simple case¶

@CommandHandler
suspend fun handler(user: User, bot: TelegramBot) {
    // With aideAutoSend=true
    message {
        "Auto-sent message"
    } // ← Compiler adds .send(user, bot)

    // Explicit control
    message { 
        "Manual send"
    }.send(user, bot) // ← No auto-add when present
}

################################################################################## Complex Case (Manual Handling Required)¶

@InputHandler
fun handleInput(user: User, bot: TelegramBot) {
    // Requires manual .send()
    val savedAction = message {
        "Stored action"
    }

    // Valid usage with explicit send
    savedAction.send(user, bot)
}

################################################################################### Validation Rules¶

• Auto-Send Applies When:

  • Action is directly returned from handler
  • No intermediate variable assignment
  • No existing .send() call

################################################################################ Feature Behavior¶

################################################################################# When aideEnabled=true¶

graph TD
    A[Detect Action] --> B{Simple Call?}
    B -->|Yes| C{Has Send?}
    B -->|No| D[No send]
    C -->|No| E[Add Send]
    C -->|Yes| F[Keep]
    D --> G[Skip]

################################################################################# Requirements¶

• Handler must declare parameters:
• User for general actions (simple action require just TelegramBot)
• TelegramBot for all actions
• Annotated with @CommandHandler, @InputHandler, etc (any supported annotation).