Estado de publicación
botmesh está en beta. Los paquetes públicos se publican desde el modo prereleasebeta de Changesets:
Las guías documentan la beta y la API que congela para la línea estable. Si
vienes de una alpha de 2.0, lee la guía de actualización.
Dist-tags de npm
betaapunta siempre a la beta más reciente de cada paquete. Cada publicación lo mueve sola.latestes lo que resuelve una instalación sin tag (pnpm add @botmesh/core). Las herramientas de publicación no lo mueven durante la beta: el mantenedor lo mueve a mano a las mismas versiones tras cada publicación, así que una instalación sin tag también instala la beta.
latest puede seguir apuntando un rato a la
beta anterior. Revisa los tags con:
Instalación
Instala el core y los paquetes que necesites, sin tag:beta, que instala siempre la beta más reciente (úsalo cuando
latest va por detrás):
@botmesh/* desde el mismo tag. Los paquetes
publicados dependen entre sí con rangos caret (^x.y.z), así que el gestor de
paquetes conserva una sola copia de @botmesh/core; mezclar builds de tags
distintos puede fallar por exports que faltan o rangos de peers (ver
Solución de problemas).
Para empezar un proyecto, npm create botmesh estampa versiones que
encajan entre sí (ver Inicio rápido).
Requisitos
- Node.js 22 o posterior. Todos los paquetes declaran
"engines": { "node": ">=22" }. El inicio rápido recomienda 22.12 o posterior. - Solo ESM. Ningún paquete trae CommonJS: usa
import(nuncarequire()), pon"type": "module"en tupackage.json(o usa archivos.mjs) y, con TypeScript,"module": "nodenext". - Los SDKs opcionales son peer dependencies que se cargan en diferido: los
SDKs de LLM de
@botmesh/ai,better-sqlite3,pg,mysql2,mongodbyredispara los stores,imapflowynodemailerpara el email,pdf-parsepara RAG y@opentelemetry/apipara@botmesh/otel. Instala el que uses.
Entradas y semver
La entrada principal de un paquete (@botmesh/core, @botmesh/telegram…) es
su API pública, cubierta por semver. Algunos paquetes añaden subrutas:
Paquetes públicos (36)
Todos están en npm conbeta y latest. El directorio es la carpeta dentro de
packages/.
Motor
Canales (12)
Infraestructura compartida
Stores (5)
Operación y observabilidad
Plugins (8)
Herramientas
Diez se publicaron por primera vez durante la alpha (
core, baileys, meta,
telegram, sqlite-store, redis-store, ai, http, graph-core y
create-botmesh); los otros 26 salieron a npm por primera vez con la beta.
Paquetes privados (9)
Estos paquetes están implementados y con tests, pero llevan"private": true
en su package.json: no están en npm, no siguen semver y su API puede
cambiar. Las páginas que los documentan llevan un aviso “Experimental” y van al
final de su sección. Úsalos desde un clon del monorepo, con dependencias
"workspace:*". Un paquete publicado nunca depende de ellos.
El repositorio incluye además un ejemplo ejecutable,
examples/bakery-ai
(@botmesh/example-bakery-ai, privado).
Siguientes pasos
- Inicio rápido: genera un proyecto o instálalo a mano.
- Canales: elige un canal y compara lo que soporta cada uno.
- Guía de actualización: si vienes de una alpha de 2.0.