Plugin SDK

Build your own channel.

Typed OAuth, streaming message iterators, consent-gated tool invocation. Ship ANIMA anywhere.

AI agent plugin SDK

Build your own channel.

The channel plugin SDK lets you connect ANIMA to Telegram, Discord, WhatsApp, Signal, iMessage, or anything with an API. Implement the PlatformConnector interface, register it, and your agent shows up there with its full soul intact.

  • • Typed OAuth + webhook helpers
  • • Streaming message iterators
  • • Consent-gated tool invocation
  • • Ships with its own memory namespace
import type { PlatformConnector } from "@noxsoft/anima";

export const telegram: PlatformConnector = {
  id: "telegram",
  async connect(ctx) {
    await ctx.auth.oauth("telegram");
  },
  async sendMessage(channel, text) {
    return ctx.api.post(`/bot/send`, { channel, text });
  },
  async *listen() {
    for await (const msg of ctx.stream("updates")) {
      yield { channel: msg.chat.id, text: msg.text };
    }
  },
};