# Langbot Eba Adapter Dev

Build, refactor, and test LangBot platform adapters for the Event-Based Agents...

- Repository: https://github.com/langbot-app/LangBot (18661 stars)
- Category: Testing
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add langbot-app/LangBot --skill langbot-eba-adapter-dev -g -a claude-code -y`
Codex: `npx skills add langbot-app/LangBot --skill langbot-eba-adapter-dev -g -a codex -y`
Cursor: `npx skills add langbot-app/LangBot --skill langbot-eba-adapter-dev -g -a cursor -y`
Gemini CLI: `npx skills add langbot-app/LangBot --skill langbot-eba-adapter-dev -g -a gemini-cli -y`

## Description

Build, refactor, and test LangBot platform adapters for the Event-Based Agents architecture. Use when adding or migrating Telegram, Discord, or other messaging platform adapters to the EBA adapter layout, validating unified event/message conversion, writing live adapter probes, or using standalone plugin runtime plus Computer Use for end-to-end platform testing.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# LangBot EBA Adapter Development

Use this skill when implementing or reviewing a LangBot platform adapter under the Event-Based Agents architecture.

## Controlling a running instance via MCP

Beyond writing code, you can **drive a live LangBot instance over MCP**, no raw
HTTP needed. Two MCP servers exist (both reuse existing API keys; see `AGENTS.md`):

- **LangBot instance**, `http://<host>:5300/mcp` (auth: web-UI `lbk_` key or the
  `api.global_api_key` from `config.yaml`). Manage bots, pipelines, models,
  knowledge bases, and skills. See the **`langbot-mcp-ops`** skill.
- **LangBot Space marketplace**, `https://space.langbot.app/mcp` (auth: Personal
  Access Token). Search plugins / MCP servers / skills. See the
  **`langbot-space-ops`** skill.

> Any change to an agent-accessible HTTP API endpoint must keep the matching MCP
> tool and these skills in sync.

## Core Rule

Do not let platform-native event or message shapes leak into LangBot's common path. Each adapter must convert incoming SDK objects into unified EBA entities before dispatch:

- Events: `langbot_plugin.api.entities.builtin.platform.events`
- Message chains: `langbot_plugin.api.entities.builtin.platform.message.MessageChain`
- Users/groups/members: `langbot_plugin.api.entities.builtin.platform.entities`
- Raw platform objects may remain only in `source_platform_object` for debugging or platform-specific escape hatches.

## Start Here

The rest: https://github.com/langbot-app/LangBot/blob/HEAD/skills/skills/langbot-eba-adapter-dev/SKILL.md